address.proto

Package: envoy.config.core.v3

Types:

Source File: envoy/config/core/v3/address.proto

Pipe

"path": string
"mode": int

Field Type Description Default
path string Unix Domain Socket path. On Linux, paths starting with ‘@’ will use the abstract namespace. The starting ‘@’ is replaced by a null byte by Envoy. Paths starting with ‘@’ will result in an error in environments other than Linux.
mode int The mode for the Pipe. Not applicable for abstract sockets.

SocketAddress

[#next-free-field: 7]

"protocol": .envoy.config.core.v3.SocketAddress.Protocol
"address": string
"portValue": int
"namedPort": string
"resolverName": string
"ipv4Compat": bool

Field Type Description Default
protocol .envoy.config.core.v3.SocketAddress.Protocol
address string The address for this socket. :ref:Listeners <config_listeners> will bind to the address. An empty address is not allowed. Specify 0.0.0.0 or :: to bind to any address. [#comment:TODO(zuercher) reinstate when implemented: It is possible to distinguish a Listener address via the prefix/suffix matching in :ref:FilterChainMatch <envoy_api_msg_config.listener.v3.FilterChainMatch>.] When used within an upstream :ref:BindConfig <envoy_api_msg_config.core.v3.BindConfig>, the address controls the source address of outbound connections. For :ref:clusters <envoy_api_msg_config.cluster.v3.Cluster>, the cluster type determines whether the address must be an IP (STATIC or EDS clusters) or a hostname resolved by DNS (STRICT_DNS or LOGICAL_DNS clusters). Address resolution can be customized via :ref:resolver_name <envoy_api_field_config.core.v3.SocketAddress.resolver_name>.
portValue int Only one of portValue or namedPort can be set.
namedPort string This is only valid if :ref:resolver_name <envoy_api_field_config.core.v3.SocketAddress.resolver_name> is specified below and the named resolver is capable of named port resolution. Only one of namedPort or portValue can be set.
resolverName string The name of the custom resolver. This must have been registered with Envoy. If this is empty, a context dependent default applies. If the address is a concrete IP address, no resolution will occur. If address is a hostname this should be set for resolution other than DNS. Specifying a custom resolver with STRICT_DNS or LOGICAL_DNS will generate an error at runtime.
ipv4Compat bool When binding to an IPv6 address above, this enables IPv4 compatibility <https://tools.ietf.org/html/rfc3493#page-11>_. Binding to :: will allow both IPv4 and IPv6 connections, with peer IPv4 addresses mapped into IPv6 space as ::FFFF:<IPv4-address>.

Protocol

Name Description
TCP
UDP

TcpKeepalive

"keepaliveProbes": .google.protobuf.UInt32Value
"keepaliveTime": .google.protobuf.UInt32Value
"keepaliveInterval": .google.protobuf.UInt32Value

Field Type Description Default
keepaliveProbes .google.protobuf.UInt32Value Maximum number of keepalive probes to send without response before deciding the connection is dead. Default is to use the OS level configuration (unless overridden, Linux defaults to 9.).
keepaliveTime .google.protobuf.UInt32Value The number of seconds a connection needs to be idle before keep-alive probes start being sent. Default is to use the OS level configuration (unless overridden, Linux defaults to 7200s (i.e., 2 hours.).
keepaliveInterval .google.protobuf.UInt32Value The number of seconds between keep-alive probes. Default is to use the OS level configuration (unless overridden, Linux defaults to 75s.).

BindConfig

"sourceAddress": .envoy.config.core.v3.SocketAddress
"freebind": .google.protobuf.BoolValue
"socketOptions": []envoy.config.core.v3.SocketOption

Field Type Description Default
sourceAddress .envoy.config.core.v3.SocketAddress The address to bind to when creating a socket.
freebind .google.protobuf.BoolValue Whether to set the IP_FREEBIND option when creating the socket. When this flag is set to true, allows the :ref:source_address <envoy_api_field_config.cluster.v3.UpstreamBindConfig.source_address> to be an IP address that is not configured on the system running Envoy. When this flag is set to false, the option IP_FREEBIND is disabled on the socket. When this flag is not set (default), the socket is not modified, i.e. the option is neither enabled nor disabled.
socketOptions []envoy.config.core.v3.SocketOption Additional socket options that may not be present in Envoy source code or precompiled binaries.

Address

Addresses specify either a logical or physical address and port, which are used to tell Envoy where to bind/listen, connect to upstream and find management servers.

"socketAddress": .envoy.config.core.v3.SocketAddress
"pipe": .envoy.config.core.v3.Pipe

Field Type Description Default
socketAddress .envoy.config.core.v3.SocketAddress Only one of socketAddress or pipe can be set.
pipe .envoy.config.core.v3.Pipe Only one of pipe or socketAddress can be set.

CidrRange

CidrRange specifies an IP Address and a prefix length to construct the subnet mask for a CIDR <https://tools.ietf.org/html/rfc4632>_ range.

"addressPrefix": string
"prefixLen": .google.protobuf.UInt32Value

Field Type Description Default
addressPrefix string IPv4 or IPv6 address, e.g. 192.0.0.0 or 2001:db8::.
prefixLen .google.protobuf.UInt32Value Length of prefix, e.g. 0, 32.