apiv2

package
v1.36.1-20231128203245... Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: unknown License: Apache-2.0 Imports: 21 Imported by: 8

Documentation

Index

Constants

View Source
const Cluster_ClusterDiscoveryType_not_set_case case_Cluster_ClusterDiscoveryType = 0
View Source
const Cluster_ClusterType_case case_Cluster_ClusterDiscoveryType = 38
View Source
const Cluster_CommonLbConfig_LocalityConfigSpecifier_not_set_case case_Cluster_CommonLbConfig_LocalityConfigSpecifier = 0
View Source
const Cluster_CommonLbConfig_LocalityWeightedLbConfig_case case_Cluster_CommonLbConfig_LocalityConfigSpecifier = 3
View Source
const Cluster_CommonLbConfig_ZoneAwareLbConfig_case case_Cluster_CommonLbConfig_LocalityConfigSpecifier = 2
View Source
const Cluster_LbConfig_not_set_case case_Cluster_LbConfig = 0
View Source
const Cluster_LeastRequestLbConfig_case case_Cluster_LbConfig = 37
View Source
const Cluster_OriginalDstLbConfig_case case_Cluster_LbConfig = 34
View Source
const Cluster_RingHashLbConfig_case case_Cluster_LbConfig = 23
View Source
const Cluster_Type_case case_Cluster_ClusterDiscoveryType = 2
View Source
const Listener_ConnectionBalanceConfig_BalanceType_not_set_case case_Listener_ConnectionBalanceConfig_BalanceType = 0
View Source
const Listener_ConnectionBalanceConfig_ExactBalance_case case_Listener_ConnectionBalanceConfig_BalanceType = 1
View Source
const ScopedRouteConfiguration_Key_Fragment_StringKey_case case_ScopedRouteConfiguration_Key_Fragment_Type = 1
View Source
const ScopedRouteConfiguration_Key_Fragment_Type_not_set_case case_ScopedRouteConfiguration_Key_Fragment_Type = 0

Variables

View Source
var (
	Cluster_DiscoveryType_name = map[int32]string{
		0: "STATIC",
		1: "STRICT_DNS",
		2: "LOGICAL_DNS",
		3: "EDS",
		4: "ORIGINAL_DST",
	}
	Cluster_DiscoveryType_value = map[string]int32{
		"STATIC":       0,
		"STRICT_DNS":   1,
		"LOGICAL_DNS":  2,
		"EDS":          3,
		"ORIGINAL_DST": 4,
	}
)

Enum value maps for Cluster_DiscoveryType.

View Source
var (
	Cluster_LbPolicy_name = map[int32]string{
		0: "ROUND_ROBIN",
		1: "LEAST_REQUEST",
		2: "RING_HASH",
		3: "RANDOM",
		4: "ORIGINAL_DST_LB",
		5: "MAGLEV",
		6: "CLUSTER_PROVIDED",
		7: "LOAD_BALANCING_POLICY_CONFIG",
	}
	Cluster_LbPolicy_value = map[string]int32{
		"ROUND_ROBIN":                  0,
		"LEAST_REQUEST":                1,
		"RING_HASH":                    2,
		"RANDOM":                       3,
		"ORIGINAL_DST_LB":              4,
		"MAGLEV":                       5,
		"CLUSTER_PROVIDED":             6,
		"LOAD_BALANCING_POLICY_CONFIG": 7,
	}
)

Enum value maps for Cluster_LbPolicy.

View Source
var (
	Cluster_DnsLookupFamily_name = map[int32]string{
		0: "AUTO",
		1: "V4_ONLY",
		2: "V6_ONLY",
	}
	Cluster_DnsLookupFamily_value = map[string]int32{
		"AUTO":    0,
		"V4_ONLY": 1,
		"V6_ONLY": 2,
	}
)

Enum value maps for Cluster_DnsLookupFamily.

View Source
var (
	Cluster_ClusterProtocolSelection_name = map[int32]string{
		0: "USE_CONFIGURED_PROTOCOL",
		1: "USE_DOWNSTREAM_PROTOCOL",
	}
	Cluster_ClusterProtocolSelection_value = map[string]int32{
		"USE_CONFIGURED_PROTOCOL": 0,
		"USE_DOWNSTREAM_PROTOCOL": 1,
	}
)

Enum value maps for Cluster_ClusterProtocolSelection.

View Source
var (
	Cluster_LbSubsetConfig_LbSubsetFallbackPolicy_name = map[int32]string{
		0: "NO_FALLBACK",
		1: "ANY_ENDPOINT",
		2: "DEFAULT_SUBSET",
	}
	Cluster_LbSubsetConfig_LbSubsetFallbackPolicy_value = map[string]int32{
		"NO_FALLBACK":    0,
		"ANY_ENDPOINT":   1,
		"DEFAULT_SUBSET": 2,
	}
)

Enum value maps for Cluster_LbSubsetConfig_LbSubsetFallbackPolicy.

View Source
var (
	Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy_name = map[int32]string{
		0: "NOT_DEFINED",
		1: "NO_FALLBACK",
		2: "ANY_ENDPOINT",
		3: "DEFAULT_SUBSET",
		4: "KEYS_SUBSET",
	}
	Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy_value = map[string]int32{
		"NOT_DEFINED":    0,
		"NO_FALLBACK":    1,
		"ANY_ENDPOINT":   2,
		"DEFAULT_SUBSET": 3,
		"KEYS_SUBSET":    4,
	}
)

Enum value maps for Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy.

View Source
var (
	Cluster_RingHashLbConfig_HashFunction_name = map[int32]string{
		0: "XX_HASH",
		1: "MURMUR_HASH_2",
	}
	Cluster_RingHashLbConfig_HashFunction_value = map[string]int32{
		"XX_HASH":       0,
		"MURMUR_HASH_2": 1,
	}
)

Enum value maps for Cluster_RingHashLbConfig_HashFunction.

View Source
var (
	Listener_DrainType_name = map[int32]string{
		0: "DEFAULT",
		1: "MODIFY_ONLY",
	}
	Listener_DrainType_value = map[string]int32{
		"DEFAULT":     0,
		"MODIFY_ONLY": 1,
	}
)

Enum value maps for Listener_DrainType.

View Source
var File_envoy_api_v2_cds_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_cluster_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_discovery_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_eds_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_endpoint_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_lds_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_listener_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_rds_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_route_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_scoped_route_proto protoreflect.FileDescriptor
View Source
var File_envoy_api_v2_srds_proto protoreflect.FileDescriptor

Functions

This section is empty.

Types

type CdsDummy

type CdsDummy struct {
	// contains filtered or unexported fields
}

[#not-implemented-hide:] Not configuration. Workaround c++ protobuf issue with importing services: https://github.com/google/protobuf/issues/4221 and protoxform to upgrade the file.

func (*CdsDummy) ProtoMessage

func (*CdsDummy) ProtoMessage()

func (*CdsDummy) ProtoReflect

func (x *CdsDummy) ProtoReflect() protoreflect.Message

func (*CdsDummy) Reset

func (x *CdsDummy) Reset()

func (*CdsDummy) String

func (x *CdsDummy) String() string

type CdsDummy_builder

type CdsDummy_builder struct {
	// contains filtered or unexported fields
}

func (CdsDummy_builder) Build

func (b0 CdsDummy_builder) Build() *CdsDummy

type Cluster

type Cluster struct {

	// Configuration to use different transport sockets for different endpoints.
	// The entry of *envoy.transport_socket_match* in the
	// :ref:`LbEndpoint.Metadata <envoy_api_field_endpoint.LbEndpoint.metadata>`
	// is used to match against the transport sockets as they appear in the list. The first
	// :ref:`match <envoy_api_msg_Cluster.TransportSocketMatch>` is used.
	// For example, with the following match
	//
	// .. code-block:: yaml
	//
	//	transport_socket_matches:
	//	- name: "enableMTLS"
	//	  match:
	//	    acceptMTLS: true
	//	  transport_socket:
	//	    name: envoy.transport_sockets.tls
	//	    config: { ... } # tls socket configuration
	//	- name: "defaultToPlaintext"
	//	  match: {}
	//	  transport_socket:
	//	    name: envoy.transport_sockets.raw_buffer
	//
	// Connections to the endpoints whose metadata value under *envoy.transport_socket_match*
	// having "acceptMTLS"/"true" key/value pair use the "enableMTLS" socket configuration.
	//
	// If a :ref:`socket match <envoy_api_msg_Cluster.TransportSocketMatch>` with empty match
	// criteria is provided, that always match any endpoint. For example, the "defaultToPlaintext"
	// socket match in case above.
	//
	// If an endpoint metadata's value under *envoy.transport_socket_match* does not match any
	// *TransportSocketMatch*, socket configuration fallbacks to use the *tls_context* or
	// *transport_socket* specified in this cluster.
	//
	// This field allows gradual and flexible transport socket configuration changes.
	//
	// The metadata of endpoints in EDS can indicate transport socket capabilities. For example,
	// an endpoint's metadata can have two key value pairs as "acceptMTLS": "true",
	// "acceptPlaintext": "true". While some other endpoints, only accepting plaintext traffic
	// has "acceptPlaintext": "true" metadata information.
	//
	// Then the xDS server can configure the CDS to a client, Envoy A, to send mutual TLS
	// traffic for endpoints with "acceptMTLS": "true", by adding a corresponding
	// *TransportSocketMatch* in this field. Other client Envoys receive CDS without
	// *transport_socket_match* set, and still send plain text traffic to the same cluster.
	//
	// [#comment:TODO(incfly): add a detailed architecture doc on intended usage.]
	TransportSocketMatches []*Cluster_TransportSocketMatch `` /* 130-byte string literal not displayed */
	// Supplies the name of the cluster which must be unique across all clusters.
	// The cluster name is used when emitting
	// :ref:`statistics <config_cluster_manager_cluster_stats>` if :ref:`alt_stat_name
	// <envoy_api_field_Cluster.alt_stat_name>` is not provided.
	// Any “:“ in the cluster name will be converted to “_“ when emitting statistics.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// An optional alternative to the cluster name to be used while emitting stats.
	// Any “:“ in the name will be converted to “_“ when emitting statistics. This should not be
	// confused with :ref:`Router Filter Header
	// <config_http_filters_router_x-envoy-upstream-alt-stat-name>`.
	AltStatName string `protobuf:"bytes,28,opt,name=alt_stat_name,json=altStatName,proto3" json:"alt_stat_name,omitempty"`
	// Types that are valid to be assigned to ClusterDiscoveryType:
	//
	//	*Cluster_Type
	//	*Cluster_ClusterType
	ClusterDiscoveryType isCluster_ClusterDiscoveryType `protobuf_oneof:"cluster_discovery_type"`
	// Configuration to use for EDS updates for the Cluster.
	EdsClusterConfig *Cluster_EdsClusterConfig `protobuf:"bytes,3,opt,name=eds_cluster_config,json=edsClusterConfig,proto3" json:"eds_cluster_config,omitempty"`
	// The timeout for new network connections to hosts in the cluster.
	ConnectTimeout *durationpb.Duration `protobuf:"bytes,4,opt,name=connect_timeout,json=connectTimeout,proto3" json:"connect_timeout,omitempty"`
	// Soft limit on size of the cluster’s connections read and write buffers. If
	// unspecified, an implementation defined default is applied (1MiB).
	PerConnectionBufferLimitBytes *wrapperspb.UInt32Value `` /* 154-byte string literal not displayed */
	// The :ref:`load balancer type <arch_overview_load_balancing_types>` to use
	// when picking a host in the cluster.
	LbPolicy Cluster_LbPolicy `protobuf:"varint,6,opt,name=lb_policy,json=lbPolicy,proto3,enum=envoy.api.v2.Cluster_LbPolicy" json:"lb_policy,omitempty"`
	// If the service discovery type is
	// :ref:`STATIC<envoy_api_enum_value_Cluster.DiscoveryType.STATIC>`,
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`,
	// then hosts is required.
	//
	// .. attention::
	//
	//	**This field is deprecated**. Set the
	//	:ref:`load_assignment<envoy_api_field_Cluster.load_assignment>` field instead.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	Hosts []*core.Address `protobuf:"bytes,7,rep,name=hosts,proto3" json:"hosts,omitempty"`
	// Setting this is required for specifying members of
	// :ref:`STATIC<envoy_api_enum_value_Cluster.DiscoveryType.STATIC>`,
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>` clusters.
	// This field supersedes the *hosts* field in the v2 API.
	//
	// .. attention::
	//
	//	Setting this allows non-EDS cluster types to contain embedded EDS equivalent
	//	:ref:`endpoint assignments<envoy_api_msg_ClusterLoadAssignment>`.
	LoadAssignment *ClusterLoadAssignment `protobuf:"bytes,33,opt,name=load_assignment,json=loadAssignment,proto3" json:"load_assignment,omitempty"`
	// Optional :ref:`active health checking <arch_overview_health_checking>`
	// configuration for the cluster. If no
	// configuration is specified no health checking will be done and all cluster
	// members will be considered healthy at all times.
	HealthChecks []*core.HealthCheck `protobuf:"bytes,8,rep,name=health_checks,json=healthChecks,proto3" json:"health_checks,omitempty"`
	// Optional maximum requests for a single upstream connection. This parameter
	// is respected by both the HTTP/1.1 and HTTP/2 connection pool
	// implementations. If not specified, there is no limit. Setting this
	// parameter to 1 will effectively disable keep alive.
	MaxRequestsPerConnection *wrapperspb.UInt32Value `` /* 137-byte string literal not displayed */
	// Optional :ref:`circuit breaking <arch_overview_circuit_break>` for the cluster.
	CircuitBreakers *cluster.CircuitBreakers `protobuf:"bytes,10,opt,name=circuit_breakers,json=circuitBreakers,proto3" json:"circuit_breakers,omitempty"`
	// The TLS configuration for connections to the upstream cluster.
	//
	// .. attention::
	//
	//	**This field is deprecated**. Use `transport_socket` with name `tls` instead. If both are
	//	set, `transport_socket` takes priority.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	TlsContext *auth.UpstreamTlsContext `protobuf:"bytes,11,opt,name=tls_context,json=tlsContext,proto3" json:"tls_context,omitempty"`
	// HTTP protocol options that are applied only to upstream HTTP connections.
	// These options apply to all HTTP versions.
	UpstreamHttpProtocolOptions *core.UpstreamHttpProtocolOptions `` /* 147-byte string literal not displayed */
	// Additional options when handling HTTP requests upstream. These options will be applicable to
	// both HTTP1 and HTTP2 requests.
	CommonHttpProtocolOptions *core.HttpProtocolOptions `` /* 141-byte string literal not displayed */
	// Additional options when handling HTTP1 requests.
	HttpProtocolOptions *core.Http1ProtocolOptions `protobuf:"bytes,13,opt,name=http_protocol_options,json=httpProtocolOptions,proto3" json:"http_protocol_options,omitempty"`
	// Even if default HTTP2 protocol options are desired, this field must be
	// set so that Envoy will assume that the upstream supports HTTP/2 when
	// making new HTTP connection pool connections. Currently, Envoy only
	// supports prior knowledge for upstream connections. Even if TLS is used
	// with ALPN, `http2_protocol_options` must be specified. As an aside this allows HTTP/2
	// connections to happen over plain text.
	Http2ProtocolOptions *core.Http2ProtocolOptions `protobuf:"bytes,14,opt,name=http2_protocol_options,json=http2ProtocolOptions,proto3" json:"http2_protocol_options,omitempty"`
	// The extension_protocol_options field is used to provide extension-specific protocol options
	// for upstream connections. The key should match the extension filter name, such as
	// "envoy.filters.network.thrift_proxy". See the extension's documentation for details on
	// specific options.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	ExtensionProtocolOptions map[string]*structpb.Struct `` /* 210-byte string literal not displayed */
	// The extension_protocol_options field is used to provide extension-specific protocol options
	// for upstream connections. The key should match the extension filter name, such as
	// "envoy.filters.network.thrift_proxy". See the extension's documentation for details on
	// specific options.
	TypedExtensionProtocolOptions map[string]*anypb.Any `` /* 227-byte string literal not displayed */
	// If the DNS refresh rate is specified and the cluster type is either
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`,
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`,
	// this value is used as the cluster’s DNS refresh
	// rate. The value configured must be at least 1ms. If this setting is not specified, the
	// value defaults to 5000ms. For cluster types other than
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`
	// and :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`
	// this setting is ignored.
	DnsRefreshRate *durationpb.Duration `protobuf:"bytes,16,opt,name=dns_refresh_rate,json=dnsRefreshRate,proto3" json:"dns_refresh_rate,omitempty"`
	// If the DNS failure refresh rate is specified and the cluster type is either
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`,
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`,
	// this is used as the cluster’s DNS refresh rate when requests are failing. If this setting is
	// not specified, the failure refresh rate defaults to the DNS refresh rate. For cluster types
	// other than :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>` and
	// :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>` this setting is
	// ignored.
	DnsFailureRefreshRate *Cluster_RefreshRate `` /* 129-byte string literal not displayed */
	// Optional configuration for setting cluster's DNS refresh rate. If the value is set to true,
	// cluster's DNS refresh rate will be set to resource record's TTL which comes from DNS
	// resolution.
	RespectDnsTtl bool `protobuf:"varint,39,opt,name=respect_dns_ttl,json=respectDnsTtl,proto3" json:"respect_dns_ttl,omitempty"`
	// The DNS IP address resolution policy. If this setting is not specified, the
	// value defaults to
	// :ref:`AUTO<envoy_api_enum_value_Cluster.DnsLookupFamily.AUTO>`.
	DnsLookupFamily Cluster_DnsLookupFamily `` /* 152-byte string literal not displayed */
	// If DNS resolvers are specified and the cluster type is either
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`,
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`,
	// this value is used to specify the cluster’s dns resolvers.
	// If this setting is not specified, the value defaults to the default
	// resolver, which uses /etc/resolv.conf for configuration. For cluster types
	// other than
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`
	// and :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`
	// this setting is ignored.
	// Setting this value causes failure if the
	// “envoy.restart_features.use_apple_api_for_dns_lookups“ runtime value is true during
	// server startup. Apple's API only allows overriding DNS resolvers via system settings.
	DnsResolvers []*core.Address `protobuf:"bytes,18,rep,name=dns_resolvers,json=dnsResolvers,proto3" json:"dns_resolvers,omitempty"`
	// [#next-major-version: Reconcile DNS options in a single message.]
	// Always use TCP queries instead of UDP queries for DNS lookups.
	// Setting this value causes failure if the
	// “envoy.restart_features.use_apple_api_for_dns_lookups“ runtime value is true during
	// server startup. Apple' API only uses UDP for DNS resolution.
	UseTcpForDnsLookups bool `` /* 126-byte string literal not displayed */
	// If specified, outlier detection will be enabled for this upstream cluster.
	// Each of the configuration values can be overridden via
	// :ref:`runtime values <config_cluster_manager_cluster_runtime_outlier_detection>`.
	OutlierDetection *cluster.OutlierDetection `protobuf:"bytes,19,opt,name=outlier_detection,json=outlierDetection,proto3" json:"outlier_detection,omitempty"`
	// The interval for removing stale hosts from a cluster type
	// :ref:`ORIGINAL_DST<envoy_api_enum_value_Cluster.DiscoveryType.ORIGINAL_DST>`.
	// Hosts are considered stale if they have not been used
	// as upstream destinations during this interval. New hosts are added
	// to original destination clusters on demand as new connections are
	// redirected to Envoy, causing the number of hosts in the cluster to
	// grow over time. Hosts that are not stale (they are actively used as
	// destinations) are kept in the cluster, which allows connections to
	// them remain open, saving the latency that would otherwise be spent
	// on opening new connections. If this setting is not specified, the
	// value defaults to 5000ms. For cluster types other than
	// :ref:`ORIGINAL_DST<envoy_api_enum_value_Cluster.DiscoveryType.ORIGINAL_DST>`
	// this setting is ignored.
	CleanupInterval *durationpb.Duration `protobuf:"bytes,20,opt,name=cleanup_interval,json=cleanupInterval,proto3" json:"cleanup_interval,omitempty"`
	// Optional configuration used to bind newly established upstream connections.
	// This overrides any bind_config specified in the bootstrap proto.
	// If the address and port are empty, no bind will be performed.
	UpstreamBindConfig *core.BindConfig `protobuf:"bytes,21,opt,name=upstream_bind_config,json=upstreamBindConfig,proto3" json:"upstream_bind_config,omitempty"`
	// Configuration for load balancing subsetting.
	LbSubsetConfig *Cluster_LbSubsetConfig `protobuf:"bytes,22,opt,name=lb_subset_config,json=lbSubsetConfig,proto3" json:"lb_subset_config,omitempty"`
	// Optional configuration for the load balancing algorithm selected by
	// LbPolicy. Currently only
	// :ref:`RING_HASH<envoy_api_enum_value_Cluster.LbPolicy.RING_HASH>` and
	// :ref:`LEAST_REQUEST<envoy_api_enum_value_Cluster.LbPolicy.LEAST_REQUEST>`
	// has additional configuration options.
	// Specifying ring_hash_lb_config or least_request_lb_config without setting the corresponding
	// LbPolicy will generate an error at runtime.
	//
	// Types that are valid to be assigned to LbConfig:
	//
	//	*Cluster_RingHashLbConfig_
	//	*Cluster_OriginalDstLbConfig_
	//	*Cluster_LeastRequestLbConfig_
	LbConfig isCluster_LbConfig `protobuf_oneof:"lb_config"`
	// Common configuration for all load balancer implementations.
	CommonLbConfig *Cluster_CommonLbConfig `protobuf:"bytes,27,opt,name=common_lb_config,json=commonLbConfig,proto3" json:"common_lb_config,omitempty"`
	// Optional custom transport socket implementation to use for upstream connections.
	// To setup TLS, set a transport socket with name `tls` and
	// :ref:`UpstreamTlsContexts <envoy_api_msg_auth.UpstreamTlsContext>` in the `typed_config`.
	// If no transport socket configuration is specified, new connections
	// will be set up with plaintext.
	TransportSocket *core.TransportSocket `protobuf:"bytes,24,opt,name=transport_socket,json=transportSocket,proto3" json:"transport_socket,omitempty"`
	// The Metadata field can be used to provide additional information about the
	// cluster. It can be used for stats, logging, and varying filter behavior.
	// Fields should use reverse DNS notation to denote which entity within Envoy
	// will need the information. For instance, if the metadata is intended for
	// the Router filter, the filter name should be specified as *envoy.filters.http.router*.
	Metadata *core.Metadata `protobuf:"bytes,25,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// Determines how Envoy selects the protocol used to speak to upstream hosts.
	ProtocolSelection Cluster_ClusterProtocolSelection `` /* 165-byte string literal not displayed */
	// Optional options for upstream connections.
	UpstreamConnectionOptions *UpstreamConnectionOptions `` /* 139-byte string literal not displayed */
	// If an upstream host becomes unhealthy (as determined by the configured health checks
	// or outlier detection), immediately close all connections to the failed host.
	//
	// .. note::
	//
	//	This is currently only supported for connections created by tcp_proxy.
	//
	// .. note::
	//
	//	The current implementation of this feature closes all connections immediately when
	//	the unhealthy status is detected. If there are a large number of connections open
	//	to an upstream host that becomes unhealthy, Envoy may spend a substantial amount of
	//	time exclusively closing these connections, and not processing any other traffic.
	CloseConnectionsOnHostHealthFailure bool `` /* 176-byte string literal not displayed */
	// If set to true, Envoy will ignore the health value of a host when processing its removal
	// from service discovery. This means that if active health checking is used, Envoy will *not*
	// wait for the endpoint to go unhealthy before removing it.
	DrainConnectionsOnHostRemoval bool `` /* 156-byte string literal not displayed */
	// An (optional) network filter chain, listed in the order the filters should be applied.
	// The chain will be applied to all outgoing connections that Envoy makes to the upstream
	// servers of this cluster.
	Filters []*cluster.Filter `protobuf:"bytes,40,rep,name=filters,proto3" json:"filters,omitempty"`
	// [#not-implemented-hide:] New mechanism for LB policy configuration. Used only if the
	// :ref:`lb_policy<envoy_api_field_Cluster.lb_policy>` field has the value
	// :ref:`LOAD_BALANCING_POLICY_CONFIG<envoy_api_enum_value_Cluster.LbPolicy.LOAD_BALANCING_POLICY_CONFIG>`.
	LoadBalancingPolicy *LoadBalancingPolicy `protobuf:"bytes,41,opt,name=load_balancing_policy,json=loadBalancingPolicy,proto3" json:"load_balancing_policy,omitempty"`
	// [#not-implemented-hide:]
	// If present, tells the client where to send load reports via LRS. If not present, the
	// client will fall back to a client-side default, which may be either (a) don't send any
	// load reports or (b) send load reports for all clusters to a single default server
	// (which may be configured in the bootstrap file).
	//
	// Note that if multiple clusters point to the same LRS server, the client may choose to
	// create a separate stream for each cluster or it may choose to coalesce the data for
	// multiple clusters onto a single stream. Either way, the client must make sure to send
	// the data for any given cluster on no more than one stream.
	//
	// [#next-major-version: In the v3 API, we should consider restructuring this somehow,
	// maybe by allowing LRS to go on the ADS stream, or maybe by moving some of the negotiation
	// from the LRS stream here.]
	LrsServer *core.ConfigSource `protobuf:"bytes,42,opt,name=lrs_server,json=lrsServer,proto3" json:"lrs_server,omitempty"`
	// If track_timeout_budgets is true, the :ref:`timeout budget histograms
	// <config_cluster_manager_cluster_stats_timeout_budgets>` will be published for each
	// request. These show what percentage of a request's per try and global timeout was used. A value
	// of 0 would indicate that none of the timeout was used or that the timeout was infinite. A value
	// of 100 would indicate that the request took the entirety of the timeout given to it.
	TrackTimeoutBudgets bool `protobuf:"varint,47,opt,name=track_timeout_budgets,json=trackTimeoutBudgets,proto3" json:"track_timeout_budgets,omitempty"`
	// contains filtered or unexported fields
}

Configuration for a single upstream cluster. [#next-free-field: 48]

func (*Cluster) ClearCircuitBreakers

func (x *Cluster) ClearCircuitBreakers()

func (*Cluster) ClearCleanupInterval

func (x *Cluster) ClearCleanupInterval()

func (*Cluster) ClearClusterDiscoveryType

func (x *Cluster) ClearClusterDiscoveryType()

func (*Cluster) ClearClusterType

func (x *Cluster) ClearClusterType()

func (*Cluster) ClearCommonHttpProtocolOptions

func (x *Cluster) ClearCommonHttpProtocolOptions()

func (*Cluster) ClearCommonLbConfig

func (x *Cluster) ClearCommonLbConfig()

func (*Cluster) ClearConnectTimeout

func (x *Cluster) ClearConnectTimeout()

func (*Cluster) ClearDnsFailureRefreshRate

func (x *Cluster) ClearDnsFailureRefreshRate()

func (*Cluster) ClearDnsRefreshRate

func (x *Cluster) ClearDnsRefreshRate()

func (*Cluster) ClearEdsClusterConfig

func (x *Cluster) ClearEdsClusterConfig()

func (*Cluster) ClearHttp2ProtocolOptions

func (x *Cluster) ClearHttp2ProtocolOptions()

func (*Cluster) ClearHttpProtocolOptions

func (x *Cluster) ClearHttpProtocolOptions()

func (*Cluster) ClearLbConfig

func (x *Cluster) ClearLbConfig()

func (*Cluster) ClearLbSubsetConfig

func (x *Cluster) ClearLbSubsetConfig()

func (*Cluster) ClearLeastRequestLbConfig

func (x *Cluster) ClearLeastRequestLbConfig()

func (*Cluster) ClearLoadAssignment

func (x *Cluster) ClearLoadAssignment()

func (*Cluster) ClearLoadBalancingPolicy

func (x *Cluster) ClearLoadBalancingPolicy()

func (*Cluster) ClearLrsServer

func (x *Cluster) ClearLrsServer()

func (*Cluster) ClearMaxRequestsPerConnection

func (x *Cluster) ClearMaxRequestsPerConnection()

func (*Cluster) ClearMetadata

func (x *Cluster) ClearMetadata()

func (*Cluster) ClearOriginalDstLbConfig

func (x *Cluster) ClearOriginalDstLbConfig()

func (*Cluster) ClearOutlierDetection

func (x *Cluster) ClearOutlierDetection()

func (*Cluster) ClearPerConnectionBufferLimitBytes

func (x *Cluster) ClearPerConnectionBufferLimitBytes()

func (*Cluster) ClearRingHashLbConfig

func (x *Cluster) ClearRingHashLbConfig()

func (*Cluster) ClearTlsContext deprecated

func (x *Cluster) ClearTlsContext()

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*Cluster) ClearTransportSocket

func (x *Cluster) ClearTransportSocket()

func (*Cluster) ClearType

func (x *Cluster) ClearType()

func (*Cluster) ClearUpstreamBindConfig

func (x *Cluster) ClearUpstreamBindConfig()

func (*Cluster) ClearUpstreamConnectionOptions

func (x *Cluster) ClearUpstreamConnectionOptions()

func (*Cluster) ClearUpstreamHttpProtocolOptions

func (x *Cluster) ClearUpstreamHttpProtocolOptions()

func (*Cluster) GetAltStatName

func (x *Cluster) GetAltStatName() string

func (*Cluster) GetCircuitBreakers

func (x *Cluster) GetCircuitBreakers() *cluster.CircuitBreakers

func (*Cluster) GetCleanupInterval

func (x *Cluster) GetCleanupInterval() *durationpb.Duration

func (*Cluster) GetCloseConnectionsOnHostHealthFailure

func (x *Cluster) GetCloseConnectionsOnHostHealthFailure() bool

func (*Cluster) GetClusterDiscoveryType

func (x *Cluster) GetClusterDiscoveryType() isCluster_ClusterDiscoveryType

func (*Cluster) GetClusterType

func (x *Cluster) GetClusterType() *Cluster_CustomClusterType

func (*Cluster) GetCommonHttpProtocolOptions

func (x *Cluster) GetCommonHttpProtocolOptions() *core.HttpProtocolOptions

func (*Cluster) GetCommonLbConfig

func (x *Cluster) GetCommonLbConfig() *Cluster_CommonLbConfig

func (*Cluster) GetConnectTimeout

func (x *Cluster) GetConnectTimeout() *durationpb.Duration

func (*Cluster) GetDnsFailureRefreshRate

func (x *Cluster) GetDnsFailureRefreshRate() *Cluster_RefreshRate

func (*Cluster) GetDnsLookupFamily

func (x *Cluster) GetDnsLookupFamily() Cluster_DnsLookupFamily

func (*Cluster) GetDnsRefreshRate

func (x *Cluster) GetDnsRefreshRate() *durationpb.Duration

func (*Cluster) GetDnsResolvers

func (x *Cluster) GetDnsResolvers() []*core.Address

func (*Cluster) GetDrainConnectionsOnHostRemoval

func (x *Cluster) GetDrainConnectionsOnHostRemoval() bool

func (*Cluster) GetEdsClusterConfig

func (x *Cluster) GetEdsClusterConfig() *Cluster_EdsClusterConfig

func (*Cluster) GetExtensionProtocolOptions deprecated

func (x *Cluster) GetExtensionProtocolOptions() map[string]*structpb.Struct

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*Cluster) GetFilters

func (x *Cluster) GetFilters() []*cluster.Filter

func (*Cluster) GetHealthChecks

func (x *Cluster) GetHealthChecks() []*core.HealthCheck

func (*Cluster) GetHosts deprecated

func (x *Cluster) GetHosts() []*core.Address

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*Cluster) GetHttp2ProtocolOptions

func (x *Cluster) GetHttp2ProtocolOptions() *core.Http2ProtocolOptions

func (*Cluster) GetHttpProtocolOptions

func (x *Cluster) GetHttpProtocolOptions() *core.Http1ProtocolOptions

func (*Cluster) GetLbConfig

func (x *Cluster) GetLbConfig() isCluster_LbConfig

func (*Cluster) GetLbPolicy

func (x *Cluster) GetLbPolicy() Cluster_LbPolicy

func (*Cluster) GetLbSubsetConfig

func (x *Cluster) GetLbSubsetConfig() *Cluster_LbSubsetConfig

func (*Cluster) GetLeastRequestLbConfig

func (x *Cluster) GetLeastRequestLbConfig() *Cluster_LeastRequestLbConfig

func (*Cluster) GetLoadAssignment

func (x *Cluster) GetLoadAssignment() *ClusterLoadAssignment

func (*Cluster) GetLoadBalancingPolicy

func (x *Cluster) GetLoadBalancingPolicy() *LoadBalancingPolicy

func (*Cluster) GetLrsServer

func (x *Cluster) GetLrsServer() *core.ConfigSource

func (*Cluster) GetMaxRequestsPerConnection

func (x *Cluster) GetMaxRequestsPerConnection() *wrapperspb.UInt32Value

func (*Cluster) GetMetadata

func (x *Cluster) GetMetadata() *core.Metadata

func (*Cluster) GetName

func (x *Cluster) GetName() string

func (*Cluster) GetOriginalDstLbConfig

func (x *Cluster) GetOriginalDstLbConfig() *Cluster_OriginalDstLbConfig

func (*Cluster) GetOutlierDetection

func (x *Cluster) GetOutlierDetection() *cluster.OutlierDetection

func (*Cluster) GetPerConnectionBufferLimitBytes

func (x *Cluster) GetPerConnectionBufferLimitBytes() *wrapperspb.UInt32Value

func (*Cluster) GetProtocolSelection

func (x *Cluster) GetProtocolSelection() Cluster_ClusterProtocolSelection

func (*Cluster) GetRespectDnsTtl

func (x *Cluster) GetRespectDnsTtl() bool

func (*Cluster) GetRingHashLbConfig

func (x *Cluster) GetRingHashLbConfig() *Cluster_RingHashLbConfig

func (*Cluster) GetTlsContext deprecated

func (x *Cluster) GetTlsContext() *auth.UpstreamTlsContext

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*Cluster) GetTrackTimeoutBudgets

func (x *Cluster) GetTrackTimeoutBudgets() bool

func (*Cluster) GetTransportSocket

func (x *Cluster) GetTransportSocket() *core.TransportSocket

func (*Cluster) GetTransportSocketMatches

func (x *Cluster) GetTransportSocketMatches() []*Cluster_TransportSocketMatch

func (*Cluster) GetType

func (x *Cluster) GetType() Cluster_DiscoveryType

func (*Cluster) GetTypedExtensionProtocolOptions

func (x *Cluster) GetTypedExtensionProtocolOptions() map[string]*anypb.Any

func (*Cluster) GetUpstreamBindConfig

func (x *Cluster) GetUpstreamBindConfig() *core.BindConfig

func (*Cluster) GetUpstreamConnectionOptions

func (x *Cluster) GetUpstreamConnectionOptions() *UpstreamConnectionOptions

func (*Cluster) GetUpstreamHttpProtocolOptions

func (x *Cluster) GetUpstreamHttpProtocolOptions() *core.UpstreamHttpProtocolOptions

func (*Cluster) GetUseTcpForDnsLookups

func (x *Cluster) GetUseTcpForDnsLookups() bool

func (*Cluster) HasCircuitBreakers

func (x *Cluster) HasCircuitBreakers() bool

func (*Cluster) HasCleanupInterval

func (x *Cluster) HasCleanupInterval() bool

func (*Cluster) HasClusterDiscoveryType

func (x *Cluster) HasClusterDiscoveryType() bool

func (*Cluster) HasClusterType

func (x *Cluster) HasClusterType() bool

func (*Cluster) HasCommonHttpProtocolOptions

func (x *Cluster) HasCommonHttpProtocolOptions() bool

func (*Cluster) HasCommonLbConfig

func (x *Cluster) HasCommonLbConfig() bool

func (*Cluster) HasConnectTimeout

func (x *Cluster) HasConnectTimeout() bool

func (*Cluster) HasDnsFailureRefreshRate

func (x *Cluster) HasDnsFailureRefreshRate() bool

func (*Cluster) HasDnsRefreshRate

func (x *Cluster) HasDnsRefreshRate() bool

func (*Cluster) HasEdsClusterConfig

func (x *Cluster) HasEdsClusterConfig() bool

func (*Cluster) HasHttp2ProtocolOptions

func (x *Cluster) HasHttp2ProtocolOptions() bool

func (*Cluster) HasHttpProtocolOptions

func (x *Cluster) HasHttpProtocolOptions() bool

func (*Cluster) HasLbConfig

func (x *Cluster) HasLbConfig() bool

func (*Cluster) HasLbSubsetConfig

func (x *Cluster) HasLbSubsetConfig() bool

func (*Cluster) HasLeastRequestLbConfig

func (x *Cluster) HasLeastRequestLbConfig() bool

func (*Cluster) HasLoadAssignment

func (x *Cluster) HasLoadAssignment() bool

func (*Cluster) HasLoadBalancingPolicy

func (x *Cluster) HasLoadBalancingPolicy() bool

func (*Cluster) HasLrsServer

func (x *Cluster) HasLrsServer() bool

func (*Cluster) HasMaxRequestsPerConnection

func (x *Cluster) HasMaxRequestsPerConnection() bool

func (*Cluster) HasMetadata

func (x *Cluster) HasMetadata() bool

func (*Cluster) HasOriginalDstLbConfig

func (x *Cluster) HasOriginalDstLbConfig() bool

func (*Cluster) HasOutlierDetection

func (x *Cluster) HasOutlierDetection() bool

func (*Cluster) HasPerConnectionBufferLimitBytes

func (x *Cluster) HasPerConnectionBufferLimitBytes() bool

func (*Cluster) HasRingHashLbConfig

func (x *Cluster) HasRingHashLbConfig() bool

func (*Cluster) HasTlsContext deprecated

func (x *Cluster) HasTlsContext() bool

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*Cluster) HasTransportSocket

func (x *Cluster) HasTransportSocket() bool

func (*Cluster) HasType

func (x *Cluster) HasType() bool

func (*Cluster) HasUpstreamBindConfig

func (x *Cluster) HasUpstreamBindConfig() bool

func (*Cluster) HasUpstreamConnectionOptions

func (x *Cluster) HasUpstreamConnectionOptions() bool

func (*Cluster) HasUpstreamHttpProtocolOptions

func (x *Cluster) HasUpstreamHttpProtocolOptions() bool

func (*Cluster) ProtoMessage

func (*Cluster) ProtoMessage()

func (*Cluster) ProtoReflect

func (x *Cluster) ProtoReflect() protoreflect.Message

func (*Cluster) Reset

func (x *Cluster) Reset()

func (*Cluster) SetAltStatName

func (x *Cluster) SetAltStatName(v string)

func (*Cluster) SetCircuitBreakers

func (x *Cluster) SetCircuitBreakers(v *cluster.CircuitBreakers)

func (*Cluster) SetCleanupInterval

func (x *Cluster) SetCleanupInterval(v *durationpb.Duration)

func (*Cluster) SetCloseConnectionsOnHostHealthFailure

func (x *Cluster) SetCloseConnectionsOnHostHealthFailure(v bool)

func (*Cluster) SetClusterType

func (x *Cluster) SetClusterType(v *Cluster_CustomClusterType)

func (*Cluster) SetCommonHttpProtocolOptions

func (x *Cluster) SetCommonHttpProtocolOptions(v *core.HttpProtocolOptions)

func (*Cluster) SetCommonLbConfig

func (x *Cluster) SetCommonLbConfig(v *Cluster_CommonLbConfig)

func (*Cluster) SetConnectTimeout

func (x *Cluster) SetConnectTimeout(v *durationpb.Duration)

func (*Cluster) SetDnsFailureRefreshRate

func (x *Cluster) SetDnsFailureRefreshRate(v *Cluster_RefreshRate)

func (*Cluster) SetDnsLookupFamily

func (x *Cluster) SetDnsLookupFamily(v Cluster_DnsLookupFamily)

func (*Cluster) SetDnsRefreshRate

func (x *Cluster) SetDnsRefreshRate(v *durationpb.Duration)

func (*Cluster) SetDnsResolvers

func (x *Cluster) SetDnsResolvers(v []*core.Address)

func (*Cluster) SetDrainConnectionsOnHostRemoval

func (x *Cluster) SetDrainConnectionsOnHostRemoval(v bool)

func (*Cluster) SetEdsClusterConfig

func (x *Cluster) SetEdsClusterConfig(v *Cluster_EdsClusterConfig)

func (*Cluster) SetExtensionProtocolOptions deprecated

func (x *Cluster) SetExtensionProtocolOptions(v map[string]*structpb.Struct)

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*Cluster) SetFilters

func (x *Cluster) SetFilters(v []*cluster.Filter)

func (*Cluster) SetHealthChecks

func (x *Cluster) SetHealthChecks(v []*core.HealthCheck)

func (*Cluster) SetHosts deprecated

func (x *Cluster) SetHosts(v []*core.Address)

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*Cluster) SetHttp2ProtocolOptions

func (x *Cluster) SetHttp2ProtocolOptions(v *core.Http2ProtocolOptions)

func (*Cluster) SetHttpProtocolOptions

func (x *Cluster) SetHttpProtocolOptions(v *core.Http1ProtocolOptions)

func (*Cluster) SetLbPolicy

func (x *Cluster) SetLbPolicy(v Cluster_LbPolicy)

func (*Cluster) SetLbSubsetConfig

func (x *Cluster) SetLbSubsetConfig(v *Cluster_LbSubsetConfig)

func (*Cluster) SetLeastRequestLbConfig

func (x *Cluster) SetLeastRequestLbConfig(v *Cluster_LeastRequestLbConfig)

func (*Cluster) SetLoadAssignment

func (x *Cluster) SetLoadAssignment(v *ClusterLoadAssignment)

func (*Cluster) SetLoadBalancingPolicy

func (x *Cluster) SetLoadBalancingPolicy(v *LoadBalancingPolicy)

func (*Cluster) SetLrsServer

func (x *Cluster) SetLrsServer(v *core.ConfigSource)

func (*Cluster) SetMaxRequestsPerConnection

func (x *Cluster) SetMaxRequestsPerConnection(v *wrapperspb.UInt32Value)

func (*Cluster) SetMetadata

func (x *Cluster) SetMetadata(v *core.Metadata)

func (*Cluster) SetName

func (x *Cluster) SetName(v string)

func (*Cluster) SetOriginalDstLbConfig

func (x *Cluster) SetOriginalDstLbConfig(v *Cluster_OriginalDstLbConfig)

func (*Cluster) SetOutlierDetection

func (x *Cluster) SetOutlierDetection(v *cluster.OutlierDetection)

func (*Cluster) SetPerConnectionBufferLimitBytes

func (x *Cluster) SetPerConnectionBufferLimitBytes(v *wrapperspb.UInt32Value)

func (*Cluster) SetProtocolSelection

func (x *Cluster) SetProtocolSelection(v Cluster_ClusterProtocolSelection)

func (*Cluster) SetRespectDnsTtl

func (x *Cluster) SetRespectDnsTtl(v bool)

func (*Cluster) SetRingHashLbConfig

func (x *Cluster) SetRingHashLbConfig(v *Cluster_RingHashLbConfig)

func (*Cluster) SetTlsContext deprecated

func (x *Cluster) SetTlsContext(v *auth.UpstreamTlsContext)

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*Cluster) SetTrackTimeoutBudgets

func (x *Cluster) SetTrackTimeoutBudgets(v bool)

func (*Cluster) SetTransportSocket

func (x *Cluster) SetTransportSocket(v *core.TransportSocket)

func (*Cluster) SetTransportSocketMatches

func (x *Cluster) SetTransportSocketMatches(v []*Cluster_TransportSocketMatch)

func (*Cluster) SetType

func (x *Cluster) SetType(v Cluster_DiscoveryType)

func (*Cluster) SetTypedExtensionProtocolOptions

func (x *Cluster) SetTypedExtensionProtocolOptions(v map[string]*anypb.Any)

func (*Cluster) SetUpstreamBindConfig

func (x *Cluster) SetUpstreamBindConfig(v *core.BindConfig)

func (*Cluster) SetUpstreamConnectionOptions

func (x *Cluster) SetUpstreamConnectionOptions(v *UpstreamConnectionOptions)

func (*Cluster) SetUpstreamHttpProtocolOptions

func (x *Cluster) SetUpstreamHttpProtocolOptions(v *core.UpstreamHttpProtocolOptions)

func (*Cluster) SetUseTcpForDnsLookups

func (x *Cluster) SetUseTcpForDnsLookups(v bool)

func (*Cluster) String

func (x *Cluster) String() string

func (*Cluster) WhichClusterDiscoveryType

func (x *Cluster) WhichClusterDiscoveryType() case_Cluster_ClusterDiscoveryType

func (*Cluster) WhichLbConfig

func (x *Cluster) WhichLbConfig() case_Cluster_LbConfig

type ClusterLoadAssignment

type ClusterLoadAssignment struct {

	// Name of the cluster. This will be the :ref:`service_name
	// <envoy_api_field_Cluster.EdsClusterConfig.service_name>` value if specified
	// in the cluster :ref:`EdsClusterConfig
	// <envoy_api_msg_Cluster.EdsClusterConfig>`.
	ClusterName string `protobuf:"bytes,1,opt,name=cluster_name,json=clusterName,proto3" json:"cluster_name,omitempty"`
	// List of endpoints to load balance to.
	Endpoints []*endpoint.LocalityLbEndpoints `protobuf:"bytes,2,rep,name=endpoints,proto3" json:"endpoints,omitempty"`
	// Map of named endpoints that can be referenced in LocalityLbEndpoints.
	// [#not-implemented-hide:]
	NamedEndpoints map[string]*endpoint.Endpoint `` /* 177-byte string literal not displayed */
	// Load balancing policy settings.
	Policy *ClusterLoadAssignment_Policy `protobuf:"bytes,4,opt,name=policy,proto3" json:"policy,omitempty"`
	// contains filtered or unexported fields
}

Each route from RDS will map to a single cluster or traffic split across clusters using weights expressed in the RDS WeightedCluster.

With EDS, each cluster is treated independently from a LB perspective, with LB taking place between the Localities within a cluster and at a finer granularity between the hosts within a locality. The percentage of traffic for each endpoint is determined by both its load_balancing_weight, and the load_balancing_weight of its locality. First, a locality will be selected, then an endpoint within that locality will be chose based on its weight. [#next-free-field: 6]

func (*ClusterLoadAssignment) ClearPolicy

func (x *ClusterLoadAssignment) ClearPolicy()

func (*ClusterLoadAssignment) GetClusterName

func (x *ClusterLoadAssignment) GetClusterName() string

func (*ClusterLoadAssignment) GetEndpoints

func (x *ClusterLoadAssignment) GetEndpoints() []*endpoint.LocalityLbEndpoints

func (*ClusterLoadAssignment) GetNamedEndpoints

func (x *ClusterLoadAssignment) GetNamedEndpoints() map[string]*endpoint.Endpoint

func (*ClusterLoadAssignment) GetPolicy

func (*ClusterLoadAssignment) HasPolicy

func (x *ClusterLoadAssignment) HasPolicy() bool

func (*ClusterLoadAssignment) ProtoMessage

func (*ClusterLoadAssignment) ProtoMessage()

func (*ClusterLoadAssignment) ProtoReflect

func (x *ClusterLoadAssignment) ProtoReflect() protoreflect.Message

func (*ClusterLoadAssignment) Reset

func (x *ClusterLoadAssignment) Reset()

func (*ClusterLoadAssignment) SetClusterName

func (x *ClusterLoadAssignment) SetClusterName(v string)

func (*ClusterLoadAssignment) SetEndpoints

func (x *ClusterLoadAssignment) SetEndpoints(v []*endpoint.LocalityLbEndpoints)

func (*ClusterLoadAssignment) SetNamedEndpoints

func (x *ClusterLoadAssignment) SetNamedEndpoints(v map[string]*endpoint.Endpoint)

func (*ClusterLoadAssignment) SetPolicy

func (*ClusterLoadAssignment) String

func (x *ClusterLoadAssignment) String() string

type ClusterLoadAssignment_Policy

type ClusterLoadAssignment_Policy struct {

	// Action to trim the overall incoming traffic to protect the upstream
	// hosts. This action allows protection in case the hosts are unable to
	// recover from an outage, or unable to autoscale or unable to handle
	// incoming traffic volume for any reason.
	//
	// At the client each category is applied one after the other to generate
	// the 'actual' drop percentage on all outgoing traffic. For example:
	//
	// .. code-block:: json
	//
	//	{ "drop_overloads": [
	//	    { "category": "throttle", "drop_percentage": 60 }
	//	    { "category": "lb", "drop_percentage": 50 }
	//	]}
	//
	// The actual drop percentages applied to the traffic at the clients will be
	//
	//	"throttle"_drop = 60%
	//	"lb"_drop = 20%  // 50% of the remaining 'actual' load, which is 40%.
	//	actual_outgoing_load = 20% // remaining after applying all categories.
	//
	// [#not-implemented-hide:]
	DropOverloads []*ClusterLoadAssignment_Policy_DropOverload `protobuf:"bytes,2,rep,name=drop_overloads,json=dropOverloads,proto3" json:"drop_overloads,omitempty"`
	// Priority levels and localities are considered overprovisioned with this
	// factor (in percentage). This means that we don't consider a priority
	// level or locality unhealthy until the percentage of healthy hosts
	// multiplied by the overprovisioning factor drops below 100.
	// With the default value 140(1.4), Envoy doesn't consider a priority level
	// or a locality unhealthy until their percentage of healthy hosts drops
	// below 72%. For example:
	//
	// .. code-block:: json
	//
	//	{ "overprovisioning_factor": 100 }
	//
	// Read more at :ref:`priority levels <arch_overview_load_balancing_priority_levels>` and
	// :ref:`localities <arch_overview_load_balancing_locality_weighted_lb>`.
	OverprovisioningFactor *wrapperspb.UInt32Value `` /* 127-byte string literal not displayed */
	// The max time until which the endpoints from this assignment can be used.
	// If no new assignments are received before this time expires the endpoints
	// are considered stale and should be marked unhealthy.
	// Defaults to 0 which means endpoints never go stale.
	EndpointStaleAfter *durationpb.Duration `protobuf:"bytes,4,opt,name=endpoint_stale_after,json=endpointStaleAfter,proto3" json:"endpoint_stale_after,omitempty"`
	// The flag to disable overprovisioning. If it is set to true,
	// :ref:`overprovisioning factor
	// <arch_overview_load_balancing_overprovisioning_factor>` will be ignored
	// and Envoy will not perform graceful failover between priority levels or
	// localities as endpoints become unhealthy. Otherwise Envoy will perform
	// graceful failover as :ref:`overprovisioning factor
	// <arch_overview_load_balancing_overprovisioning_factor>` suggests.
	// [#not-implemented-hide:]
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/endpoint.proto.
	DisableOverprovisioning bool `` /* 131-byte string literal not displayed */
	// contains filtered or unexported fields
}

Load balancing policy settings. [#next-free-field: 6]

func (*ClusterLoadAssignment_Policy) ClearEndpointStaleAfter

func (x *ClusterLoadAssignment_Policy) ClearEndpointStaleAfter()

func (*ClusterLoadAssignment_Policy) ClearOverprovisioningFactor

func (x *ClusterLoadAssignment_Policy) ClearOverprovisioningFactor()

func (*ClusterLoadAssignment_Policy) GetDisableOverprovisioning deprecated

func (x *ClusterLoadAssignment_Policy) GetDisableOverprovisioning() bool

Deprecated: Marked as deprecated in envoy/api/v2/endpoint.proto.

func (*ClusterLoadAssignment_Policy) GetDropOverloads

func (*ClusterLoadAssignment_Policy) GetEndpointStaleAfter

func (x *ClusterLoadAssignment_Policy) GetEndpointStaleAfter() *durationpb.Duration

func (*ClusterLoadAssignment_Policy) GetOverprovisioningFactor

func (x *ClusterLoadAssignment_Policy) GetOverprovisioningFactor() *wrapperspb.UInt32Value

func (*ClusterLoadAssignment_Policy) HasEndpointStaleAfter

func (x *ClusterLoadAssignment_Policy) HasEndpointStaleAfter() bool

func (*ClusterLoadAssignment_Policy) HasOverprovisioningFactor

func (x *ClusterLoadAssignment_Policy) HasOverprovisioningFactor() bool

func (*ClusterLoadAssignment_Policy) ProtoMessage

func (*ClusterLoadAssignment_Policy) ProtoMessage()

func (*ClusterLoadAssignment_Policy) ProtoReflect

func (*ClusterLoadAssignment_Policy) Reset

func (x *ClusterLoadAssignment_Policy) Reset()

func (*ClusterLoadAssignment_Policy) SetDisableOverprovisioning deprecated

func (x *ClusterLoadAssignment_Policy) SetDisableOverprovisioning(v bool)

Deprecated: Marked as deprecated in envoy/api/v2/endpoint.proto.

func (*ClusterLoadAssignment_Policy) SetDropOverloads

func (*ClusterLoadAssignment_Policy) SetEndpointStaleAfter

func (x *ClusterLoadAssignment_Policy) SetEndpointStaleAfter(v *durationpb.Duration)

func (*ClusterLoadAssignment_Policy) SetOverprovisioningFactor

func (x *ClusterLoadAssignment_Policy) SetOverprovisioningFactor(v *wrapperspb.UInt32Value)

func (*ClusterLoadAssignment_Policy) String

type ClusterLoadAssignment_Policy_DropOverload

type ClusterLoadAssignment_Policy_DropOverload struct {

	// Identifier for the policy specifying the drop.
	Category string `protobuf:"bytes,1,opt,name=category,proto3" json:"category,omitempty"`
	// Percentage of traffic that should be dropped for the category.
	DropPercentage *_type.FractionalPercent `protobuf:"bytes,2,opt,name=drop_percentage,json=dropPercentage,proto3" json:"drop_percentage,omitempty"`
	// contains filtered or unexported fields
}

[#not-implemented-hide:]

func (*ClusterLoadAssignment_Policy_DropOverload) ClearDropPercentage

func (x *ClusterLoadAssignment_Policy_DropOverload) ClearDropPercentage()

func (*ClusterLoadAssignment_Policy_DropOverload) GetCategory

func (*ClusterLoadAssignment_Policy_DropOverload) GetDropPercentage

func (*ClusterLoadAssignment_Policy_DropOverload) HasDropPercentage

func (x *ClusterLoadAssignment_Policy_DropOverload) HasDropPercentage() bool

func (*ClusterLoadAssignment_Policy_DropOverload) ProtoMessage

func (*ClusterLoadAssignment_Policy_DropOverload) ProtoReflect

func (*ClusterLoadAssignment_Policy_DropOverload) Reset

func (*ClusterLoadAssignment_Policy_DropOverload) SetCategory

func (*ClusterLoadAssignment_Policy_DropOverload) SetDropPercentage

func (*ClusterLoadAssignment_Policy_DropOverload) String

type ClusterLoadAssignment_Policy_DropOverload_builder

type ClusterLoadAssignment_Policy_DropOverload_builder struct {

	// Identifier for the policy specifying the drop.
	Category string
	// Percentage of traffic that should be dropped for the category.
	DropPercentage *_type.FractionalPercent
	// contains filtered or unexported fields
}

func (ClusterLoadAssignment_Policy_DropOverload_builder) Build

type ClusterLoadAssignment_Policy_builder

type ClusterLoadAssignment_Policy_builder struct {

	// Action to trim the overall incoming traffic to protect the upstream
	// hosts. This action allows protection in case the hosts are unable to
	// recover from an outage, or unable to autoscale or unable to handle
	// incoming traffic volume for any reason.
	//
	// At the client each category is applied one after the other to generate
	// the 'actual' drop percentage on all outgoing traffic. For example:
	//
	// .. code-block:: json
	//
	//	{ "drop_overloads": [
	//	    { "category": "throttle", "drop_percentage": 60 }
	//	    { "category": "lb", "drop_percentage": 50 }
	//	]}
	//
	// The actual drop percentages applied to the traffic at the clients will be
	//
	//	"throttle"_drop = 60%
	//	"lb"_drop = 20%  // 50% of the remaining 'actual' load, which is 40%.
	//	actual_outgoing_load = 20% // remaining after applying all categories.
	//
	// [#not-implemented-hide:]
	DropOverloads []*ClusterLoadAssignment_Policy_DropOverload
	// Priority levels and localities are considered overprovisioned with this
	// factor (in percentage). This means that we don't consider a priority
	// level or locality unhealthy until the percentage of healthy hosts
	// multiplied by the overprovisioning factor drops below 100.
	// With the default value 140(1.4), Envoy doesn't consider a priority level
	// or a locality unhealthy until their percentage of healthy hosts drops
	// below 72%. For example:
	//
	// .. code-block:: json
	//
	//	{ "overprovisioning_factor": 100 }
	//
	// Read more at :ref:`priority levels <arch_overview_load_balancing_priority_levels>` and
	// :ref:`localities <arch_overview_load_balancing_locality_weighted_lb>`.
	OverprovisioningFactor *wrapperspb.UInt32Value
	// The max time until which the endpoints from this assignment can be used.
	// If no new assignments are received before this time expires the endpoints
	// are considered stale and should be marked unhealthy.
	// Defaults to 0 which means endpoints never go stale.
	EndpointStaleAfter *durationpb.Duration
	// The flag to disable overprovisioning. If it is set to true,
	// :ref:`overprovisioning factor
	// <arch_overview_load_balancing_overprovisioning_factor>` will be ignored
	// and Envoy will not perform graceful failover between priority levels or
	// localities as endpoints become unhealthy. Otherwise Envoy will perform
	// graceful failover as :ref:`overprovisioning factor
	// <arch_overview_load_balancing_overprovisioning_factor>` suggests.
	// [#not-implemented-hide:]
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/endpoint.proto.
	DisableOverprovisioning bool
	// contains filtered or unexported fields
}

func (ClusterLoadAssignment_Policy_builder) Build

type ClusterLoadAssignment_builder

type ClusterLoadAssignment_builder struct {

	// Name of the cluster. This will be the :ref:`service_name
	// <envoy_api_field_Cluster.EdsClusterConfig.service_name>` value if specified
	// in the cluster :ref:`EdsClusterConfig
	// <envoy_api_msg_Cluster.EdsClusterConfig>`.
	ClusterName string
	// List of endpoints to load balance to.
	Endpoints []*endpoint.LocalityLbEndpoints
	// Map of named endpoints that can be referenced in LocalityLbEndpoints.
	// [#not-implemented-hide:]
	NamedEndpoints map[string]*endpoint.Endpoint
	// Load balancing policy settings.
	Policy *ClusterLoadAssignment_Policy
	// contains filtered or unexported fields
}

func (ClusterLoadAssignment_builder) Build

type Cluster_ClusterProtocolSelection

type Cluster_ClusterProtocolSelection int32
const (
	// Cluster can only operate on one of the possible upstream protocols (HTTP1.1, HTTP2).
	// If :ref:`http2_protocol_options <envoy_api_field_Cluster.http2_protocol_options>` are
	// present, HTTP2 will be used, otherwise HTTP1.1 will be used.
	Cluster_USE_CONFIGURED_PROTOCOL Cluster_ClusterProtocolSelection = 0
	// Use HTTP1.1 or HTTP2, depending on which one is used on the downstream connection.
	Cluster_USE_DOWNSTREAM_PROTOCOL Cluster_ClusterProtocolSelection = 1
)

func (Cluster_ClusterProtocolSelection) Descriptor

func (Cluster_ClusterProtocolSelection) Enum

func (Cluster_ClusterProtocolSelection) Number

func (Cluster_ClusterProtocolSelection) String

func (Cluster_ClusterProtocolSelection) Type

type Cluster_ClusterType

type Cluster_ClusterType struct {
	// The custom cluster type.
	ClusterType *Cluster_CustomClusterType `protobuf:"bytes,38,opt,name=cluster_type,json=clusterType,proto3,oneof"`
}

type Cluster_CommonLbConfig

type Cluster_CommonLbConfig struct {

	// Configures the :ref:`healthy panic threshold <arch_overview_load_balancing_panic_threshold>`.
	// If not specified, the default is 50%.
	// To disable panic mode, set to 0%.
	//
	// .. note::
	//
	//	The specified percent will be truncated to the nearest 1%.
	HealthyPanicThreshold *_type.Percent `` /* 126-byte string literal not displayed */
	// Types that are valid to be assigned to LocalityConfigSpecifier:
	//
	//	*Cluster_CommonLbConfig_ZoneAwareLbConfig_
	//	*Cluster_CommonLbConfig_LocalityWeightedLbConfig_
	LocalityConfigSpecifier isCluster_CommonLbConfig_LocalityConfigSpecifier `protobuf_oneof:"locality_config_specifier"`
	// If set, all health check/weight/metadata updates that happen within this duration will be
	// merged and delivered in one shot when the duration expires. The start of the duration is when
	// the first update happens. This is useful for big clusters, with potentially noisy deploys
	// that might trigger excessive CPU usage due to a constant stream of healthcheck state changes
	// or metadata updates. The first set of updates to be seen apply immediately (e.g.: a new
	// cluster). Please always keep in mind that the use of sandbox technologies may change this
	// behavior.
	//
	// If this is not set, we default to a merge window of 1000ms. To disable it, set the merge
	// window to 0.
	//
	// Note: merging does not apply to cluster membership changes (e.g.: adds/removes); this is
	// because merging those updates isn't currently safe. See
	// https://github.com/envoyproxy/envoy/pull/3941.
	UpdateMergeWindow *durationpb.Duration `protobuf:"bytes,4,opt,name=update_merge_window,json=updateMergeWindow,proto3" json:"update_merge_window,omitempty"`
	// If set to true, Envoy will not consider new hosts when computing load balancing weights until
	// they have been health checked for the first time. This will have no effect unless
	// active health checking is also configured.
	//
	// Ignoring a host means that for any load balancing calculations that adjust weights based
	// on the ratio of eligible hosts and total hosts (priority spillover, locality weighting and
	// panic mode) Envoy will exclude these hosts in the denominator.
	//
	// For example, with hosts in two priorities P0 and P1, where P0 looks like
	// {healthy, unhealthy (new), unhealthy (new)}
	// and where P1 looks like
	// {healthy, healthy}
	// all traffic will still hit P0, as 1 / (3 - 2) = 1.
	//
	// Enabling this will allow scaling up the number of hosts for a given cluster without entering
	// panic mode or triggering priority spillover, assuming the hosts pass the first health check.
	//
	// If panic mode is triggered, new hosts are still eligible for traffic; they simply do not
	// contribute to the calculation when deciding whether panic mode is enabled or not.
	IgnoreNewHostsUntilFirstHc bool `` /* 148-byte string literal not displayed */
	// If set to `true`, the cluster manager will drain all existing
	// connections to upstream hosts whenever hosts are added or removed from the cluster.
	CloseConnectionsOnHostSetChange bool `` /* 163-byte string literal not displayed */
	// Common Configuration for all consistent hashing load balancers (MaglevLb, RingHashLb, etc.)
	ConsistentHashingLbConfig *Cluster_CommonLbConfig_ConsistentHashingLbConfig `` /* 140-byte string literal not displayed */
	// contains filtered or unexported fields
}

Common configuration for all load balancer implementations. [#next-free-field: 8]

func (*Cluster_CommonLbConfig) ClearConsistentHashingLbConfig

func (x *Cluster_CommonLbConfig) ClearConsistentHashingLbConfig()

func (*Cluster_CommonLbConfig) ClearHealthyPanicThreshold

func (x *Cluster_CommonLbConfig) ClearHealthyPanicThreshold()

func (*Cluster_CommonLbConfig) ClearLocalityConfigSpecifier

func (x *Cluster_CommonLbConfig) ClearLocalityConfigSpecifier()

func (*Cluster_CommonLbConfig) ClearLocalityWeightedLbConfig

func (x *Cluster_CommonLbConfig) ClearLocalityWeightedLbConfig()

func (*Cluster_CommonLbConfig) ClearUpdateMergeWindow

func (x *Cluster_CommonLbConfig) ClearUpdateMergeWindow()

func (*Cluster_CommonLbConfig) ClearZoneAwareLbConfig

func (x *Cluster_CommonLbConfig) ClearZoneAwareLbConfig()

func (*Cluster_CommonLbConfig) GetCloseConnectionsOnHostSetChange

func (x *Cluster_CommonLbConfig) GetCloseConnectionsOnHostSetChange() bool

func (*Cluster_CommonLbConfig) GetConsistentHashingLbConfig

func (*Cluster_CommonLbConfig) GetHealthyPanicThreshold

func (x *Cluster_CommonLbConfig) GetHealthyPanicThreshold() *_type.Percent

func (*Cluster_CommonLbConfig) GetIgnoreNewHostsUntilFirstHc

func (x *Cluster_CommonLbConfig) GetIgnoreNewHostsUntilFirstHc() bool

func (*Cluster_CommonLbConfig) GetLocalityConfigSpecifier

func (x *Cluster_CommonLbConfig) GetLocalityConfigSpecifier() isCluster_CommonLbConfig_LocalityConfigSpecifier

func (*Cluster_CommonLbConfig) GetLocalityWeightedLbConfig

func (*Cluster_CommonLbConfig) GetUpdateMergeWindow

func (x *Cluster_CommonLbConfig) GetUpdateMergeWindow() *durationpb.Duration

func (*Cluster_CommonLbConfig) GetZoneAwareLbConfig

func (*Cluster_CommonLbConfig) HasConsistentHashingLbConfig

func (x *Cluster_CommonLbConfig) HasConsistentHashingLbConfig() bool

func (*Cluster_CommonLbConfig) HasHealthyPanicThreshold

func (x *Cluster_CommonLbConfig) HasHealthyPanicThreshold() bool

func (*Cluster_CommonLbConfig) HasLocalityConfigSpecifier

func (x *Cluster_CommonLbConfig) HasLocalityConfigSpecifier() bool

func (*Cluster_CommonLbConfig) HasLocalityWeightedLbConfig

func (x *Cluster_CommonLbConfig) HasLocalityWeightedLbConfig() bool

func (*Cluster_CommonLbConfig) HasUpdateMergeWindow

func (x *Cluster_CommonLbConfig) HasUpdateMergeWindow() bool

func (*Cluster_CommonLbConfig) HasZoneAwareLbConfig

func (x *Cluster_CommonLbConfig) HasZoneAwareLbConfig() bool

func (*Cluster_CommonLbConfig) ProtoMessage

func (*Cluster_CommonLbConfig) ProtoMessage()

func (*Cluster_CommonLbConfig) ProtoReflect

func (x *Cluster_CommonLbConfig) ProtoReflect() protoreflect.Message

func (*Cluster_CommonLbConfig) Reset

func (x *Cluster_CommonLbConfig) Reset()

func (*Cluster_CommonLbConfig) SetCloseConnectionsOnHostSetChange

func (x *Cluster_CommonLbConfig) SetCloseConnectionsOnHostSetChange(v bool)

func (*Cluster_CommonLbConfig) SetConsistentHashingLbConfig

func (*Cluster_CommonLbConfig) SetHealthyPanicThreshold

func (x *Cluster_CommonLbConfig) SetHealthyPanicThreshold(v *_type.Percent)

func (*Cluster_CommonLbConfig) SetIgnoreNewHostsUntilFirstHc

func (x *Cluster_CommonLbConfig) SetIgnoreNewHostsUntilFirstHc(v bool)

func (*Cluster_CommonLbConfig) SetLocalityWeightedLbConfig

func (*Cluster_CommonLbConfig) SetUpdateMergeWindow

func (x *Cluster_CommonLbConfig) SetUpdateMergeWindow(v *durationpb.Duration)

func (*Cluster_CommonLbConfig) SetZoneAwareLbConfig

func (*Cluster_CommonLbConfig) String

func (x *Cluster_CommonLbConfig) String() string

func (*Cluster_CommonLbConfig) WhichLocalityConfigSpecifier

func (x *Cluster_CommonLbConfig) WhichLocalityConfigSpecifier() case_Cluster_CommonLbConfig_LocalityConfigSpecifier

type Cluster_CommonLbConfig_ConsistentHashingLbConfig

type Cluster_CommonLbConfig_ConsistentHashingLbConfig struct {

	// If set to `true`, the cluster will use hostname instead of the resolved
	// address as the key to consistently hash to an upstream host. Only valid for StrictDNS clusters with hostnames which resolve to a single IP address.
	UseHostnameForHashing bool `` /* 129-byte string literal not displayed */
	// contains filtered or unexported fields
}

Common Configuration for all consistent hashing load balancers (MaglevLb, RingHashLb, etc.)

func (*Cluster_CommonLbConfig_ConsistentHashingLbConfig) GetUseHostnameForHashing

func (x *Cluster_CommonLbConfig_ConsistentHashingLbConfig) GetUseHostnameForHashing() bool

func (*Cluster_CommonLbConfig_ConsistentHashingLbConfig) ProtoMessage

func (*Cluster_CommonLbConfig_ConsistentHashingLbConfig) ProtoReflect

func (*Cluster_CommonLbConfig_ConsistentHashingLbConfig) Reset

func (*Cluster_CommonLbConfig_ConsistentHashingLbConfig) SetUseHostnameForHashing

func (x *Cluster_CommonLbConfig_ConsistentHashingLbConfig) SetUseHostnameForHashing(v bool)

func (*Cluster_CommonLbConfig_ConsistentHashingLbConfig) String

type Cluster_CommonLbConfig_ConsistentHashingLbConfig_builder

type Cluster_CommonLbConfig_ConsistentHashingLbConfig_builder struct {

	// If set to `true`, the cluster will use hostname instead of the resolved
	// address as the key to consistently hash to an upstream host. Only valid for StrictDNS clusters with hostnames which resolve to a single IP address.
	UseHostnameForHashing bool
	// contains filtered or unexported fields
}

func (Cluster_CommonLbConfig_ConsistentHashingLbConfig_builder) Build

type Cluster_CommonLbConfig_LocalityWeightedLbConfig

type Cluster_CommonLbConfig_LocalityWeightedLbConfig struct {
	// contains filtered or unexported fields
}

Configuration for :ref:`locality weighted load balancing <arch_overview_load_balancing_locality_weighted_lb>`

func (*Cluster_CommonLbConfig_LocalityWeightedLbConfig) ProtoMessage

func (*Cluster_CommonLbConfig_LocalityWeightedLbConfig) ProtoReflect

func (*Cluster_CommonLbConfig_LocalityWeightedLbConfig) Reset

func (*Cluster_CommonLbConfig_LocalityWeightedLbConfig) String

type Cluster_CommonLbConfig_LocalityWeightedLbConfig_

type Cluster_CommonLbConfig_LocalityWeightedLbConfig_ struct {
	LocalityWeightedLbConfig *Cluster_CommonLbConfig_LocalityWeightedLbConfig `protobuf:"bytes,3,opt,name=locality_weighted_lb_config,json=localityWeightedLbConfig,proto3,oneof"`
}

type Cluster_CommonLbConfig_LocalityWeightedLbConfig_builder

type Cluster_CommonLbConfig_LocalityWeightedLbConfig_builder struct {
	// contains filtered or unexported fields
}

func (Cluster_CommonLbConfig_LocalityWeightedLbConfig_builder) Build

type Cluster_CommonLbConfig_ZoneAwareLbConfig

type Cluster_CommonLbConfig_ZoneAwareLbConfig struct {

	// Configures percentage of requests that will be considered for zone aware routing
	// if zone aware routing is configured. If not specified, the default is 100%.
	// * :ref:`runtime values <config_cluster_manager_cluster_runtime_zone_routing>`.
	// * :ref:`Zone aware routing support <arch_overview_load_balancing_zone_aware_routing>`.
	RoutingEnabled *_type.Percent `protobuf:"bytes,1,opt,name=routing_enabled,json=routingEnabled,proto3" json:"routing_enabled,omitempty"`
	// Configures minimum upstream cluster size required for zone aware routing
	// If upstream cluster size is less than specified, zone aware routing is not performed
	// even if zone aware routing is configured. If not specified, the default is 6.
	// * :ref:`runtime values <config_cluster_manager_cluster_runtime_zone_routing>`.
	// * :ref:`Zone aware routing support <arch_overview_load_balancing_zone_aware_routing>`.
	MinClusterSize *wrapperspb.UInt64Value `protobuf:"bytes,2,opt,name=min_cluster_size,json=minClusterSize,proto3" json:"min_cluster_size,omitempty"`
	// If set to true, Envoy will not consider any hosts when the cluster is in :ref:`panic
	// mode<arch_overview_load_balancing_panic_threshold>`. Instead, the cluster will fail all
	// requests as if all hosts are unhealthy. This can help avoid potentially overwhelming a
	// failing service.
	FailTrafficOnPanic bool `protobuf:"varint,3,opt,name=fail_traffic_on_panic,json=failTrafficOnPanic,proto3" json:"fail_traffic_on_panic,omitempty"`
	// contains filtered or unexported fields
}

Configuration for :ref:`zone aware routing <arch_overview_load_balancing_zone_aware_routing>`.

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) ClearMinClusterSize

func (x *Cluster_CommonLbConfig_ZoneAwareLbConfig) ClearMinClusterSize()

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) ClearRoutingEnabled

func (x *Cluster_CommonLbConfig_ZoneAwareLbConfig) ClearRoutingEnabled()

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) GetFailTrafficOnPanic

func (x *Cluster_CommonLbConfig_ZoneAwareLbConfig) GetFailTrafficOnPanic() bool

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) GetMinClusterSize

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) GetRoutingEnabled

func (x *Cluster_CommonLbConfig_ZoneAwareLbConfig) GetRoutingEnabled() *_type.Percent

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) HasMinClusterSize

func (x *Cluster_CommonLbConfig_ZoneAwareLbConfig) HasMinClusterSize() bool

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) HasRoutingEnabled

func (x *Cluster_CommonLbConfig_ZoneAwareLbConfig) HasRoutingEnabled() bool

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) ProtoMessage

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) ProtoReflect

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) Reset

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) SetFailTrafficOnPanic

func (x *Cluster_CommonLbConfig_ZoneAwareLbConfig) SetFailTrafficOnPanic(v bool)

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) SetMinClusterSize

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) SetRoutingEnabled

func (x *Cluster_CommonLbConfig_ZoneAwareLbConfig) SetRoutingEnabled(v *_type.Percent)

func (*Cluster_CommonLbConfig_ZoneAwareLbConfig) String

type Cluster_CommonLbConfig_ZoneAwareLbConfig_

type Cluster_CommonLbConfig_ZoneAwareLbConfig_ struct {
	ZoneAwareLbConfig *Cluster_CommonLbConfig_ZoneAwareLbConfig `protobuf:"bytes,2,opt,name=zone_aware_lb_config,json=zoneAwareLbConfig,proto3,oneof"`
}

type Cluster_CommonLbConfig_ZoneAwareLbConfig_builder

type Cluster_CommonLbConfig_ZoneAwareLbConfig_builder struct {

	// Configures percentage of requests that will be considered for zone aware routing
	// if zone aware routing is configured. If not specified, the default is 100%.
	// * :ref:`runtime values <config_cluster_manager_cluster_runtime_zone_routing>`.
	// * :ref:`Zone aware routing support <arch_overview_load_balancing_zone_aware_routing>`.
	RoutingEnabled *_type.Percent
	// Configures minimum upstream cluster size required for zone aware routing
	// If upstream cluster size is less than specified, zone aware routing is not performed
	// even if zone aware routing is configured. If not specified, the default is 6.
	// * :ref:`runtime values <config_cluster_manager_cluster_runtime_zone_routing>`.
	// * :ref:`Zone aware routing support <arch_overview_load_balancing_zone_aware_routing>`.
	MinClusterSize *wrapperspb.UInt64Value
	// If set to true, Envoy will not consider any hosts when the cluster is in :ref:`panic
	// mode<arch_overview_load_balancing_panic_threshold>`. Instead, the cluster will fail all
	// requests as if all hosts are unhealthy. This can help avoid potentially overwhelming a
	// failing service.
	FailTrafficOnPanic bool
	// contains filtered or unexported fields
}

func (Cluster_CommonLbConfig_ZoneAwareLbConfig_builder) Build

type Cluster_CommonLbConfig_builder

type Cluster_CommonLbConfig_builder struct {

	// Configures the :ref:`healthy panic threshold <arch_overview_load_balancing_panic_threshold>`.
	// If not specified, the default is 50%.
	// To disable panic mode, set to 0%.
	//
	// .. note::
	//
	//	The specified percent will be truncated to the nearest 1%.
	HealthyPanicThreshold *_type.Percent
	// Fields of oneof LocalityConfigSpecifier:
	ZoneAwareLbConfig        *Cluster_CommonLbConfig_ZoneAwareLbConfig
	LocalityWeightedLbConfig *Cluster_CommonLbConfig_LocalityWeightedLbConfig
	// -- end of LocalityConfigSpecifier
	// If set, all health check/weight/metadata updates that happen within this duration will be
	// merged and delivered in one shot when the duration expires. The start of the duration is when
	// the first update happens. This is useful for big clusters, with potentially noisy deploys
	// that might trigger excessive CPU usage due to a constant stream of healthcheck state changes
	// or metadata updates. The first set of updates to be seen apply immediately (e.g.: a new
	// cluster). Please always keep in mind that the use of sandbox technologies may change this
	// behavior.
	//
	// If this is not set, we default to a merge window of 1000ms. To disable it, set the merge
	// window to 0.
	//
	// Note: merging does not apply to cluster membership changes (e.g.: adds/removes); this is
	// because merging those updates isn't currently safe. See
	// https://github.com/envoyproxy/envoy/pull/3941.
	UpdateMergeWindow *durationpb.Duration
	// If set to true, Envoy will not consider new hosts when computing load balancing weights until
	// they have been health checked for the first time. This will have no effect unless
	// active health checking is also configured.
	//
	// Ignoring a host means that for any load balancing calculations that adjust weights based
	// on the ratio of eligible hosts and total hosts (priority spillover, locality weighting and
	// panic mode) Envoy will exclude these hosts in the denominator.
	//
	// For example, with hosts in two priorities P0 and P1, where P0 looks like
	// {healthy, unhealthy (new), unhealthy (new)}
	// and where P1 looks like
	// {healthy, healthy}
	// all traffic will still hit P0, as 1 / (3 - 2) = 1.
	//
	// Enabling this will allow scaling up the number of hosts for a given cluster without entering
	// panic mode or triggering priority spillover, assuming the hosts pass the first health check.
	//
	// If panic mode is triggered, new hosts are still eligible for traffic; they simply do not
	// contribute to the calculation when deciding whether panic mode is enabled or not.
	IgnoreNewHostsUntilFirstHc bool
	// If set to `true`, the cluster manager will drain all existing
	// connections to upstream hosts whenever hosts are added or removed from the cluster.
	CloseConnectionsOnHostSetChange bool
	// Common Configuration for all consistent hashing load balancers (MaglevLb, RingHashLb, etc.)
	ConsistentHashingLbConfig *Cluster_CommonLbConfig_ConsistentHashingLbConfig
	// contains filtered or unexported fields
}

func (Cluster_CommonLbConfig_builder) Build

type Cluster_CustomClusterType

type Cluster_CustomClusterType struct {

	// The type of the cluster to instantiate. The name must match a supported cluster type.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Cluster specific configuration which depends on the cluster being instantiated.
	// See the supported cluster for further documentation.
	TypedConfig *anypb.Any `protobuf:"bytes,2,opt,name=typed_config,json=typedConfig,proto3" json:"typed_config,omitempty"`
	// contains filtered or unexported fields
}

Extended cluster type.

func (*Cluster_CustomClusterType) ClearTypedConfig

func (x *Cluster_CustomClusterType) ClearTypedConfig()

func (*Cluster_CustomClusterType) GetName

func (x *Cluster_CustomClusterType) GetName() string

func (*Cluster_CustomClusterType) GetTypedConfig

func (x *Cluster_CustomClusterType) GetTypedConfig() *anypb.Any

func (*Cluster_CustomClusterType) HasTypedConfig

func (x *Cluster_CustomClusterType) HasTypedConfig() bool

func (*Cluster_CustomClusterType) ProtoMessage

func (*Cluster_CustomClusterType) ProtoMessage()

func (*Cluster_CustomClusterType) ProtoReflect

func (*Cluster_CustomClusterType) Reset

func (x *Cluster_CustomClusterType) Reset()

func (*Cluster_CustomClusterType) SetName

func (x *Cluster_CustomClusterType) SetName(v string)

func (*Cluster_CustomClusterType) SetTypedConfig

func (x *Cluster_CustomClusterType) SetTypedConfig(v *anypb.Any)

func (*Cluster_CustomClusterType) String

func (x *Cluster_CustomClusterType) String() string

type Cluster_CustomClusterType_builder

type Cluster_CustomClusterType_builder struct {

	// The type of the cluster to instantiate. The name must match a supported cluster type.
	Name string
	// Cluster specific configuration which depends on the cluster being instantiated.
	// See the supported cluster for further documentation.
	TypedConfig *anypb.Any
	// contains filtered or unexported fields
}

func (Cluster_CustomClusterType_builder) Build

type Cluster_DiscoveryType

type Cluster_DiscoveryType int32

Refer to :ref:`service discovery type <arch_overview_service_discovery_types>` for an explanation on each type.

const (
	// Refer to the :ref:`static discovery type<arch_overview_service_discovery_types_static>`
	// for an explanation.
	Cluster_STATIC Cluster_DiscoveryType = 0
	// Refer to the :ref:`strict DNS discovery
	// type<arch_overview_service_discovery_types_strict_dns>`
	// for an explanation.
	Cluster_STRICT_DNS Cluster_DiscoveryType = 1
	// Refer to the :ref:`logical DNS discovery
	// type<arch_overview_service_discovery_types_logical_dns>`
	// for an explanation.
	Cluster_LOGICAL_DNS Cluster_DiscoveryType = 2
	// Refer to the :ref:`service discovery type<arch_overview_service_discovery_types_eds>`
	// for an explanation.
	Cluster_EDS Cluster_DiscoveryType = 3
	// Refer to the :ref:`original destination discovery
	// type<arch_overview_service_discovery_types_original_destination>`
	// for an explanation.
	Cluster_ORIGINAL_DST Cluster_DiscoveryType = 4
)

func (Cluster_DiscoveryType) Descriptor

func (Cluster_DiscoveryType) Enum

func (Cluster_DiscoveryType) Number

func (Cluster_DiscoveryType) String

func (x Cluster_DiscoveryType) String() string

func (Cluster_DiscoveryType) Type

type Cluster_DnsLookupFamily

type Cluster_DnsLookupFamily int32

When V4_ONLY is selected, the DNS resolver will only perform a lookup for addresses in the IPv4 family. If V6_ONLY is selected, the DNS resolver will only perform a lookup for addresses in the IPv6 family. If AUTO is specified, the DNS resolver will first perform a lookup for addresses in the IPv6 family and fallback to a lookup for addresses in the IPv4 family. For cluster types other than :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>` and :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`, this setting is ignored.

const (
	Cluster_AUTO    Cluster_DnsLookupFamily = 0
	Cluster_V4_ONLY Cluster_DnsLookupFamily = 1
	Cluster_V6_ONLY Cluster_DnsLookupFamily = 2
)

func (Cluster_DnsLookupFamily) Descriptor

func (Cluster_DnsLookupFamily) Enum

func (Cluster_DnsLookupFamily) Number

func (Cluster_DnsLookupFamily) String

func (x Cluster_DnsLookupFamily) String() string

func (Cluster_DnsLookupFamily) Type

type Cluster_EdsClusterConfig

type Cluster_EdsClusterConfig struct {

	// Configuration for the source of EDS updates for this Cluster.
	EdsConfig *core.ConfigSource `protobuf:"bytes,1,opt,name=eds_config,json=edsConfig,proto3" json:"eds_config,omitempty"`
	// Optional alternative to cluster name to present to EDS. This does not
	// have the same restrictions as cluster name, i.e. it may be arbitrary
	// length.
	ServiceName string `protobuf:"bytes,2,opt,name=service_name,json=serviceName,proto3" json:"service_name,omitempty"`
	// contains filtered or unexported fields
}

Only valid when discovery type is EDS.

func (*Cluster_EdsClusterConfig) ClearEdsConfig

func (x *Cluster_EdsClusterConfig) ClearEdsConfig()

func (*Cluster_EdsClusterConfig) GetEdsConfig

func (x *Cluster_EdsClusterConfig) GetEdsConfig() *core.ConfigSource

func (*Cluster_EdsClusterConfig) GetServiceName

func (x *Cluster_EdsClusterConfig) GetServiceName() string

func (*Cluster_EdsClusterConfig) HasEdsConfig

func (x *Cluster_EdsClusterConfig) HasEdsConfig() bool

func (*Cluster_EdsClusterConfig) ProtoMessage

func (*Cluster_EdsClusterConfig) ProtoMessage()

func (*Cluster_EdsClusterConfig) ProtoReflect

func (x *Cluster_EdsClusterConfig) ProtoReflect() protoreflect.Message

func (*Cluster_EdsClusterConfig) Reset

func (x *Cluster_EdsClusterConfig) Reset()

func (*Cluster_EdsClusterConfig) SetEdsConfig

func (x *Cluster_EdsClusterConfig) SetEdsConfig(v *core.ConfigSource)

func (*Cluster_EdsClusterConfig) SetServiceName

func (x *Cluster_EdsClusterConfig) SetServiceName(v string)

func (*Cluster_EdsClusterConfig) String

func (x *Cluster_EdsClusterConfig) String() string

type Cluster_EdsClusterConfig_builder

type Cluster_EdsClusterConfig_builder struct {

	// Configuration for the source of EDS updates for this Cluster.
	EdsConfig *core.ConfigSource
	// Optional alternative to cluster name to present to EDS. This does not
	// have the same restrictions as cluster name, i.e. it may be arbitrary
	// length.
	ServiceName string
	// contains filtered or unexported fields
}

func (Cluster_EdsClusterConfig_builder) Build

type Cluster_LbPolicy

type Cluster_LbPolicy int32

Refer to :ref:`load balancer type <arch_overview_load_balancing_types>` architecture overview section for information on each type.

const (
	// Refer to the :ref:`round robin load balancing
	// policy<arch_overview_load_balancing_types_round_robin>`
	// for an explanation.
	Cluster_ROUND_ROBIN Cluster_LbPolicy = 0
	// Refer to the :ref:`least request load balancing
	// policy<arch_overview_load_balancing_types_least_request>`
	// for an explanation.
	Cluster_LEAST_REQUEST Cluster_LbPolicy = 1
	// Refer to the :ref:`ring hash load balancing
	// policy<arch_overview_load_balancing_types_ring_hash>`
	// for an explanation.
	Cluster_RING_HASH Cluster_LbPolicy = 2
	// Refer to the :ref:`random load balancing
	// policy<arch_overview_load_balancing_types_random>`
	// for an explanation.
	Cluster_RANDOM Cluster_LbPolicy = 3
	// Refer to the :ref:`original destination load balancing
	// policy<arch_overview_load_balancing_types_original_destination>`
	// for an explanation.
	//
	// .. attention::
	//
	//	**This load balancing policy is deprecated**. Use CLUSTER_PROVIDED instead.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	Cluster_ORIGINAL_DST_LB Cluster_LbPolicy = 4
	// Refer to the :ref:`Maglev load balancing policy<arch_overview_load_balancing_types_maglev>`
	// for an explanation.
	Cluster_MAGLEV Cluster_LbPolicy = 5
	// This load balancer type must be specified if the configured cluster provides a cluster
	// specific load balancer. Consult the configured cluster's documentation for whether to set
	// this option or not.
	Cluster_CLUSTER_PROVIDED Cluster_LbPolicy = 6
	// [#not-implemented-hide:] Use the new :ref:`load_balancing_policy
	// <envoy_api_field_Cluster.load_balancing_policy>` field to determine the LB policy.
	// [#next-major-version: In the v3 API, we should consider deprecating the lb_policy field
	// and instead using the new load_balancing_policy field as the one and only mechanism for
	// configuring this.]
	Cluster_LOAD_BALANCING_POLICY_CONFIG Cluster_LbPolicy = 7
)

func (Cluster_LbPolicy) Descriptor

func (Cluster_LbPolicy) Enum

func (Cluster_LbPolicy) Number

func (Cluster_LbPolicy) String

func (x Cluster_LbPolicy) String() string

func (Cluster_LbPolicy) Type

type Cluster_LbSubsetConfig

type Cluster_LbSubsetConfig struct {

	// The behavior used when no endpoint subset matches the selected route's
	// metadata. The value defaults to
	// :ref:`NO_FALLBACK<envoy_api_enum_value_Cluster.LbSubsetConfig.LbSubsetFallbackPolicy.NO_FALLBACK>`.
	FallbackPolicy Cluster_LbSubsetConfig_LbSubsetFallbackPolicy `` /* 168-byte string literal not displayed */
	// Specifies the default subset of endpoints used during fallback if
	// fallback_policy is
	// :ref:`DEFAULT_SUBSET<envoy_api_enum_value_Cluster.LbSubsetConfig.LbSubsetFallbackPolicy.DEFAULT_SUBSET>`.
	// Each field in default_subset is
	// compared to the matching LbEndpoint.Metadata under the *envoy.lb*
	// namespace. It is valid for no hosts to match, in which case the behavior
	// is the same as a fallback_policy of
	// :ref:`NO_FALLBACK<envoy_api_enum_value_Cluster.LbSubsetConfig.LbSubsetFallbackPolicy.NO_FALLBACK>`.
	DefaultSubset *structpb.Struct `protobuf:"bytes,2,opt,name=default_subset,json=defaultSubset,proto3" json:"default_subset,omitempty"`
	// For each entry, LbEndpoint.Metadata's
	// *envoy.lb* namespace is traversed and a subset is created for each unique
	// combination of key and value. For example:
	//
	// .. code-block:: json
	//
	//	{ "subset_selectors": [
	//	    { "keys": [ "version" ] },
	//	    { "keys": [ "stage", "hardware_type" ] }
	//	]}
	//
	// A subset is matched when the metadata from the selected route and
	// weighted cluster contains the same keys and values as the subset's
	// metadata. The same host may appear in multiple subsets.
	SubsetSelectors []*Cluster_LbSubsetConfig_LbSubsetSelector `protobuf:"bytes,3,rep,name=subset_selectors,json=subsetSelectors,proto3" json:"subset_selectors,omitempty"`
	// If true, routing to subsets will take into account the localities and locality weights of the
	// endpoints when making the routing decision.
	//
	// There are some potential pitfalls associated with enabling this feature, as the resulting
	// traffic split after applying both a subset match and locality weights might be undesirable.
	//
	// Consider for example a situation in which you have 50/50 split across two localities X/Y
	// which have 100 hosts each without subsetting. If the subset LB results in X having only 1
	// host selected but Y having 100, then a lot more load is being dumped on the single host in X
	// than originally anticipated in the load balancing assignment delivered via EDS.
	LocalityWeightAware bool `protobuf:"varint,4,opt,name=locality_weight_aware,json=localityWeightAware,proto3" json:"locality_weight_aware,omitempty"`
	// When used with locality_weight_aware, scales the weight of each locality by the ratio
	// of hosts in the subset vs hosts in the original subset. This aims to even out the load
	// going to an individual locality if said locality is disproportionately affected by the
	// subset predicate.
	ScaleLocalityWeight bool `protobuf:"varint,5,opt,name=scale_locality_weight,json=scaleLocalityWeight,proto3" json:"scale_locality_weight,omitempty"`
	// If true, when a fallback policy is configured and its corresponding subset fails to find
	// a host this will cause any host to be selected instead.
	//
	// This is useful when using the default subset as the fallback policy, given the default
	// subset might become empty. With this option enabled, if that happens the LB will attempt
	// to select a host from the entire cluster.
	PanicModeAny bool `protobuf:"varint,6,opt,name=panic_mode_any,json=panicModeAny,proto3" json:"panic_mode_any,omitempty"`
	// If true, metadata specified for a metadata key will be matched against the corresponding
	// endpoint metadata if the endpoint metadata matches the value exactly OR it is a list value
	// and any of the elements in the list matches the criteria.
	ListAsAny bool `protobuf:"varint,7,opt,name=list_as_any,json=listAsAny,proto3" json:"list_as_any,omitempty"`
	// contains filtered or unexported fields
}

Optionally divide the endpoints in this cluster into subsets defined by endpoint metadata and selected by route and weighted cluster metadata. [#next-free-field: 8]

func (*Cluster_LbSubsetConfig) ClearDefaultSubset

func (x *Cluster_LbSubsetConfig) ClearDefaultSubset()

func (*Cluster_LbSubsetConfig) GetDefaultSubset

func (x *Cluster_LbSubsetConfig) GetDefaultSubset() *structpb.Struct

func (*Cluster_LbSubsetConfig) GetFallbackPolicy

func (*Cluster_LbSubsetConfig) GetListAsAny

func (x *Cluster_LbSubsetConfig) GetListAsAny() bool

func (*Cluster_LbSubsetConfig) GetLocalityWeightAware

func (x *Cluster_LbSubsetConfig) GetLocalityWeightAware() bool

func (*Cluster_LbSubsetConfig) GetPanicModeAny

func (x *Cluster_LbSubsetConfig) GetPanicModeAny() bool

func (*Cluster_LbSubsetConfig) GetScaleLocalityWeight

func (x *Cluster_LbSubsetConfig) GetScaleLocalityWeight() bool

func (*Cluster_LbSubsetConfig) GetSubsetSelectors

func (*Cluster_LbSubsetConfig) HasDefaultSubset

func (x *Cluster_LbSubsetConfig) HasDefaultSubset() bool

func (*Cluster_LbSubsetConfig) ProtoMessage

func (*Cluster_LbSubsetConfig) ProtoMessage()

func (*Cluster_LbSubsetConfig) ProtoReflect

func (x *Cluster_LbSubsetConfig) ProtoReflect() protoreflect.Message

func (*Cluster_LbSubsetConfig) Reset

func (x *Cluster_LbSubsetConfig) Reset()

func (*Cluster_LbSubsetConfig) SetDefaultSubset

func (x *Cluster_LbSubsetConfig) SetDefaultSubset(v *structpb.Struct)

func (*Cluster_LbSubsetConfig) SetFallbackPolicy

func (*Cluster_LbSubsetConfig) SetListAsAny

func (x *Cluster_LbSubsetConfig) SetListAsAny(v bool)

func (*Cluster_LbSubsetConfig) SetLocalityWeightAware

func (x *Cluster_LbSubsetConfig) SetLocalityWeightAware(v bool)

func (*Cluster_LbSubsetConfig) SetPanicModeAny

func (x *Cluster_LbSubsetConfig) SetPanicModeAny(v bool)

func (*Cluster_LbSubsetConfig) SetScaleLocalityWeight

func (x *Cluster_LbSubsetConfig) SetScaleLocalityWeight(v bool)

func (*Cluster_LbSubsetConfig) SetSubsetSelectors

func (*Cluster_LbSubsetConfig) String

func (x *Cluster_LbSubsetConfig) String() string

type Cluster_LbSubsetConfig_LbSubsetFallbackPolicy

type Cluster_LbSubsetConfig_LbSubsetFallbackPolicy int32

If NO_FALLBACK is selected, a result equivalent to no healthy hosts is reported. If ANY_ENDPOINT is selected, any cluster endpoint may be returned (subject to policy, health checks, etc). If DEFAULT_SUBSET is selected, load balancing is performed over the endpoints matching the values from the default_subset field.

const (
	Cluster_LbSubsetConfig_NO_FALLBACK    Cluster_LbSubsetConfig_LbSubsetFallbackPolicy = 0
	Cluster_LbSubsetConfig_ANY_ENDPOINT   Cluster_LbSubsetConfig_LbSubsetFallbackPolicy = 1
	Cluster_LbSubsetConfig_DEFAULT_SUBSET Cluster_LbSubsetConfig_LbSubsetFallbackPolicy = 2
)

func (Cluster_LbSubsetConfig_LbSubsetFallbackPolicy) Descriptor

func (Cluster_LbSubsetConfig_LbSubsetFallbackPolicy) Enum

func (Cluster_LbSubsetConfig_LbSubsetFallbackPolicy) Number

func (Cluster_LbSubsetConfig_LbSubsetFallbackPolicy) String

func (Cluster_LbSubsetConfig_LbSubsetFallbackPolicy) Type

type Cluster_LbSubsetConfig_LbSubsetSelector

type Cluster_LbSubsetConfig_LbSubsetSelector struct {

	// List of keys to match with the weighted cluster metadata.
	Keys []string `protobuf:"bytes,1,rep,name=keys,proto3" json:"keys,omitempty"`
	// The behavior used when no endpoint subset matches the selected route's
	// metadata.
	FallbackPolicy Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy `` /* 193-byte string literal not displayed */
	// Subset of
	// :ref:`keys<envoy_api_field_Cluster.LbSubsetConfig.LbSubsetSelector.keys>` used by
	// :ref:`KEYS_SUBSET<envoy_api_enum_value_Cluster.LbSubsetConfig.LbSubsetSelector.LbSubsetSelectorFallbackPolicy.KEYS_SUBSET>`
	// fallback policy.
	// It has to be a non empty list if KEYS_SUBSET fallback policy is selected.
	// For any other fallback policy the parameter is not used and should not be set.
	// Only values also present in
	// :ref:`keys<envoy_api_field_Cluster.LbSubsetConfig.LbSubsetSelector.keys>` are allowed, but
	// `fallback_keys_subset` cannot be equal to `keys`.
	FallbackKeysSubset []string `protobuf:"bytes,3,rep,name=fallback_keys_subset,json=fallbackKeysSubset,proto3" json:"fallback_keys_subset,omitempty"`
	// contains filtered or unexported fields
}

Specifications for subsets.

func (*Cluster_LbSubsetConfig_LbSubsetSelector) GetFallbackKeysSubset

func (x *Cluster_LbSubsetConfig_LbSubsetSelector) GetFallbackKeysSubset() []string

func (*Cluster_LbSubsetConfig_LbSubsetSelector) GetFallbackPolicy

func (*Cluster_LbSubsetConfig_LbSubsetSelector) GetKeys

func (*Cluster_LbSubsetConfig_LbSubsetSelector) ProtoMessage

func (*Cluster_LbSubsetConfig_LbSubsetSelector) ProtoReflect

func (*Cluster_LbSubsetConfig_LbSubsetSelector) Reset

func (*Cluster_LbSubsetConfig_LbSubsetSelector) SetFallbackKeysSubset

func (x *Cluster_LbSubsetConfig_LbSubsetSelector) SetFallbackKeysSubset(v []string)

func (*Cluster_LbSubsetConfig_LbSubsetSelector) SetFallbackPolicy

func (*Cluster_LbSubsetConfig_LbSubsetSelector) SetKeys

func (*Cluster_LbSubsetConfig_LbSubsetSelector) String

type Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy

type Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy int32

Allows to override top level fallback policy per selector.

const (
	// If NOT_DEFINED top level config fallback policy is used instead.
	Cluster_LbSubsetConfig_LbSubsetSelector_NOT_DEFINED Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy = 0
	// If NO_FALLBACK is selected, a result equivalent to no healthy hosts is reported.
	Cluster_LbSubsetConfig_LbSubsetSelector_NO_FALLBACK Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy = 1
	// If ANY_ENDPOINT is selected, any cluster endpoint may be returned
	// (subject to policy, health checks, etc).
	Cluster_LbSubsetConfig_LbSubsetSelector_ANY_ENDPOINT Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy = 2
	// If DEFAULT_SUBSET is selected, load balancing is performed over the
	// endpoints matching the values from the default_subset field.
	Cluster_LbSubsetConfig_LbSubsetSelector_DEFAULT_SUBSET Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy = 3
	// If KEYS_SUBSET is selected, subset selector matching is performed again with metadata
	// keys reduced to
	// :ref:`fallback_keys_subset<envoy_api_field_Cluster.LbSubsetConfig.LbSubsetSelector.fallback_keys_subset>`.
	// It allows for a fallback to a different, less specific selector if some of the keys of
	// the selector are considered optional.
	Cluster_LbSubsetConfig_LbSubsetSelector_KEYS_SUBSET Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy = 4
)

func (Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy) Descriptor

func (Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy) Enum

func (Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy) Number

func (Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy) String

func (Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy) Type

type Cluster_LbSubsetConfig_LbSubsetSelector_builder

type Cluster_LbSubsetConfig_LbSubsetSelector_builder struct {

	// List of keys to match with the weighted cluster metadata.
	Keys []string
	// The behavior used when no endpoint subset matches the selected route's
	// metadata.
	FallbackPolicy Cluster_LbSubsetConfig_LbSubsetSelector_LbSubsetSelectorFallbackPolicy
	// Subset of
	// :ref:`keys<envoy_api_field_Cluster.LbSubsetConfig.LbSubsetSelector.keys>` used by
	// :ref:`KEYS_SUBSET<envoy_api_enum_value_Cluster.LbSubsetConfig.LbSubsetSelector.LbSubsetSelectorFallbackPolicy.KEYS_SUBSET>`
	// fallback policy.
	// It has to be a non empty list if KEYS_SUBSET fallback policy is selected.
	// For any other fallback policy the parameter is not used and should not be set.
	// Only values also present in
	// :ref:`keys<envoy_api_field_Cluster.LbSubsetConfig.LbSubsetSelector.keys>` are allowed, but
	// `fallback_keys_subset` cannot be equal to `keys`.
	FallbackKeysSubset []string
	// contains filtered or unexported fields
}

func (Cluster_LbSubsetConfig_LbSubsetSelector_builder) Build

type Cluster_LbSubsetConfig_builder

type Cluster_LbSubsetConfig_builder struct {

	// The behavior used when no endpoint subset matches the selected route's
	// metadata. The value defaults to
	// :ref:`NO_FALLBACK<envoy_api_enum_value_Cluster.LbSubsetConfig.LbSubsetFallbackPolicy.NO_FALLBACK>`.
	FallbackPolicy Cluster_LbSubsetConfig_LbSubsetFallbackPolicy
	// Specifies the default subset of endpoints used during fallback if
	// fallback_policy is
	// :ref:`DEFAULT_SUBSET<envoy_api_enum_value_Cluster.LbSubsetConfig.LbSubsetFallbackPolicy.DEFAULT_SUBSET>`.
	// Each field in default_subset is
	// compared to the matching LbEndpoint.Metadata under the *envoy.lb*
	// namespace. It is valid for no hosts to match, in which case the behavior
	// is the same as a fallback_policy of
	// :ref:`NO_FALLBACK<envoy_api_enum_value_Cluster.LbSubsetConfig.LbSubsetFallbackPolicy.NO_FALLBACK>`.
	DefaultSubset *structpb.Struct
	// For each entry, LbEndpoint.Metadata's
	// *envoy.lb* namespace is traversed and a subset is created for each unique
	// combination of key and value. For example:
	//
	// .. code-block:: json
	//
	//	{ "subset_selectors": [
	//	    { "keys": [ "version" ] },
	//	    { "keys": [ "stage", "hardware_type" ] }
	//	]}
	//
	// A subset is matched when the metadata from the selected route and
	// weighted cluster contains the same keys and values as the subset's
	// metadata. The same host may appear in multiple subsets.
	SubsetSelectors []*Cluster_LbSubsetConfig_LbSubsetSelector
	// If true, routing to subsets will take into account the localities and locality weights of the
	// endpoints when making the routing decision.
	//
	// There are some potential pitfalls associated with enabling this feature, as the resulting
	// traffic split after applying both a subset match and locality weights might be undesirable.
	//
	// Consider for example a situation in which you have 50/50 split across two localities X/Y
	// which have 100 hosts each without subsetting. If the subset LB results in X having only 1
	// host selected but Y having 100, then a lot more load is being dumped on the single host in X
	// than originally anticipated in the load balancing assignment delivered via EDS.
	LocalityWeightAware bool
	// When used with locality_weight_aware, scales the weight of each locality by the ratio
	// of hosts in the subset vs hosts in the original subset. This aims to even out the load
	// going to an individual locality if said locality is disproportionately affected by the
	// subset predicate.
	ScaleLocalityWeight bool
	// If true, when a fallback policy is configured and its corresponding subset fails to find
	// a host this will cause any host to be selected instead.
	//
	// This is useful when using the default subset as the fallback policy, given the default
	// subset might become empty. With this option enabled, if that happens the LB will attempt
	// to select a host from the entire cluster.
	PanicModeAny bool
	// If true, metadata specified for a metadata key will be matched against the corresponding
	// endpoint metadata if the endpoint metadata matches the value exactly OR it is a list value
	// and any of the elements in the list matches the criteria.
	ListAsAny bool
	// contains filtered or unexported fields
}

func (Cluster_LbSubsetConfig_builder) Build

type Cluster_LeastRequestLbConfig

type Cluster_LeastRequestLbConfig struct {

	// The number of random healthy hosts from which the host with the fewest active requests will
	// be chosen. Defaults to 2 so that we perform two-choice selection if the field is not set.
	ChoiceCount *wrapperspb.UInt32Value `protobuf:"bytes,1,opt,name=choice_count,json=choiceCount,proto3" json:"choice_count,omitempty"`
	// contains filtered or unexported fields
}

Specific configuration for the LeastRequest load balancing policy.

func (*Cluster_LeastRequestLbConfig) ClearChoiceCount

func (x *Cluster_LeastRequestLbConfig) ClearChoiceCount()

func (*Cluster_LeastRequestLbConfig) GetChoiceCount

func (*Cluster_LeastRequestLbConfig) HasChoiceCount

func (x *Cluster_LeastRequestLbConfig) HasChoiceCount() bool

func (*Cluster_LeastRequestLbConfig) ProtoMessage

func (*Cluster_LeastRequestLbConfig) ProtoMessage()

func (*Cluster_LeastRequestLbConfig) ProtoReflect

func (*Cluster_LeastRequestLbConfig) Reset

func (x *Cluster_LeastRequestLbConfig) Reset()

func (*Cluster_LeastRequestLbConfig) SetChoiceCount

func (x *Cluster_LeastRequestLbConfig) SetChoiceCount(v *wrapperspb.UInt32Value)

func (*Cluster_LeastRequestLbConfig) String

type Cluster_LeastRequestLbConfig_

type Cluster_LeastRequestLbConfig_ struct {
	// Optional configuration for the LeastRequest load balancing policy.
	LeastRequestLbConfig *Cluster_LeastRequestLbConfig `protobuf:"bytes,37,opt,name=least_request_lb_config,json=leastRequestLbConfig,proto3,oneof"`
}

type Cluster_LeastRequestLbConfig_builder

type Cluster_LeastRequestLbConfig_builder struct {

	// The number of random healthy hosts from which the host with the fewest active requests will
	// be chosen. Defaults to 2 so that we perform two-choice selection if the field is not set.
	ChoiceCount *wrapperspb.UInt32Value
	// contains filtered or unexported fields
}

func (Cluster_LeastRequestLbConfig_builder) Build

type Cluster_OriginalDstLbConfig

type Cluster_OriginalDstLbConfig struct {

	// When true, :ref:`x-envoy-original-dst-host
	// <config_http_conn_man_headers_x-envoy-original-dst-host>` can be used to override destination
	// address.
	//
	// .. attention::
	//
	//	This header isn't sanitized by default, so enabling this feature allows HTTP clients to
	//	route traffic to arbitrary hosts and/or ports, which may have serious security
	//	consequences.
	//
	// .. note::
	//
	//	If the header appears multiple times only the first value is used.
	UseHttpHeader bool `protobuf:"varint,1,opt,name=use_http_header,json=useHttpHeader,proto3" json:"use_http_header,omitempty"`
	// contains filtered or unexported fields
}

Specific configuration for the :ref:`Original Destination <arch_overview_load_balancing_types_original_destination>` load balancing policy.

func (*Cluster_OriginalDstLbConfig) GetUseHttpHeader

func (x *Cluster_OriginalDstLbConfig) GetUseHttpHeader() bool

func (*Cluster_OriginalDstLbConfig) ProtoMessage

func (*Cluster_OriginalDstLbConfig) ProtoMessage()

func (*Cluster_OriginalDstLbConfig) ProtoReflect

func (*Cluster_OriginalDstLbConfig) Reset

func (x *Cluster_OriginalDstLbConfig) Reset()

func (*Cluster_OriginalDstLbConfig) SetUseHttpHeader

func (x *Cluster_OriginalDstLbConfig) SetUseHttpHeader(v bool)

func (*Cluster_OriginalDstLbConfig) String

func (x *Cluster_OriginalDstLbConfig) String() string

type Cluster_OriginalDstLbConfig_

type Cluster_OriginalDstLbConfig_ struct {
	// Optional configuration for the Original Destination load balancing policy.
	OriginalDstLbConfig *Cluster_OriginalDstLbConfig `protobuf:"bytes,34,opt,name=original_dst_lb_config,json=originalDstLbConfig,proto3,oneof"`
}

type Cluster_OriginalDstLbConfig_builder

type Cluster_OriginalDstLbConfig_builder struct {

	// When true, :ref:`x-envoy-original-dst-host
	// <config_http_conn_man_headers_x-envoy-original-dst-host>` can be used to override destination
	// address.
	//
	// .. attention::
	//
	//	This header isn't sanitized by default, so enabling this feature allows HTTP clients to
	//	route traffic to arbitrary hosts and/or ports, which may have serious security
	//	consequences.
	//
	// .. note::
	//
	//	If the header appears multiple times only the first value is used.
	UseHttpHeader bool
	// contains filtered or unexported fields
}

func (Cluster_OriginalDstLbConfig_builder) Build

type Cluster_RefreshRate

type Cluster_RefreshRate struct {

	// Specifies the base interval between refreshes. This parameter is required and must be greater
	// than zero and less than
	// :ref:`max_interval <envoy_api_field_Cluster.RefreshRate.max_interval>`.
	BaseInterval *durationpb.Duration `protobuf:"bytes,1,opt,name=base_interval,json=baseInterval,proto3" json:"base_interval,omitempty"`
	// Specifies the maximum interval between refreshes. This parameter is optional, but must be
	// greater than or equal to the
	// :ref:`base_interval <envoy_api_field_Cluster.RefreshRate.base_interval>`  if set. The default
	// is 10 times the :ref:`base_interval <envoy_api_field_Cluster.RefreshRate.base_interval>`.
	MaxInterval *durationpb.Duration `protobuf:"bytes,2,opt,name=max_interval,json=maxInterval,proto3" json:"max_interval,omitempty"`
	// contains filtered or unexported fields
}

func (*Cluster_RefreshRate) ClearBaseInterval

func (x *Cluster_RefreshRate) ClearBaseInterval()

func (*Cluster_RefreshRate) ClearMaxInterval

func (x *Cluster_RefreshRate) ClearMaxInterval()

func (*Cluster_RefreshRate) GetBaseInterval

func (x *Cluster_RefreshRate) GetBaseInterval() *durationpb.Duration

func (*Cluster_RefreshRate) GetMaxInterval

func (x *Cluster_RefreshRate) GetMaxInterval() *durationpb.Duration

func (*Cluster_RefreshRate) HasBaseInterval

func (x *Cluster_RefreshRate) HasBaseInterval() bool

func (*Cluster_RefreshRate) HasMaxInterval

func (x *Cluster_RefreshRate) HasMaxInterval() bool

func (*Cluster_RefreshRate) ProtoMessage

func (*Cluster_RefreshRate) ProtoMessage()

func (*Cluster_RefreshRate) ProtoReflect

func (x *Cluster_RefreshRate) ProtoReflect() protoreflect.Message

func (*Cluster_RefreshRate) Reset

func (x *Cluster_RefreshRate) Reset()

func (*Cluster_RefreshRate) SetBaseInterval

func (x *Cluster_RefreshRate) SetBaseInterval(v *durationpb.Duration)

func (*Cluster_RefreshRate) SetMaxInterval

func (x *Cluster_RefreshRate) SetMaxInterval(v *durationpb.Duration)

func (*Cluster_RefreshRate) String

func (x *Cluster_RefreshRate) String() string

type Cluster_RefreshRate_builder

type Cluster_RefreshRate_builder struct {

	// Specifies the base interval between refreshes. This parameter is required and must be greater
	// than zero and less than
	// :ref:`max_interval <envoy_api_field_Cluster.RefreshRate.max_interval>`.
	BaseInterval *durationpb.Duration
	// Specifies the maximum interval between refreshes. This parameter is optional, but must be
	// greater than or equal to the
	// :ref:`base_interval <envoy_api_field_Cluster.RefreshRate.base_interval>`  if set. The default
	// is 10 times the :ref:`base_interval <envoy_api_field_Cluster.RefreshRate.base_interval>`.
	MaxInterval *durationpb.Duration
	// contains filtered or unexported fields
}

func (Cluster_RefreshRate_builder) Build

type Cluster_RingHashLbConfig

type Cluster_RingHashLbConfig struct {

	// Minimum hash ring size. The larger the ring is (that is, the more hashes there are for each
	// provided host) the better the request distribution will reflect the desired weights. Defaults
	// to 1024 entries, and limited to 8M entries. See also
	// :ref:`maximum_ring_size<envoy_api_field_Cluster.RingHashLbConfig.maximum_ring_size>`.
	MinimumRingSize *wrapperspb.UInt64Value `protobuf:"bytes,1,opt,name=minimum_ring_size,json=minimumRingSize,proto3" json:"minimum_ring_size,omitempty"`
	// The hash function used to hash hosts onto the ketama ring. The value defaults to
	// :ref:`XX_HASH<envoy_api_enum_value_Cluster.RingHashLbConfig.HashFunction.XX_HASH>`.
	HashFunction Cluster_RingHashLbConfig_HashFunction `` /* 154-byte string literal not displayed */
	// Maximum hash ring size. Defaults to 8M entries, and limited to 8M entries, but can be lowered
	// to further constrain resource use. See also
	// :ref:`minimum_ring_size<envoy_api_field_Cluster.RingHashLbConfig.minimum_ring_size>`.
	MaximumRingSize *wrapperspb.UInt64Value `protobuf:"bytes,4,opt,name=maximum_ring_size,json=maximumRingSize,proto3" json:"maximum_ring_size,omitempty"`
	// contains filtered or unexported fields
}

Specific configuration for the :ref:`RingHash<arch_overview_load_balancing_types_ring_hash>` load balancing policy.

func (*Cluster_RingHashLbConfig) ClearMaximumRingSize

func (x *Cluster_RingHashLbConfig) ClearMaximumRingSize()

func (*Cluster_RingHashLbConfig) ClearMinimumRingSize

func (x *Cluster_RingHashLbConfig) ClearMinimumRingSize()

func (*Cluster_RingHashLbConfig) GetHashFunction

func (*Cluster_RingHashLbConfig) GetMaximumRingSize

func (x *Cluster_RingHashLbConfig) GetMaximumRingSize() *wrapperspb.UInt64Value

func (*Cluster_RingHashLbConfig) GetMinimumRingSize

func (x *Cluster_RingHashLbConfig) GetMinimumRingSize() *wrapperspb.UInt64Value

func (*Cluster_RingHashLbConfig) HasMaximumRingSize

func (x *Cluster_RingHashLbConfig) HasMaximumRingSize() bool

func (*Cluster_RingHashLbConfig) HasMinimumRingSize

func (x *Cluster_RingHashLbConfig) HasMinimumRingSize() bool

func (*Cluster_RingHashLbConfig) ProtoMessage

func (*Cluster_RingHashLbConfig) ProtoMessage()

func (*Cluster_RingHashLbConfig) ProtoReflect

func (x *Cluster_RingHashLbConfig) ProtoReflect() protoreflect.Message

func (*Cluster_RingHashLbConfig) Reset

func (x *Cluster_RingHashLbConfig) Reset()

func (*Cluster_RingHashLbConfig) SetHashFunction

func (*Cluster_RingHashLbConfig) SetMaximumRingSize

func (x *Cluster_RingHashLbConfig) SetMaximumRingSize(v *wrapperspb.UInt64Value)

func (*Cluster_RingHashLbConfig) SetMinimumRingSize

func (x *Cluster_RingHashLbConfig) SetMinimumRingSize(v *wrapperspb.UInt64Value)

func (*Cluster_RingHashLbConfig) String

func (x *Cluster_RingHashLbConfig) String() string

type Cluster_RingHashLbConfig_

type Cluster_RingHashLbConfig_ struct {
	// Optional configuration for the Ring Hash load balancing policy.
	RingHashLbConfig *Cluster_RingHashLbConfig `protobuf:"bytes,23,opt,name=ring_hash_lb_config,json=ringHashLbConfig,proto3,oneof"`
}

type Cluster_RingHashLbConfig_HashFunction

type Cluster_RingHashLbConfig_HashFunction int32

The hash function used to hash hosts onto the ketama ring.

const (
	// Use `xxHash <https://github.com/Cyan4973/xxHash>`_, this is the default hash function.
	Cluster_RingHashLbConfig_XX_HASH Cluster_RingHashLbConfig_HashFunction = 0
	// Use `MurmurHash2 <https://sites.google.com/site/murmurhash/>`_, this is compatible with
	// std:hash<string> in GNU libstdc++ 3.4.20 or above. This is typically the case when compiled
	// on Linux and not macOS.
	Cluster_RingHashLbConfig_MURMUR_HASH_2 Cluster_RingHashLbConfig_HashFunction = 1
)

func (Cluster_RingHashLbConfig_HashFunction) Descriptor

func (Cluster_RingHashLbConfig_HashFunction) Enum

func (Cluster_RingHashLbConfig_HashFunction) Number

func (Cluster_RingHashLbConfig_HashFunction) String

func (Cluster_RingHashLbConfig_HashFunction) Type

type Cluster_RingHashLbConfig_builder

type Cluster_RingHashLbConfig_builder struct {

	// Minimum hash ring size. The larger the ring is (that is, the more hashes there are for each
	// provided host) the better the request distribution will reflect the desired weights. Defaults
	// to 1024 entries, and limited to 8M entries. See also
	// :ref:`maximum_ring_size<envoy_api_field_Cluster.RingHashLbConfig.maximum_ring_size>`.
	MinimumRingSize *wrapperspb.UInt64Value
	// The hash function used to hash hosts onto the ketama ring. The value defaults to
	// :ref:`XX_HASH<envoy_api_enum_value_Cluster.RingHashLbConfig.HashFunction.XX_HASH>`.
	HashFunction Cluster_RingHashLbConfig_HashFunction
	// Maximum hash ring size. Defaults to 8M entries, and limited to 8M entries, but can be lowered
	// to further constrain resource use. See also
	// :ref:`minimum_ring_size<envoy_api_field_Cluster.RingHashLbConfig.minimum_ring_size>`.
	MaximumRingSize *wrapperspb.UInt64Value
	// contains filtered or unexported fields
}

func (Cluster_RingHashLbConfig_builder) Build

type Cluster_TransportSocketMatch

type Cluster_TransportSocketMatch struct {

	// The name of the match, used in stats generation.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Optional endpoint metadata match criteria.
	// The connection to the endpoint with metadata matching what is set in this field
	// will use the transport socket configuration specified here.
	// The endpoint's metadata entry in *envoy.transport_socket_match* is used to match
	// against the values specified in this field.
	Match *structpb.Struct `protobuf:"bytes,2,opt,name=match,proto3" json:"match,omitempty"`
	// The configuration of the transport socket.
	TransportSocket *core.TransportSocket `protobuf:"bytes,3,opt,name=transport_socket,json=transportSocket,proto3" json:"transport_socket,omitempty"`
	// contains filtered or unexported fields
}

TransportSocketMatch specifies what transport socket config will be used when the match conditions are satisfied.

func (*Cluster_TransportSocketMatch) ClearMatch

func (x *Cluster_TransportSocketMatch) ClearMatch()

func (*Cluster_TransportSocketMatch) ClearTransportSocket

func (x *Cluster_TransportSocketMatch) ClearTransportSocket()

func (*Cluster_TransportSocketMatch) GetMatch

func (*Cluster_TransportSocketMatch) GetName

func (x *Cluster_TransportSocketMatch) GetName() string

func (*Cluster_TransportSocketMatch) GetTransportSocket

func (x *Cluster_TransportSocketMatch) GetTransportSocket() *core.TransportSocket

func (*Cluster_TransportSocketMatch) HasMatch

func (x *Cluster_TransportSocketMatch) HasMatch() bool

func (*Cluster_TransportSocketMatch) HasTransportSocket

func (x *Cluster_TransportSocketMatch) HasTransportSocket() bool

func (*Cluster_TransportSocketMatch) ProtoMessage

func (*Cluster_TransportSocketMatch) ProtoMessage()

func (*Cluster_TransportSocketMatch) ProtoReflect

func (*Cluster_TransportSocketMatch) Reset

func (x *Cluster_TransportSocketMatch) Reset()

func (*Cluster_TransportSocketMatch) SetMatch

func (*Cluster_TransportSocketMatch) SetName

func (x *Cluster_TransportSocketMatch) SetName(v string)

func (*Cluster_TransportSocketMatch) SetTransportSocket

func (x *Cluster_TransportSocketMatch) SetTransportSocket(v *core.TransportSocket)

func (*Cluster_TransportSocketMatch) String

type Cluster_TransportSocketMatch_builder

type Cluster_TransportSocketMatch_builder struct {

	// The name of the match, used in stats generation.
	Name string
	// Optional endpoint metadata match criteria.
	// The connection to the endpoint with metadata matching what is set in this field
	// will use the transport socket configuration specified here.
	// The endpoint's metadata entry in *envoy.transport_socket_match* is used to match
	// against the values specified in this field.
	Match *structpb.Struct
	// The configuration of the transport socket.
	TransportSocket *core.TransportSocket
	// contains filtered or unexported fields
}

func (Cluster_TransportSocketMatch_builder) Build

type Cluster_Type

type Cluster_Type struct {
	// The :ref:`service discovery type <arch_overview_service_discovery_types>`
	// to use for resolving the cluster.
	Type Cluster_DiscoveryType `protobuf:"varint,2,opt,name=type,proto3,enum=envoy.api.v2.Cluster_DiscoveryType,oneof"`
}

type Cluster_builder

type Cluster_builder struct {

	// Configuration to use different transport sockets for different endpoints.
	// The entry of *envoy.transport_socket_match* in the
	// :ref:`LbEndpoint.Metadata <envoy_api_field_endpoint.LbEndpoint.metadata>`
	// is used to match against the transport sockets as they appear in the list. The first
	// :ref:`match <envoy_api_msg_Cluster.TransportSocketMatch>` is used.
	// For example, with the following match
	//
	// .. code-block:: yaml
	//
	//	transport_socket_matches:
	//	- name: "enableMTLS"
	//	  match:
	//	    acceptMTLS: true
	//	  transport_socket:
	//	    name: envoy.transport_sockets.tls
	//	    config: { ... } # tls socket configuration
	//	- name: "defaultToPlaintext"
	//	  match: {}
	//	  transport_socket:
	//	    name: envoy.transport_sockets.raw_buffer
	//
	// Connections to the endpoints whose metadata value under *envoy.transport_socket_match*
	// having "acceptMTLS"/"true" key/value pair use the "enableMTLS" socket configuration.
	//
	// If a :ref:`socket match <envoy_api_msg_Cluster.TransportSocketMatch>` with empty match
	// criteria is provided, that always match any endpoint. For example, the "defaultToPlaintext"
	// socket match in case above.
	//
	// If an endpoint metadata's value under *envoy.transport_socket_match* does not match any
	// *TransportSocketMatch*, socket configuration fallbacks to use the *tls_context* or
	// *transport_socket* specified in this cluster.
	//
	// This field allows gradual and flexible transport socket configuration changes.
	//
	// The metadata of endpoints in EDS can indicate transport socket capabilities. For example,
	// an endpoint's metadata can have two key value pairs as "acceptMTLS": "true",
	// "acceptPlaintext": "true". While some other endpoints, only accepting plaintext traffic
	// has "acceptPlaintext": "true" metadata information.
	//
	// Then the xDS server can configure the CDS to a client, Envoy A, to send mutual TLS
	// traffic for endpoints with "acceptMTLS": "true", by adding a corresponding
	// *TransportSocketMatch* in this field. Other client Envoys receive CDS without
	// *transport_socket_match* set, and still send plain text traffic to the same cluster.
	//
	// [#comment:TODO(incfly): add a detailed architecture doc on intended usage.]
	TransportSocketMatches []*Cluster_TransportSocketMatch
	// Supplies the name of the cluster which must be unique across all clusters.
	// The cluster name is used when emitting
	// :ref:`statistics <config_cluster_manager_cluster_stats>` if :ref:`alt_stat_name
	// <envoy_api_field_Cluster.alt_stat_name>` is not provided.
	// Any “:“ in the cluster name will be converted to “_“ when emitting statistics.
	Name string
	// An optional alternative to the cluster name to be used while emitting stats.
	// Any “:“ in the name will be converted to “_“ when emitting statistics. This should not be
	// confused with :ref:`Router Filter Header
	// <config_http_filters_router_x-envoy-upstream-alt-stat-name>`.
	AltStatName string
	// Fields of oneof ClusterDiscoveryType:
	// The :ref:`service discovery type <arch_overview_service_discovery_types>`
	// to use for resolving the cluster.
	Type *Cluster_DiscoveryType
	// The custom cluster type.
	ClusterType *Cluster_CustomClusterType
	// -- end of ClusterDiscoveryType
	// Configuration to use for EDS updates for the Cluster.
	EdsClusterConfig *Cluster_EdsClusterConfig
	// The timeout for new network connections to hosts in the cluster.
	ConnectTimeout *durationpb.Duration
	// Soft limit on size of the cluster’s connections read and write buffers. If
	// unspecified, an implementation defined default is applied (1MiB).
	PerConnectionBufferLimitBytes *wrapperspb.UInt32Value
	// The :ref:`load balancer type <arch_overview_load_balancing_types>` to use
	// when picking a host in the cluster.
	LbPolicy Cluster_LbPolicy
	// If the service discovery type is
	// :ref:`STATIC<envoy_api_enum_value_Cluster.DiscoveryType.STATIC>`,
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`,
	// then hosts is required.
	//
	// .. attention::
	//
	//	**This field is deprecated**. Set the
	//	:ref:`load_assignment<envoy_api_field_Cluster.load_assignment>` field instead.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	Hosts []*core.Address
	// Setting this is required for specifying members of
	// :ref:`STATIC<envoy_api_enum_value_Cluster.DiscoveryType.STATIC>`,
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>` clusters.
	// This field supersedes the *hosts* field in the v2 API.
	//
	// .. attention::
	//
	//	Setting this allows non-EDS cluster types to contain embedded EDS equivalent
	//	:ref:`endpoint assignments<envoy_api_msg_ClusterLoadAssignment>`.
	LoadAssignment *ClusterLoadAssignment
	// Optional :ref:`active health checking <arch_overview_health_checking>`
	// configuration for the cluster. If no
	// configuration is specified no health checking will be done and all cluster
	// members will be considered healthy at all times.
	HealthChecks []*core.HealthCheck
	// Optional maximum requests for a single upstream connection. This parameter
	// is respected by both the HTTP/1.1 and HTTP/2 connection pool
	// implementations. If not specified, there is no limit. Setting this
	// parameter to 1 will effectively disable keep alive.
	MaxRequestsPerConnection *wrapperspb.UInt32Value
	// Optional :ref:`circuit breaking <arch_overview_circuit_break>` for the cluster.
	CircuitBreakers *cluster.CircuitBreakers
	// The TLS configuration for connections to the upstream cluster.
	//
	// .. attention::
	//
	//	**This field is deprecated**. Use `transport_socket` with name `tls` instead. If both are
	//	set, `transport_socket` takes priority.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	TlsContext *auth.UpstreamTlsContext
	// HTTP protocol options that are applied only to upstream HTTP connections.
	// These options apply to all HTTP versions.
	UpstreamHttpProtocolOptions *core.UpstreamHttpProtocolOptions
	// Additional options when handling HTTP requests upstream. These options will be applicable to
	// both HTTP1 and HTTP2 requests.
	CommonHttpProtocolOptions *core.HttpProtocolOptions
	// Additional options when handling HTTP1 requests.
	HttpProtocolOptions *core.Http1ProtocolOptions
	// Even if default HTTP2 protocol options are desired, this field must be
	// set so that Envoy will assume that the upstream supports HTTP/2 when
	// making new HTTP connection pool connections. Currently, Envoy only
	// supports prior knowledge for upstream connections. Even if TLS is used
	// with ALPN, `http2_protocol_options` must be specified. As an aside this allows HTTP/2
	// connections to happen over plain text.
	Http2ProtocolOptions *core.Http2ProtocolOptions
	// The extension_protocol_options field is used to provide extension-specific protocol options
	// for upstream connections. The key should match the extension filter name, such as
	// "envoy.filters.network.thrift_proxy". See the extension's documentation for details on
	// specific options.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	ExtensionProtocolOptions map[string]*structpb.Struct
	// The extension_protocol_options field is used to provide extension-specific protocol options
	// for upstream connections. The key should match the extension filter name, such as
	// "envoy.filters.network.thrift_proxy". See the extension's documentation for details on
	// specific options.
	TypedExtensionProtocolOptions map[string]*anypb.Any
	// If the DNS refresh rate is specified and the cluster type is either
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`,
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`,
	// this value is used as the cluster’s DNS refresh
	// rate. The value configured must be at least 1ms. If this setting is not specified, the
	// value defaults to 5000ms. For cluster types other than
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`
	// and :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`
	// this setting is ignored.
	DnsRefreshRate *durationpb.Duration
	// If the DNS failure refresh rate is specified and the cluster type is either
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`,
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`,
	// this is used as the cluster’s DNS refresh rate when requests are failing. If this setting is
	// not specified, the failure refresh rate defaults to the DNS refresh rate. For cluster types
	// other than :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>` and
	// :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>` this setting is
	// ignored.
	DnsFailureRefreshRate *Cluster_RefreshRate
	// Optional configuration for setting cluster's DNS refresh rate. If the value is set to true,
	// cluster's DNS refresh rate will be set to resource record's TTL which comes from DNS
	// resolution.
	RespectDnsTtl bool
	// The DNS IP address resolution policy. If this setting is not specified, the
	// value defaults to
	// :ref:`AUTO<envoy_api_enum_value_Cluster.DnsLookupFamily.AUTO>`.
	DnsLookupFamily Cluster_DnsLookupFamily
	// If DNS resolvers are specified and the cluster type is either
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`,
	// or :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`,
	// this value is used to specify the cluster’s dns resolvers.
	// If this setting is not specified, the value defaults to the default
	// resolver, which uses /etc/resolv.conf for configuration. For cluster types
	// other than
	// :ref:`STRICT_DNS<envoy_api_enum_value_Cluster.DiscoveryType.STRICT_DNS>`
	// and :ref:`LOGICAL_DNS<envoy_api_enum_value_Cluster.DiscoveryType.LOGICAL_DNS>`
	// this setting is ignored.
	// Setting this value causes failure if the
	// “envoy.restart_features.use_apple_api_for_dns_lookups“ runtime value is true during
	// server startup. Apple's API only allows overriding DNS resolvers via system settings.
	DnsResolvers []*core.Address
	// [#next-major-version: Reconcile DNS options in a single message.]
	// Always use TCP queries instead of UDP queries for DNS lookups.
	// Setting this value causes failure if the
	// “envoy.restart_features.use_apple_api_for_dns_lookups“ runtime value is true during
	// server startup. Apple' API only uses UDP for DNS resolution.
	UseTcpForDnsLookups bool
	// If specified, outlier detection will be enabled for this upstream cluster.
	// Each of the configuration values can be overridden via
	// :ref:`runtime values <config_cluster_manager_cluster_runtime_outlier_detection>`.
	OutlierDetection *cluster.OutlierDetection
	// The interval for removing stale hosts from a cluster type
	// :ref:`ORIGINAL_DST<envoy_api_enum_value_Cluster.DiscoveryType.ORIGINAL_DST>`.
	// Hosts are considered stale if they have not been used
	// as upstream destinations during this interval. New hosts are added
	// to original destination clusters on demand as new connections are
	// redirected to Envoy, causing the number of hosts in the cluster to
	// grow over time. Hosts that are not stale (they are actively used as
	// destinations) are kept in the cluster, which allows connections to
	// them remain open, saving the latency that would otherwise be spent
	// on opening new connections. If this setting is not specified, the
	// value defaults to 5000ms. For cluster types other than
	// :ref:`ORIGINAL_DST<envoy_api_enum_value_Cluster.DiscoveryType.ORIGINAL_DST>`
	// this setting is ignored.
	CleanupInterval *durationpb.Duration
	// Optional configuration used to bind newly established upstream connections.
	// This overrides any bind_config specified in the bootstrap proto.
	// If the address and port are empty, no bind will be performed.
	UpstreamBindConfig *core.BindConfig
	// Configuration for load balancing subsetting.
	LbSubsetConfig *Cluster_LbSubsetConfig

	// Fields of oneof LbConfig:
	// Optional configuration for the Ring Hash load balancing policy.
	RingHashLbConfig *Cluster_RingHashLbConfig
	// Optional configuration for the Original Destination load balancing policy.
	OriginalDstLbConfig *Cluster_OriginalDstLbConfig
	// Optional configuration for the LeastRequest load balancing policy.
	LeastRequestLbConfig *Cluster_LeastRequestLbConfig
	// -- end of LbConfig
	// Common configuration for all load balancer implementations.
	CommonLbConfig *Cluster_CommonLbConfig
	// Optional custom transport socket implementation to use for upstream connections.
	// To setup TLS, set a transport socket with name `tls` and
	// :ref:`UpstreamTlsContexts <envoy_api_msg_auth.UpstreamTlsContext>` in the `typed_config`.
	// If no transport socket configuration is specified, new connections
	// will be set up with plaintext.
	TransportSocket *core.TransportSocket
	// The Metadata field can be used to provide additional information about the
	// cluster. It can be used for stats, logging, and varying filter behavior.
	// Fields should use reverse DNS notation to denote which entity within Envoy
	// will need the information. For instance, if the metadata is intended for
	// the Router filter, the filter name should be specified as *envoy.filters.http.router*.
	Metadata *core.Metadata
	// Determines how Envoy selects the protocol used to speak to upstream hosts.
	ProtocolSelection Cluster_ClusterProtocolSelection
	// Optional options for upstream connections.
	UpstreamConnectionOptions *UpstreamConnectionOptions
	// If an upstream host becomes unhealthy (as determined by the configured health checks
	// or outlier detection), immediately close all connections to the failed host.
	//
	// .. note::
	//
	//	This is currently only supported for connections created by tcp_proxy.
	//
	// .. note::
	//
	//	The current implementation of this feature closes all connections immediately when
	//	the unhealthy status is detected. If there are a large number of connections open
	//	to an upstream host that becomes unhealthy, Envoy may spend a substantial amount of
	//	time exclusively closing these connections, and not processing any other traffic.
	CloseConnectionsOnHostHealthFailure bool
	// If set to true, Envoy will ignore the health value of a host when processing its removal
	// from service discovery. This means that if active health checking is used, Envoy will *not*
	// wait for the endpoint to go unhealthy before removing it.
	DrainConnectionsOnHostRemoval bool
	// An (optional) network filter chain, listed in the order the filters should be applied.
	// The chain will be applied to all outgoing connections that Envoy makes to the upstream
	// servers of this cluster.
	Filters []*cluster.Filter
	// [#not-implemented-hide:] New mechanism for LB policy configuration. Used only if the
	// :ref:`lb_policy<envoy_api_field_Cluster.lb_policy>` field has the value
	// :ref:`LOAD_BALANCING_POLICY_CONFIG<envoy_api_enum_value_Cluster.LbPolicy.LOAD_BALANCING_POLICY_CONFIG>`.
	LoadBalancingPolicy *LoadBalancingPolicy
	// [#not-implemented-hide:]
	// If present, tells the client where to send load reports via LRS. If not present, the
	// client will fall back to a client-side default, which may be either (a) don't send any
	// load reports or (b) send load reports for all clusters to a single default server
	// (which may be configured in the bootstrap file).
	//
	// Note that if multiple clusters point to the same LRS server, the client may choose to
	// create a separate stream for each cluster or it may choose to coalesce the data for
	// multiple clusters onto a single stream. Either way, the client must make sure to send
	// the data for any given cluster on no more than one stream.
	//
	// [#next-major-version: In the v3 API, we should consider restructuring this somehow,
	// maybe by allowing LRS to go on the ADS stream, or maybe by moving some of the negotiation
	// from the LRS stream here.]
	LrsServer *core.ConfigSource
	// If track_timeout_budgets is true, the :ref:`timeout budget histograms
	// <config_cluster_manager_cluster_stats_timeout_budgets>` will be published for each
	// request. These show what percentage of a request's per try and global timeout was used. A value
	// of 0 would indicate that none of the timeout was used or that the timeout was infinite. A value
	// of 100 would indicate that the request took the entirety of the timeout given to it.
	TrackTimeoutBudgets bool
	// contains filtered or unexported fields
}

func (Cluster_builder) Build

func (b0 Cluster_builder) Build() *Cluster

type DeltaDiscoveryRequest

type DeltaDiscoveryRequest struct {

	// The node making the request.
	Node *core.Node `protobuf:"bytes,1,opt,name=node,proto3" json:"node,omitempty"`
	// Type of the resource that is being requested, e.g.
	// "type.googleapis.com/envoy.api.v2.ClusterLoadAssignment".
	TypeUrl string `protobuf:"bytes,2,opt,name=type_url,json=typeUrl,proto3" json:"type_url,omitempty"`
	// DeltaDiscoveryRequests allow the client to add or remove individual
	// resources to the set of tracked resources in the context of a stream.
	// All resource names in the resource_names_subscribe list are added to the
	// set of tracked resources and all resource names in the resource_names_unsubscribe
	// list are removed from the set of tracked resources.
	//
	// *Unlike* state-of-the-world xDS, an empty resource_names_subscribe or
	// resource_names_unsubscribe list simply means that no resources are to be
	// added or removed to the resource list.
	// *Like* state-of-the-world xDS, the server must send updates for all tracked
	// resources, but can also send updates for resources the client has not subscribed to.
	//
	// NOTE: the server must respond with all resources listed in resource_names_subscribe,
	// even if it believes the client has the most recent version of them. The reason:
	// the client may have dropped them, but then regained interest before it had a chance
	// to send the unsubscribe message. See DeltaSubscriptionStateTest.RemoveThenAdd.
	//
	// These two fields can be set in any DeltaDiscoveryRequest, including ACKs
	// and initial_resource_versions.
	//
	// A list of Resource names to add to the list of tracked resources.
	ResourceNamesSubscribe []string `` /* 129-byte string literal not displayed */
	// A list of Resource names to remove from the list of tracked resources.
	ResourceNamesUnsubscribe []string `` /* 135-byte string literal not displayed */
	// Informs the server of the versions of the resources the xDS client knows of, to enable the
	// client to continue the same logical xDS session even in the face of gRPC stream reconnection.
	// It will not be populated: [1] in the very first stream of a session, since the client will
	// not yet have any resources,  [2] in any message after the first in a stream (for a given
	// type_url), since the server will already be correctly tracking the client's state.
	// (In ADS, the first message *of each type_url* of a reconnected stream populates this map.)
	// The map's keys are names of xDS resources known to the xDS client.
	// The map's values are opaque resource versions.
	InitialResourceVersions map[string]string `` /* 206-byte string literal not displayed */
	// When the DeltaDiscoveryRequest is a ACK or NACK message in response
	// to a previous DeltaDiscoveryResponse, the response_nonce must be the
	// nonce in the DeltaDiscoveryResponse.
	// Otherwise (unlike in DiscoveryRequest) response_nonce must be omitted.
	ResponseNonce string `protobuf:"bytes,6,opt,name=response_nonce,json=responseNonce,proto3" json:"response_nonce,omitempty"`
	// This is populated when the previous :ref:`DiscoveryResponse <envoy_api_msg_DiscoveryResponse>`
	// failed to update configuration. The *message* field in *error_details*
	// provides the Envoy internal exception related to the failure.
	ErrorDetail *status.Status `protobuf:"bytes,7,opt,name=error_detail,json=errorDetail,proto3" json:"error_detail,omitempty"`
	// contains filtered or unexported fields
}

DeltaDiscoveryRequest and DeltaDiscoveryResponse are used in a new gRPC endpoint for Delta xDS.

With Delta xDS, the DeltaDiscoveryResponses do not need to include a full snapshot of the tracked resources. Instead, DeltaDiscoveryResponses are a diff to the state of a xDS client. In Delta XDS there are per-resource versions, which allow tracking state at the resource granularity. An xDS Delta session is always in the context of a gRPC bidirectional stream. This allows the xDS server to keep track of the state of xDS clients connected to it.

In Delta xDS the nonce field is required and used to pair DeltaDiscoveryResponse to a DeltaDiscoveryRequest ACK or NACK. Optionally, a response message level system_version_info is present for debugging purposes only.

DeltaDiscoveryRequest plays two independent roles. Any DeltaDiscoveryRequest can be either or both of: [1] informing the server of what resources the client has gained/lost interest in (using resource_names_subscribe and resource_names_unsubscribe), or [2] (N)ACKing an earlier resource update from the server (using response_nonce, with presence of error_detail making it a NACK). Additionally, the first message (for a given type_url) of a reconnected gRPC stream has a third role: informing the server of the resources (and their versions) that the client already possesses, using the initial_resource_versions field.

As with state-of-the-world, when multiple resource types are multiplexed (ADS), all requests/acknowledgments/updates are logically walled off by type_url: a Cluster ACK exists in a completely separate world from a prior Route NACK. In particular, initial_resource_versions being sent at the "start" of every gRPC stream actually entails a message for each type_url, each with its own initial_resource_versions. [#next-free-field: 8]

func (*DeltaDiscoveryRequest) ClearErrorDetail

func (x *DeltaDiscoveryRequest) ClearErrorDetail()

func (*DeltaDiscoveryRequest) ClearNode

func (x *DeltaDiscoveryRequest) ClearNode()

func (*DeltaDiscoveryRequest) GetErrorDetail

func (x *DeltaDiscoveryRequest) GetErrorDetail() *status.Status

func (*DeltaDiscoveryRequest) GetInitialResourceVersions

func (x *DeltaDiscoveryRequest) GetInitialResourceVersions() map[string]string

func (*DeltaDiscoveryRequest) GetNode

func (x *DeltaDiscoveryRequest) GetNode() *core.Node

func (*DeltaDiscoveryRequest) GetResourceNamesSubscribe

func (x *DeltaDiscoveryRequest) GetResourceNamesSubscribe() []string

func (*DeltaDiscoveryRequest) GetResourceNamesUnsubscribe

func (x *DeltaDiscoveryRequest) GetResourceNamesUnsubscribe() []string

func (*DeltaDiscoveryRequest) GetResponseNonce

func (x *DeltaDiscoveryRequest) GetResponseNonce() string

func (*DeltaDiscoveryRequest) GetTypeUrl

func (x *DeltaDiscoveryRequest) GetTypeUrl() string

func (*DeltaDiscoveryRequest) HasErrorDetail

func (x *DeltaDiscoveryRequest) HasErrorDetail() bool

func (*DeltaDiscoveryRequest) HasNode

func (x *DeltaDiscoveryRequest) HasNode() bool

func (*DeltaDiscoveryRequest) ProtoMessage

func (*DeltaDiscoveryRequest) ProtoMessage()

func (*DeltaDiscoveryRequest) ProtoReflect

func (x *DeltaDiscoveryRequest) ProtoReflect() protoreflect.Message

func (*DeltaDiscoveryRequest) Reset

func (x *DeltaDiscoveryRequest) Reset()

func (*DeltaDiscoveryRequest) SetErrorDetail

func (x *DeltaDiscoveryRequest) SetErrorDetail(v *status.Status)

func (*DeltaDiscoveryRequest) SetInitialResourceVersions

func (x *DeltaDiscoveryRequest) SetInitialResourceVersions(v map[string]string)

func (*DeltaDiscoveryRequest) SetNode

func (x *DeltaDiscoveryRequest) SetNode(v *core.Node)

func (*DeltaDiscoveryRequest) SetResourceNamesSubscribe

func (x *DeltaDiscoveryRequest) SetResourceNamesSubscribe(v []string)

func (*DeltaDiscoveryRequest) SetResourceNamesUnsubscribe

func (x *DeltaDiscoveryRequest) SetResourceNamesUnsubscribe(v []string)

func (*DeltaDiscoveryRequest) SetResponseNonce

func (x *DeltaDiscoveryRequest) SetResponseNonce(v string)

func (*DeltaDiscoveryRequest) SetTypeUrl

func (x *DeltaDiscoveryRequest) SetTypeUrl(v string)

func (*DeltaDiscoveryRequest) String

func (x *DeltaDiscoveryRequest) String() string

type DeltaDiscoveryRequest_builder

type DeltaDiscoveryRequest_builder struct {

	// The node making the request.
	Node *core.Node
	// Type of the resource that is being requested, e.g.
	// "type.googleapis.com/envoy.api.v2.ClusterLoadAssignment".
	TypeUrl string
	// DeltaDiscoveryRequests allow the client to add or remove individual
	// resources to the set of tracked resources in the context of a stream.
	// All resource names in the resource_names_subscribe list are added to the
	// set of tracked resources and all resource names in the resource_names_unsubscribe
	// list are removed from the set of tracked resources.
	//
	// *Unlike* state-of-the-world xDS, an empty resource_names_subscribe or
	// resource_names_unsubscribe list simply means that no resources are to be
	// added or removed to the resource list.
	// *Like* state-of-the-world xDS, the server must send updates for all tracked
	// resources, but can also send updates for resources the client has not subscribed to.
	//
	// NOTE: the server must respond with all resources listed in resource_names_subscribe,
	// even if it believes the client has the most recent version of them. The reason:
	// the client may have dropped them, but then regained interest before it had a chance
	// to send the unsubscribe message. See DeltaSubscriptionStateTest.RemoveThenAdd.
	//
	// These two fields can be set in any DeltaDiscoveryRequest, including ACKs
	// and initial_resource_versions.
	//
	// A list of Resource names to add to the list of tracked resources.
	ResourceNamesSubscribe []string
	// A list of Resource names to remove from the list of tracked resources.
	ResourceNamesUnsubscribe []string
	// Informs the server of the versions of the resources the xDS client knows of, to enable the
	// client to continue the same logical xDS session even in the face of gRPC stream reconnection.
	// It will not be populated: [1] in the very first stream of a session, since the client will
	// not yet have any resources,  [2] in any message after the first in a stream (for a given
	// type_url), since the server will already be correctly tracking the client's state.
	// (In ADS, the first message *of each type_url* of a reconnected stream populates this map.)
	// The map's keys are names of xDS resources known to the xDS client.
	// The map's values are opaque resource versions.
	InitialResourceVersions map[string]string
	// When the DeltaDiscoveryRequest is a ACK or NACK message in response
	// to a previous DeltaDiscoveryResponse, the response_nonce must be the
	// nonce in the DeltaDiscoveryResponse.
	// Otherwise (unlike in DiscoveryRequest) response_nonce must be omitted.
	ResponseNonce string
	// This is populated when the previous :ref:`DiscoveryResponse <envoy_api_msg_DiscoveryResponse>`
	// failed to update configuration. The *message* field in *error_details*
	// provides the Envoy internal exception related to the failure.
	ErrorDetail *status.Status
	// contains filtered or unexported fields
}

func (DeltaDiscoveryRequest_builder) Build

type DeltaDiscoveryResponse

type DeltaDiscoveryResponse struct {

	// The version of the response data (used for debugging).
	SystemVersionInfo string `protobuf:"bytes,1,opt,name=system_version_info,json=systemVersionInfo,proto3" json:"system_version_info,omitempty"`
	// The response resources. These are typed resources, whose types must match
	// the type_url field.
	Resources []*Resource `protobuf:"bytes,2,rep,name=resources,proto3" json:"resources,omitempty"`
	// Type URL for resources. Identifies the xDS API when muxing over ADS.
	// Must be consistent with the type_url in the Any within 'resources' if 'resources' is non-empty.
	TypeUrl string `protobuf:"bytes,4,opt,name=type_url,json=typeUrl,proto3" json:"type_url,omitempty"`
	// Resources names of resources that have be deleted and to be removed from the xDS Client.
	// Removed resources for missing resources can be ignored.
	RemovedResources []string `protobuf:"bytes,6,rep,name=removed_resources,json=removedResources,proto3" json:"removed_resources,omitempty"`
	// The nonce provides a way for DeltaDiscoveryRequests to uniquely
	// reference a DeltaDiscoveryResponse when (N)ACKing. The nonce is required.
	Nonce string `protobuf:"bytes,5,opt,name=nonce,proto3" json:"nonce,omitempty"`
	// contains filtered or unexported fields
}

[#next-free-field: 7]

func (*DeltaDiscoveryResponse) GetNonce

func (x *DeltaDiscoveryResponse) GetNonce() string

func (*DeltaDiscoveryResponse) GetRemovedResources

func (x *DeltaDiscoveryResponse) GetRemovedResources() []string

func (*DeltaDiscoveryResponse) GetResources

func (x *DeltaDiscoveryResponse) GetResources() []*Resource

func (*DeltaDiscoveryResponse) GetSystemVersionInfo

func (x *DeltaDiscoveryResponse) GetSystemVersionInfo() string

func (*DeltaDiscoveryResponse) GetTypeUrl

func (x *DeltaDiscoveryResponse) GetTypeUrl() string

func (*DeltaDiscoveryResponse) ProtoMessage

func (*DeltaDiscoveryResponse) ProtoMessage()

func (*DeltaDiscoveryResponse) ProtoReflect

func (x *DeltaDiscoveryResponse) ProtoReflect() protoreflect.Message

func (*DeltaDiscoveryResponse) Reset

func (x *DeltaDiscoveryResponse) Reset()

func (*DeltaDiscoveryResponse) SetNonce

func (x *DeltaDiscoveryResponse) SetNonce(v string)

func (*DeltaDiscoveryResponse) SetRemovedResources

func (x *DeltaDiscoveryResponse) SetRemovedResources(v []string)

func (*DeltaDiscoveryResponse) SetResources

func (x *DeltaDiscoveryResponse) SetResources(v []*Resource)

func (*DeltaDiscoveryResponse) SetSystemVersionInfo

func (x *DeltaDiscoveryResponse) SetSystemVersionInfo(v string)

func (*DeltaDiscoveryResponse) SetTypeUrl

func (x *DeltaDiscoveryResponse) SetTypeUrl(v string)

func (*DeltaDiscoveryResponse) String

func (x *DeltaDiscoveryResponse) String() string

type DeltaDiscoveryResponse_builder

type DeltaDiscoveryResponse_builder struct {

	// The version of the response data (used for debugging).
	SystemVersionInfo string
	// The response resources. These are typed resources, whose types must match
	// the type_url field.
	Resources []*Resource
	// Type URL for resources. Identifies the xDS API when muxing over ADS.
	// Must be consistent with the type_url in the Any within 'resources' if 'resources' is non-empty.
	TypeUrl string
	// Resources names of resources that have be deleted and to be removed from the xDS Client.
	// Removed resources for missing resources can be ignored.
	RemovedResources []string
	// The nonce provides a way for DeltaDiscoveryRequests to uniquely
	// reference a DeltaDiscoveryResponse when (N)ACKing. The nonce is required.
	Nonce string
	// contains filtered or unexported fields
}

func (DeltaDiscoveryResponse_builder) Build

type DiscoveryRequest

type DiscoveryRequest struct {

	// The version_info provided in the request messages will be the version_info
	// received with the most recent successfully processed response or empty on
	// the first request. It is expected that no new request is sent after a
	// response is received until the Envoy instance is ready to ACK/NACK the new
	// configuration. ACK/NACK takes place by returning the new API config version
	// as applied or the previous API config version respectively. Each type_url
	// (see below) has an independent version associated with it.
	VersionInfo string `protobuf:"bytes,1,opt,name=version_info,json=versionInfo,proto3" json:"version_info,omitempty"`
	// The node making the request.
	Node *core.Node `protobuf:"bytes,2,opt,name=node,proto3" json:"node,omitempty"`
	// List of resources to subscribe to, e.g. list of cluster names or a route
	// configuration name. If this is empty, all resources for the API are
	// returned. LDS/CDS may have empty resource_names, which will cause all
	// resources for the Envoy instance to be returned. The LDS and CDS responses
	// will then imply a number of resources that need to be fetched via EDS/RDS,
	// which will be explicitly enumerated in resource_names.
	ResourceNames []string `protobuf:"bytes,3,rep,name=resource_names,json=resourceNames,proto3" json:"resource_names,omitempty"`
	// Type of the resource that is being requested, e.g.
	// "type.googleapis.com/envoy.api.v2.ClusterLoadAssignment". This is implicit
	// in requests made via singleton xDS APIs such as CDS, LDS, etc. but is
	// required for ADS.
	TypeUrl string `protobuf:"bytes,4,opt,name=type_url,json=typeUrl,proto3" json:"type_url,omitempty"`
	// nonce corresponding to DiscoveryResponse being ACK/NACKed. See above
	// discussion on version_info and the DiscoveryResponse nonce comment. This
	// may be empty only if 1) this is a non-persistent-stream xDS such as HTTP,
	// or 2) the client has not yet accepted an update in this xDS stream (unlike
	// delta, where it is populated only for new explicit ACKs).
	ResponseNonce string `protobuf:"bytes,5,opt,name=response_nonce,json=responseNonce,proto3" json:"response_nonce,omitempty"`
	// This is populated when the previous :ref:`DiscoveryResponse <envoy_api_msg_DiscoveryResponse>`
	// failed to update configuration. The *message* field in *error_details* provides the Envoy
	// internal exception related to the failure. It is only intended for consumption during manual
	// debugging, the string provided is not guaranteed to be stable across Envoy versions.
	ErrorDetail *status.Status `protobuf:"bytes,6,opt,name=error_detail,json=errorDetail,proto3" json:"error_detail,omitempty"`
	// contains filtered or unexported fields
}

A DiscoveryRequest requests a set of versioned resources of the same type for a given Envoy node on some API. [#next-free-field: 7]

func (*DiscoveryRequest) ClearErrorDetail

func (x *DiscoveryRequest) ClearErrorDetail()

func (*DiscoveryRequest) ClearNode

func (x *DiscoveryRequest) ClearNode()

func (*DiscoveryRequest) GetErrorDetail

func (x *DiscoveryRequest) GetErrorDetail() *status.Status

func (*DiscoveryRequest) GetNode

func (x *DiscoveryRequest) GetNode() *core.Node

func (*DiscoveryRequest) GetResourceNames

func (x *DiscoveryRequest) GetResourceNames() []string

func (*DiscoveryRequest) GetResponseNonce

func (x *DiscoveryRequest) GetResponseNonce() string

func (*DiscoveryRequest) GetTypeUrl

func (x *DiscoveryRequest) GetTypeUrl() string

func (*DiscoveryRequest) GetVersionInfo

func (x *DiscoveryRequest) GetVersionInfo() string

func (*DiscoveryRequest) HasErrorDetail

func (x *DiscoveryRequest) HasErrorDetail() bool

func (*DiscoveryRequest) HasNode

func (x *DiscoveryRequest) HasNode() bool

func (*DiscoveryRequest) ProtoMessage

func (*DiscoveryRequest) ProtoMessage()

func (*DiscoveryRequest) ProtoReflect

func (x *DiscoveryRequest) ProtoReflect() protoreflect.Message

func (*DiscoveryRequest) Reset

func (x *DiscoveryRequest) Reset()

func (*DiscoveryRequest) SetErrorDetail

func (x *DiscoveryRequest) SetErrorDetail(v *status.Status)

func (*DiscoveryRequest) SetNode

func (x *DiscoveryRequest) SetNode(v *core.Node)

func (*DiscoveryRequest) SetResourceNames

func (x *DiscoveryRequest) SetResourceNames(v []string)

func (*DiscoveryRequest) SetResponseNonce

func (x *DiscoveryRequest) SetResponseNonce(v string)

func (*DiscoveryRequest) SetTypeUrl

func (x *DiscoveryRequest) SetTypeUrl(v string)

func (*DiscoveryRequest) SetVersionInfo

func (x *DiscoveryRequest) SetVersionInfo(v string)

func (*DiscoveryRequest) String

func (x *DiscoveryRequest) String() string

type DiscoveryRequest_builder

type DiscoveryRequest_builder struct {

	// The version_info provided in the request messages will be the version_info
	// received with the most recent successfully processed response or empty on
	// the first request. It is expected that no new request is sent after a
	// response is received until the Envoy instance is ready to ACK/NACK the new
	// configuration. ACK/NACK takes place by returning the new API config version
	// as applied or the previous API config version respectively. Each type_url
	// (see below) has an independent version associated with it.
	VersionInfo string
	// The node making the request.
	Node *core.Node
	// List of resources to subscribe to, e.g. list of cluster names or a route
	// configuration name. If this is empty, all resources for the API are
	// returned. LDS/CDS may have empty resource_names, which will cause all
	// resources for the Envoy instance to be returned. The LDS and CDS responses
	// will then imply a number of resources that need to be fetched via EDS/RDS,
	// which will be explicitly enumerated in resource_names.
	ResourceNames []string
	// Type of the resource that is being requested, e.g.
	// "type.googleapis.com/envoy.api.v2.ClusterLoadAssignment". This is implicit
	// in requests made via singleton xDS APIs such as CDS, LDS, etc. but is
	// required for ADS.
	TypeUrl string
	// nonce corresponding to DiscoveryResponse being ACK/NACKed. See above
	// discussion on version_info and the DiscoveryResponse nonce comment. This
	// may be empty only if 1) this is a non-persistent-stream xDS such as HTTP,
	// or 2) the client has not yet accepted an update in this xDS stream (unlike
	// delta, where it is populated only for new explicit ACKs).
	ResponseNonce string
	// This is populated when the previous :ref:`DiscoveryResponse <envoy_api_msg_DiscoveryResponse>`
	// failed to update configuration. The *message* field in *error_details* provides the Envoy
	// internal exception related to the failure. It is only intended for consumption during manual
	// debugging, the string provided is not guaranteed to be stable across Envoy versions.
	ErrorDetail *status.Status
	// contains filtered or unexported fields
}

func (DiscoveryRequest_builder) Build

type DiscoveryResponse

type DiscoveryResponse struct {

	// The version of the response data.
	VersionInfo string `protobuf:"bytes,1,opt,name=version_info,json=versionInfo,proto3" json:"version_info,omitempty"`
	// The response resources. These resources are typed and depend on the API being called.
	Resources []*anypb.Any `protobuf:"bytes,2,rep,name=resources,proto3" json:"resources,omitempty"`
	// [#not-implemented-hide:]
	// Canary is used to support two Envoy command line flags:
	//
	//   - --terminate-on-canary-transition-failure. When set, Envoy is able to
	//     terminate if it detects that configuration is stuck at canary. Consider
	//     this example sequence of updates:
	//   - Management server applies a canary config successfully.
	//   - Management server rolls back to a production config.
	//   - Envoy rejects the new production config.
	//     Since there is no sensible way to continue receiving configuration
	//     updates, Envoy will then terminate and apply production config from a
	//     clean slate.
	//   - --dry-run-canary. When set, a canary response will never be applied, only
	//     validated via a dry run.
	Canary bool `protobuf:"varint,3,opt,name=canary,proto3" json:"canary,omitempty"`
	// Type URL for resources. Identifies the xDS API when muxing over ADS.
	// Must be consistent with the type_url in the 'resources' repeated Any (if non-empty).
	TypeUrl string `protobuf:"bytes,4,opt,name=type_url,json=typeUrl,proto3" json:"type_url,omitempty"`
	// For gRPC based subscriptions, the nonce provides a way to explicitly ack a
	// specific DiscoveryResponse in a following DiscoveryRequest. Additional
	// messages may have been sent by Envoy to the management server for the
	// previous version on the stream prior to this DiscoveryResponse, that were
	// unprocessed at response send time. The nonce allows the management server
	// to ignore any further DiscoveryRequests for the previous version until a
	// DiscoveryRequest bearing the nonce. The nonce is optional and is not
	// required for non-stream based xDS implementations.
	Nonce string `protobuf:"bytes,5,opt,name=nonce,proto3" json:"nonce,omitempty"`
	// [#not-implemented-hide:]
	// The control plane instance that sent the response.
	ControlPlane *core.ControlPlane `protobuf:"bytes,6,opt,name=control_plane,json=controlPlane,proto3" json:"control_plane,omitempty"`
	// contains filtered or unexported fields
}

[#next-free-field: 7]

func (*DiscoveryResponse) ClearControlPlane

func (x *DiscoveryResponse) ClearControlPlane()

func (*DiscoveryResponse) GetCanary

func (x *DiscoveryResponse) GetCanary() bool

func (*DiscoveryResponse) GetControlPlane

func (x *DiscoveryResponse) GetControlPlane() *core.ControlPlane

func (*DiscoveryResponse) GetNonce

func (x *DiscoveryResponse) GetNonce() string

func (*DiscoveryResponse) GetResources

func (x *DiscoveryResponse) GetResources() []*anypb.Any

func (*DiscoveryResponse) GetTypeUrl

func (x *DiscoveryResponse) GetTypeUrl() string

func (*DiscoveryResponse) GetVersionInfo

func (x *DiscoveryResponse) GetVersionInfo() string

func (*DiscoveryResponse) HasControlPlane

func (x *DiscoveryResponse) HasControlPlane() bool

func (*DiscoveryResponse) ProtoMessage

func (*DiscoveryResponse) ProtoMessage()

func (*DiscoveryResponse) ProtoReflect

func (x *DiscoveryResponse) ProtoReflect() protoreflect.Message

func (*DiscoveryResponse) Reset

func (x *DiscoveryResponse) Reset()

func (*DiscoveryResponse) SetCanary

func (x *DiscoveryResponse) SetCanary(v bool)

func (*DiscoveryResponse) SetControlPlane

func (x *DiscoveryResponse) SetControlPlane(v *core.ControlPlane)

func (*DiscoveryResponse) SetNonce

func (x *DiscoveryResponse) SetNonce(v string)

func (*DiscoveryResponse) SetResources

func (x *DiscoveryResponse) SetResources(v []*anypb.Any)

func (*DiscoveryResponse) SetTypeUrl

func (x *DiscoveryResponse) SetTypeUrl(v string)

func (*DiscoveryResponse) SetVersionInfo

func (x *DiscoveryResponse) SetVersionInfo(v string)

func (*DiscoveryResponse) String

func (x *DiscoveryResponse) String() string

type DiscoveryResponse_builder

type DiscoveryResponse_builder struct {

	// The version of the response data.
	VersionInfo string
	// The response resources. These resources are typed and depend on the API being called.
	Resources []*anypb.Any
	// [#not-implemented-hide:]
	// Canary is used to support two Envoy command line flags:
	//
	//   - --terminate-on-canary-transition-failure. When set, Envoy is able to
	//     terminate if it detects that configuration is stuck at canary. Consider
	//     this example sequence of updates:
	//   - Management server applies a canary config successfully.
	//   - Management server rolls back to a production config.
	//   - Envoy rejects the new production config.
	//     Since there is no sensible way to continue receiving configuration
	//     updates, Envoy will then terminate and apply production config from a
	//     clean slate.
	//   - --dry-run-canary. When set, a canary response will never be applied, only
	//     validated via a dry run.
	Canary bool
	// Type URL for resources. Identifies the xDS API when muxing over ADS.
	// Must be consistent with the type_url in the 'resources' repeated Any (if non-empty).
	TypeUrl string
	// For gRPC based subscriptions, the nonce provides a way to explicitly ack a
	// specific DiscoveryResponse in a following DiscoveryRequest. Additional
	// messages may have been sent by Envoy to the management server for the
	// previous version on the stream prior to this DiscoveryResponse, that were
	// unprocessed at response send time. The nonce allows the management server
	// to ignore any further DiscoveryRequests for the previous version until a
	// DiscoveryRequest bearing the nonce. The nonce is optional and is not
	// required for non-stream based xDS implementations.
	Nonce string
	// [#not-implemented-hide:]
	// The control plane instance that sent the response.
	ControlPlane *core.ControlPlane
	// contains filtered or unexported fields
}

func (DiscoveryResponse_builder) Build

type EdsDummy

type EdsDummy struct {
	// contains filtered or unexported fields
}

[#not-implemented-hide:] Not configuration. Workaround c++ protobuf issue with importing services: https://github.com/google/protobuf/issues/4221 and protoxform to upgrade the file.

func (*EdsDummy) ProtoMessage

func (*EdsDummy) ProtoMessage()

func (*EdsDummy) ProtoReflect

func (x *EdsDummy) ProtoReflect() protoreflect.Message

func (*EdsDummy) Reset

func (x *EdsDummy) Reset()

func (*EdsDummy) String

func (x *EdsDummy) String() string

type EdsDummy_builder

type EdsDummy_builder struct {
	// contains filtered or unexported fields
}

func (EdsDummy_builder) Build

func (b0 EdsDummy_builder) Build() *EdsDummy

type LdsDummy

type LdsDummy struct {
	// contains filtered or unexported fields
}

[#not-implemented-hide:] Not configuration. Workaround c++ protobuf issue with importing services: https://github.com/google/protobuf/issues/4221 and protoxform to upgrade the file.

func (*LdsDummy) ProtoMessage

func (*LdsDummy) ProtoMessage()

func (*LdsDummy) ProtoReflect

func (x *LdsDummy) ProtoReflect() protoreflect.Message

func (*LdsDummy) Reset

func (x *LdsDummy) Reset()

func (*LdsDummy) String

func (x *LdsDummy) String() string

type LdsDummy_builder

type LdsDummy_builder struct {
	// contains filtered or unexported fields
}

func (LdsDummy_builder) Build

func (b0 LdsDummy_builder) Build() *LdsDummy

type Listener

type Listener struct {

	// The unique name by which this listener is known. If no name is provided,
	// Envoy will allocate an internal UUID for the listener. If the listener is to be dynamically
	// updated or removed via :ref:`LDS <config_listeners_lds>` a unique name must be provided.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// The address that the listener should listen on. In general, the address must be unique, though
	// that is governed by the bind rules of the OS. E.g., multiple listeners can listen on port 0 on
	// Linux as the actual port will be allocated by the OS.
	Address *core.Address `protobuf:"bytes,2,opt,name=address,proto3" json:"address,omitempty"`
	// A list of filter chains to consider for this listener. The
	// :ref:`FilterChain <envoy_api_msg_listener.FilterChain>` with the most specific
	// :ref:`FilterChainMatch <envoy_api_msg_listener.FilterChainMatch>` criteria is used on a
	// connection.
	//
	// Example using SNI for filter chain selection can be found in the
	// :ref:`FAQ entry <faq_how_to_setup_sni>`.
	FilterChains []*listener.FilterChain `protobuf:"bytes,3,rep,name=filter_chains,json=filterChains,proto3" json:"filter_chains,omitempty"`
	// If a connection is redirected using *iptables*, the port on which the proxy
	// receives it might be different from the original destination address. When this flag is set to
	// true, the listener hands off redirected connections to the listener associated with the
	// original destination address. If there is no listener associated with the original destination
	// address, the connection is handled by the listener that receives it. Defaults to false.
	//
	// .. attention::
	//
	//	This field is deprecated. Use :ref:`an original_dst <config_listener_filters_original_dst>`
	//	:ref:`listener filter <envoy_api_field_Listener.listener_filters>` instead.
	//
	//	Note that hand off to another listener is *NOT* performed without this flag. Once
	//	:ref:`FilterChainMatch <envoy_api_msg_listener.FilterChainMatch>` is implemented this flag
	//	will be removed, as filter chain matching can be used to select a filter chain based on the
	//	restored destination address.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/listener.proto.
	UseOriginalDst *wrapperspb.BoolValue `protobuf:"bytes,4,opt,name=use_original_dst,json=useOriginalDst,proto3" json:"use_original_dst,omitempty"`
	// Soft limit on size of the listener’s new connection read and write buffers.
	// If unspecified, an implementation defined default is applied (1MiB).
	PerConnectionBufferLimitBytes *wrapperspb.UInt32Value `` /* 154-byte string literal not displayed */
	// Listener metadata.
	Metadata *core.Metadata `protobuf:"bytes,6,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// [#not-implemented-hide:]
	DeprecatedV1 *Listener_DeprecatedV1 `protobuf:"bytes,7,opt,name=deprecated_v1,json=deprecatedV1,proto3" json:"deprecated_v1,omitempty"`
	// The type of draining to perform at a listener-wide level.
	DrainType Listener_DrainType `` /* 126-byte string literal not displayed */
	// Listener filters have the opportunity to manipulate and augment the connection metadata that
	// is used in connection filter chain matching, for example. These filters are run before any in
	// :ref:`filter_chains <envoy_api_field_Listener.filter_chains>`. Order matters as the
	// filters are processed sequentially right after a socket has been accepted by the listener, and
	// before a connection is created.
	// UDP Listener filters can be specified when the protocol in the listener socket address in
	// :ref:`protocol <envoy_api_field_core.SocketAddress.protocol>` is :ref:`UDP
	// <envoy_api_enum_value_core.SocketAddress.Protocol.UDP>`.
	// UDP listeners currently support a single filter.
	ListenerFilters []*listener.ListenerFilter `protobuf:"bytes,9,rep,name=listener_filters,json=listenerFilters,proto3" json:"listener_filters,omitempty"`
	// The timeout to wait for all listener filters to complete operation. If the timeout is reached,
	// the accepted socket is closed without a connection being created unless
	// `continue_on_listener_filters_timeout` is set to true. Specify 0 to disable the
	// timeout. If not specified, a default timeout of 15s is used.
	ListenerFiltersTimeout *durationpb.Duration `` /* 130-byte string literal not displayed */
	// Whether a connection should be created when listener filters timeout. Default is false.
	//
	// .. attention::
	//
	//	Some listener filters, such as :ref:`Proxy Protocol filter
	//	<config_listener_filters_proxy_protocol>`, should not be used with this option. It will cause
	//	unexpected behavior when a connection is created.
	ContinueOnListenerFiltersTimeout bool `` /* 165-byte string literal not displayed */
	// Whether the listener should be set as a transparent socket.
	// When this flag is set to true, connections can be redirected to the listener using an
	// *iptables* *TPROXY* target, in which case the original source and destination addresses and
	// ports are preserved on accepted connections. This flag should be used in combination with
	// :ref:`an original_dst <config_listener_filters_original_dst>` :ref:`listener filter
	// <envoy_api_field_Listener.listener_filters>` to mark the connections' local addresses as
	// "restored." This can be used to hand off each redirected connection to another listener
	// associated with the connection's destination address. Direct connections to the socket without
	// using *TPROXY* cannot be distinguished from connections redirected using *TPROXY* and are
	// therefore treated as if they were redirected.
	// When this flag is set to false, the listener's socket is explicitly reset as non-transparent.
	// Setting this flag requires Envoy to run with the *CAP_NET_ADMIN* capability.
	// When this flag is not set (default), the socket is not modified, i.e. the transparent option
	// is neither set nor reset.
	Transparent *wrapperspb.BoolValue `protobuf:"bytes,10,opt,name=transparent,proto3" json:"transparent,omitempty"`
	// Whether the listener should set the *IP_FREEBIND* socket option. When this
	// flag is set to true, listeners can be bound to 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.
	Freebind *wrapperspb.BoolValue `protobuf:"bytes,11,opt,name=freebind,proto3" json:"freebind,omitempty"`
	// Additional socket options that may not be present in Envoy source code or
	// precompiled binaries.
	SocketOptions []*core.SocketOption `protobuf:"bytes,13,rep,name=socket_options,json=socketOptions,proto3" json:"socket_options,omitempty"`
	// Whether the listener should accept TCP Fast Open (TFO) connections.
	// When this flag is set to a value greater than 0, the option TCP_FASTOPEN is enabled on
	// the socket, with a queue length of the specified size
	// (see `details in RFC7413 <https://tools.ietf.org/html/rfc7413#section-5.1>`_).
	// When this flag is set to 0, the option TCP_FASTOPEN 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.
	//
	// On Linux, the net.ipv4.tcp_fastopen kernel parameter must include flag 0x2 to enable
	// TCP_FASTOPEN.
	// See `ip-sysctl.txt <https://www.kernel.org/doc/Documentation/networking/ip-sysctl.txt>`_.
	//
	// On macOS, only values of 0, 1, and unset are valid; other values may result in an error.
	// To set the queue length on macOS, set the net.inet.tcp.fastopen_backlog kernel parameter.
	TcpFastOpenQueueLength *wrapperspb.UInt32Value `` /* 134-byte string literal not displayed */
	// Specifies the intended direction of the traffic relative to the local Envoy.
	// This property is required on Windows for listeners using the original destination filter,
	// see :ref:`Original Destination <config_listener_filters_original_dst>`.
	TrafficDirection core.TrafficDirection `` /* 151-byte string literal not displayed */
	// If the protocol in the listener socket address in :ref:`protocol
	// <envoy_api_field_core.SocketAddress.protocol>` is :ref:`UDP
	// <envoy_api_enum_value_core.SocketAddress.Protocol.UDP>`, this field specifies the actual udp
	// listener to create, i.e. :ref:`udp_listener_name
	// <envoy_api_field_listener.UdpListenerConfig.udp_listener_name>` = "raw_udp_listener" for
	// creating a packet-oriented UDP listener. If not present, treat it as "raw_udp_listener".
	UdpListenerConfig *listener.UdpListenerConfig `protobuf:"bytes,18,opt,name=udp_listener_config,json=udpListenerConfig,proto3" json:"udp_listener_config,omitempty"`
	// Used to represent an API listener, which is used in non-proxy clients. The type of API
	// exposed to the non-proxy application depends on the type of API listener.
	// When this field is set, no other field except for :ref:`name<envoy_api_field_Listener.name>`
	// should be set.
	//
	// .. note::
	//
	//	Currently only one ApiListener can be installed; and it can only be done via bootstrap config,
	//	not LDS.
	//
	// [#next-major-version: In the v3 API, instead of this messy approach where the socket
	// listener fields are directly in the top-level Listener message and the API listener types
	// are in the ApiListener message, the socket listener messages should be in their own message,
	// and the top-level Listener should essentially be a oneof that selects between the
	// socket listener and the various types of API listener. That way, a given Listener message
	// can structurally only contain the fields of the relevant type.]
	ApiListener *v2.ApiListener `protobuf:"bytes,19,opt,name=api_listener,json=apiListener,proto3" json:"api_listener,omitempty"`
	// The listener's connection balancer configuration, currently only applicable to TCP listeners.
	// If no configuration is specified, Envoy will not attempt to balance active connections between
	// worker threads.
	ConnectionBalanceConfig *Listener_ConnectionBalanceConfig `` /* 133-byte string literal not displayed */
	// When this flag is set to true, listeners set the *SO_REUSEPORT* socket option and
	// create one socket for each worker thread. This makes inbound connections
	// distribute among worker threads roughly evenly in cases where there are a high number
	// of connections. When this flag is set to false, all worker threads share one socket.
	//
	// Before Linux v4.19-rc1, new TCP connections may be rejected during hot restart
	// (see `3rd paragraph in 'soreuseport' commit message
	// <https://github.com/torvalds/linux/commit/c617f398edd4db2b8567a28e89>`_).
	// This issue was fixed by `tcp: Avoid TCP syncookie rejected by SO_REUSEPORT socket
	// <https://github.com/torvalds/linux/commit/40a1227ea845a37ab197dd1caffb60b047fa36b1>`_.
	ReusePort bool `protobuf:"varint,21,opt,name=reuse_port,json=reusePort,proto3" json:"reuse_port,omitempty"`
	// Configuration for :ref:`access logs <arch_overview_access_logs>`
	// emitted by this listener.
	AccessLog []*v21.AccessLog `protobuf:"bytes,22,rep,name=access_log,json=accessLog,proto3" json:"access_log,omitempty"`
	// contains filtered or unexported fields
}

[#next-free-field: 23]

func (*Listener) ClearAddress

func (x *Listener) ClearAddress()

func (*Listener) ClearApiListener

func (x *Listener) ClearApiListener()

func (*Listener) ClearConnectionBalanceConfig

func (x *Listener) ClearConnectionBalanceConfig()

func (*Listener) ClearDeprecatedV1

func (x *Listener) ClearDeprecatedV1()

func (*Listener) ClearFreebind

func (x *Listener) ClearFreebind()

func (*Listener) ClearListenerFiltersTimeout

func (x *Listener) ClearListenerFiltersTimeout()

func (*Listener) ClearMetadata

func (x *Listener) ClearMetadata()

func (*Listener) ClearPerConnectionBufferLimitBytes

func (x *Listener) ClearPerConnectionBufferLimitBytes()

func (*Listener) ClearTcpFastOpenQueueLength

func (x *Listener) ClearTcpFastOpenQueueLength()

func (*Listener) ClearTransparent

func (x *Listener) ClearTransparent()

func (*Listener) ClearUdpListenerConfig

func (x *Listener) ClearUdpListenerConfig()

func (*Listener) ClearUseOriginalDst deprecated

func (x *Listener) ClearUseOriginalDst()

Deprecated: Marked as deprecated in envoy/api/v2/listener.proto.

func (*Listener) GetAccessLog

func (x *Listener) GetAccessLog() []*v21.AccessLog

func (*Listener) GetAddress

func (x *Listener) GetAddress() *core.Address

func (*Listener) GetApiListener

func (x *Listener) GetApiListener() *v2.ApiListener

func (*Listener) GetConnectionBalanceConfig

func (x *Listener) GetConnectionBalanceConfig() *Listener_ConnectionBalanceConfig

func (*Listener) GetContinueOnListenerFiltersTimeout

func (x *Listener) GetContinueOnListenerFiltersTimeout() bool

func (*Listener) GetDeprecatedV1

func (x *Listener) GetDeprecatedV1() *Listener_DeprecatedV1

func (*Listener) GetDrainType

func (x *Listener) GetDrainType() Listener_DrainType

func (*Listener) GetFilterChains

func (x *Listener) GetFilterChains() []*listener.FilterChain

func (*Listener) GetFreebind

func (x *Listener) GetFreebind() *wrapperspb.BoolValue

func (*Listener) GetListenerFilters

func (x *Listener) GetListenerFilters() []*listener.ListenerFilter

func (*Listener) GetListenerFiltersTimeout

func (x *Listener) GetListenerFiltersTimeout() *durationpb.Duration

func (*Listener) GetMetadata

func (x *Listener) GetMetadata() *core.Metadata

func (*Listener) GetName

func (x *Listener) GetName() string

func (*Listener) GetPerConnectionBufferLimitBytes

func (x *Listener) GetPerConnectionBufferLimitBytes() *wrapperspb.UInt32Value

func (*Listener) GetReusePort

func (x *Listener) GetReusePort() bool

func (*Listener) GetSocketOptions

func (x *Listener) GetSocketOptions() []*core.SocketOption

func (*Listener) GetTcpFastOpenQueueLength

func (x *Listener) GetTcpFastOpenQueueLength() *wrapperspb.UInt32Value

func (*Listener) GetTrafficDirection

func (x *Listener) GetTrafficDirection() core.TrafficDirection

func (*Listener) GetTransparent

func (x *Listener) GetTransparent() *wrapperspb.BoolValue

func (*Listener) GetUdpListenerConfig

func (x *Listener) GetUdpListenerConfig() *listener.UdpListenerConfig

func (*Listener) GetUseOriginalDst deprecated

func (x *Listener) GetUseOriginalDst() *wrapperspb.BoolValue

Deprecated: Marked as deprecated in envoy/api/v2/listener.proto.

func (*Listener) HasAddress

func (x *Listener) HasAddress() bool

func (*Listener) HasApiListener

func (x *Listener) HasApiListener() bool

func (*Listener) HasConnectionBalanceConfig

func (x *Listener) HasConnectionBalanceConfig() bool

func (*Listener) HasDeprecatedV1

func (x *Listener) HasDeprecatedV1() bool

func (*Listener) HasFreebind

func (x *Listener) HasFreebind() bool

func (*Listener) HasListenerFiltersTimeout

func (x *Listener) HasListenerFiltersTimeout() bool

func (*Listener) HasMetadata

func (x *Listener) HasMetadata() bool

func (*Listener) HasPerConnectionBufferLimitBytes

func (x *Listener) HasPerConnectionBufferLimitBytes() bool

func (*Listener) HasTcpFastOpenQueueLength

func (x *Listener) HasTcpFastOpenQueueLength() bool

func (*Listener) HasTransparent

func (x *Listener) HasTransparent() bool

func (*Listener) HasUdpListenerConfig

func (x *Listener) HasUdpListenerConfig() bool

func (*Listener) HasUseOriginalDst deprecated

func (x *Listener) HasUseOriginalDst() bool

Deprecated: Marked as deprecated in envoy/api/v2/listener.proto.

func (*Listener) ProtoMessage

func (*Listener) ProtoMessage()

func (*Listener) ProtoReflect

func (x *Listener) ProtoReflect() protoreflect.Message

func (*Listener) Reset

func (x *Listener) Reset()

func (*Listener) SetAccessLog

func (x *Listener) SetAccessLog(v []*v21.AccessLog)

func (*Listener) SetAddress

func (x *Listener) SetAddress(v *core.Address)

func (*Listener) SetApiListener

func (x *Listener) SetApiListener(v *v2.ApiListener)

func (*Listener) SetConnectionBalanceConfig

func (x *Listener) SetConnectionBalanceConfig(v *Listener_ConnectionBalanceConfig)

func (*Listener) SetContinueOnListenerFiltersTimeout

func (x *Listener) SetContinueOnListenerFiltersTimeout(v bool)

func (*Listener) SetDeprecatedV1

func (x *Listener) SetDeprecatedV1(v *Listener_DeprecatedV1)

func (*Listener) SetDrainType

func (x *Listener) SetDrainType(v Listener_DrainType)

func (*Listener) SetFilterChains

func (x *Listener) SetFilterChains(v []*listener.FilterChain)

func (*Listener) SetFreebind

func (x *Listener) SetFreebind(v *wrapperspb.BoolValue)

func (*Listener) SetListenerFilters

func (x *Listener) SetListenerFilters(v []*listener.ListenerFilter)

func (*Listener) SetListenerFiltersTimeout

func (x *Listener) SetListenerFiltersTimeout(v *durationpb.Duration)

func (*Listener) SetMetadata

func (x *Listener) SetMetadata(v *core.Metadata)

func (*Listener) SetName

func (x *Listener) SetName(v string)

func (*Listener) SetPerConnectionBufferLimitBytes

func (x *Listener) SetPerConnectionBufferLimitBytes(v *wrapperspb.UInt32Value)

func (*Listener) SetReusePort

func (x *Listener) SetReusePort(v bool)

func (*Listener) SetSocketOptions

func (x *Listener) SetSocketOptions(v []*core.SocketOption)

func (*Listener) SetTcpFastOpenQueueLength

func (x *Listener) SetTcpFastOpenQueueLength(v *wrapperspb.UInt32Value)

func (*Listener) SetTrafficDirection

func (x *Listener) SetTrafficDirection(v core.TrafficDirection)

func (*Listener) SetTransparent

func (x *Listener) SetTransparent(v *wrapperspb.BoolValue)

func (*Listener) SetUdpListenerConfig

func (x *Listener) SetUdpListenerConfig(v *listener.UdpListenerConfig)

func (*Listener) SetUseOriginalDst deprecated

func (x *Listener) SetUseOriginalDst(v *wrapperspb.BoolValue)

Deprecated: Marked as deprecated in envoy/api/v2/listener.proto.

func (*Listener) String

func (x *Listener) String() string

type Listener_ConnectionBalanceConfig

type Listener_ConnectionBalanceConfig struct {

	// Types that are valid to be assigned to BalanceType:
	//
	//	*Listener_ConnectionBalanceConfig_ExactBalance_
	BalanceType isListener_ConnectionBalanceConfig_BalanceType `protobuf_oneof:"balance_type"`
	// contains filtered or unexported fields
}

Configuration for listener connection balancing.

func (*Listener_ConnectionBalanceConfig) ClearBalanceType

func (x *Listener_ConnectionBalanceConfig) ClearBalanceType()

func (*Listener_ConnectionBalanceConfig) ClearExactBalance

func (x *Listener_ConnectionBalanceConfig) ClearExactBalance()

func (*Listener_ConnectionBalanceConfig) GetBalanceType

func (x *Listener_ConnectionBalanceConfig) GetBalanceType() isListener_ConnectionBalanceConfig_BalanceType

func (*Listener_ConnectionBalanceConfig) GetExactBalance

func (*Listener_ConnectionBalanceConfig) HasBalanceType

func (x *Listener_ConnectionBalanceConfig) HasBalanceType() bool

func (*Listener_ConnectionBalanceConfig) HasExactBalance

func (x *Listener_ConnectionBalanceConfig) HasExactBalance() bool

func (*Listener_ConnectionBalanceConfig) ProtoMessage

func (*Listener_ConnectionBalanceConfig) ProtoMessage()

func (*Listener_ConnectionBalanceConfig) ProtoReflect

func (*Listener_ConnectionBalanceConfig) Reset

func (*Listener_ConnectionBalanceConfig) SetExactBalance

func (*Listener_ConnectionBalanceConfig) String

func (*Listener_ConnectionBalanceConfig) WhichBalanceType

func (x *Listener_ConnectionBalanceConfig) WhichBalanceType() case_Listener_ConnectionBalanceConfig_BalanceType

type Listener_ConnectionBalanceConfig_ExactBalance

type Listener_ConnectionBalanceConfig_ExactBalance struct {
	// contains filtered or unexported fields
}

A connection balancer implementation that does exact balancing. This means that a lock is held during balancing so that connection counts are nearly exactly balanced between worker threads. This is "nearly" exact in the sense that a connection might close in parallel thus making the counts incorrect, but this should be rectified on the next accept. This balancer sacrifices accept throughput for accuracy and should be used when there are a small number of connections that rarely cycle (e.g., service mesh gRPC egress).

func (*Listener_ConnectionBalanceConfig_ExactBalance) ProtoMessage

func (*Listener_ConnectionBalanceConfig_ExactBalance) ProtoReflect

func (*Listener_ConnectionBalanceConfig_ExactBalance) Reset

func (*Listener_ConnectionBalanceConfig_ExactBalance) String

type Listener_ConnectionBalanceConfig_ExactBalance_

type Listener_ConnectionBalanceConfig_ExactBalance_ struct {
	// If specified, the listener will use the exact connection balancer.
	ExactBalance *Listener_ConnectionBalanceConfig_ExactBalance `protobuf:"bytes,1,opt,name=exact_balance,json=exactBalance,proto3,oneof"`
}

type Listener_ConnectionBalanceConfig_ExactBalance_builder

type Listener_ConnectionBalanceConfig_ExactBalance_builder struct {
	// contains filtered or unexported fields
}

func (Listener_ConnectionBalanceConfig_ExactBalance_builder) Build

type Listener_ConnectionBalanceConfig_builder

type Listener_ConnectionBalanceConfig_builder struct {

	// Fields of oneof BalanceType:
	// If specified, the listener will use the exact connection balancer.
	ExactBalance *Listener_ConnectionBalanceConfig_ExactBalance
	// contains filtered or unexported fields
}

func (Listener_ConnectionBalanceConfig_builder) Build

type Listener_DeprecatedV1

type Listener_DeprecatedV1 struct {

	// Whether the listener should bind to the port. A listener that doesn't
	// bind can only receive connections redirected from other listeners that
	// set use_original_dst parameter to true. Default is true.
	//
	// This is deprecated in v2, all Listeners will bind to their port. An
	// additional filter chain must be created for every original destination
	// port this listener may redirect to in v2, with the original port
	// specified in the FilterChainMatch destination_port field.
	//
	// [#comment:TODO(PiotrSikora): Remove this once verified that we no longer need it.]
	BindToPort *wrapperspb.BoolValue `protobuf:"bytes,1,opt,name=bind_to_port,json=bindToPort,proto3" json:"bind_to_port,omitempty"`
	// contains filtered or unexported fields
}

[#not-implemented-hide:]

func (*Listener_DeprecatedV1) ClearBindToPort

func (x *Listener_DeprecatedV1) ClearBindToPort()

func (*Listener_DeprecatedV1) GetBindToPort

func (x *Listener_DeprecatedV1) GetBindToPort() *wrapperspb.BoolValue

func (*Listener_DeprecatedV1) HasBindToPort

func (x *Listener_DeprecatedV1) HasBindToPort() bool

func (*Listener_DeprecatedV1) ProtoMessage

func (*Listener_DeprecatedV1) ProtoMessage()

func (*Listener_DeprecatedV1) ProtoReflect

func (x *Listener_DeprecatedV1) ProtoReflect() protoreflect.Message

func (*Listener_DeprecatedV1) Reset

func (x *Listener_DeprecatedV1) Reset()

func (*Listener_DeprecatedV1) SetBindToPort

func (x *Listener_DeprecatedV1) SetBindToPort(v *wrapperspb.BoolValue)

func (*Listener_DeprecatedV1) String

func (x *Listener_DeprecatedV1) String() string

type Listener_DeprecatedV1_builder

type Listener_DeprecatedV1_builder struct {

	// Whether the listener should bind to the port. A listener that doesn't
	// bind can only receive connections redirected from other listeners that
	// set use_original_dst parameter to true. Default is true.
	//
	// This is deprecated in v2, all Listeners will bind to their port. An
	// additional filter chain must be created for every original destination
	// port this listener may redirect to in v2, with the original port
	// specified in the FilterChainMatch destination_port field.
	//
	// [#comment:TODO(PiotrSikora): Remove this once verified that we no longer need it.]
	BindToPort *wrapperspb.BoolValue
	// contains filtered or unexported fields
}

func (Listener_DeprecatedV1_builder) Build

type Listener_DrainType

type Listener_DrainType int32
const (
	// Drain in response to calling /healthcheck/fail admin endpoint (along with the health check
	// filter), listener removal/modification, and hot restart.
	Listener_DEFAULT Listener_DrainType = 0
	// Drain in response to listener removal/modification and hot restart. This setting does not
	// include /healthcheck/fail. This setting may be desirable if Envoy is hosting both ingress
	// and egress listeners.
	Listener_MODIFY_ONLY Listener_DrainType = 1
)

func (Listener_DrainType) Descriptor

func (Listener_DrainType) Enum

func (Listener_DrainType) Number

func (Listener_DrainType) String

func (x Listener_DrainType) String() string

func (Listener_DrainType) Type

type Listener_builder

type Listener_builder struct {

	// The unique name by which this listener is known. If no name is provided,
	// Envoy will allocate an internal UUID for the listener. If the listener is to be dynamically
	// updated or removed via :ref:`LDS <config_listeners_lds>` a unique name must be provided.
	Name string
	// The address that the listener should listen on. In general, the address must be unique, though
	// that is governed by the bind rules of the OS. E.g., multiple listeners can listen on port 0 on
	// Linux as the actual port will be allocated by the OS.
	Address *core.Address
	// A list of filter chains to consider for this listener. The
	// :ref:`FilterChain <envoy_api_msg_listener.FilterChain>` with the most specific
	// :ref:`FilterChainMatch <envoy_api_msg_listener.FilterChainMatch>` criteria is used on a
	// connection.
	//
	// Example using SNI for filter chain selection can be found in the
	// :ref:`FAQ entry <faq_how_to_setup_sni>`.
	FilterChains []*listener.FilterChain
	// If a connection is redirected using *iptables*, the port on which the proxy
	// receives it might be different from the original destination address. When this flag is set to
	// true, the listener hands off redirected connections to the listener associated with the
	// original destination address. If there is no listener associated with the original destination
	// address, the connection is handled by the listener that receives it. Defaults to false.
	//
	// .. attention::
	//
	//	This field is deprecated. Use :ref:`an original_dst <config_listener_filters_original_dst>`
	//	:ref:`listener filter <envoy_api_field_Listener.listener_filters>` instead.
	//
	//	Note that hand off to another listener is *NOT* performed without this flag. Once
	//	:ref:`FilterChainMatch <envoy_api_msg_listener.FilterChainMatch>` is implemented this flag
	//	will be removed, as filter chain matching can be used to select a filter chain based on the
	//	restored destination address.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/listener.proto.
	UseOriginalDst *wrapperspb.BoolValue
	// Soft limit on size of the listener’s new connection read and write buffers.
	// If unspecified, an implementation defined default is applied (1MiB).
	PerConnectionBufferLimitBytes *wrapperspb.UInt32Value
	// Listener metadata.
	Metadata *core.Metadata
	// [#not-implemented-hide:]
	DeprecatedV1 *Listener_DeprecatedV1
	// The type of draining to perform at a listener-wide level.
	DrainType Listener_DrainType
	// Listener filters have the opportunity to manipulate and augment the connection metadata that
	// is used in connection filter chain matching, for example. These filters are run before any in
	// :ref:`filter_chains <envoy_api_field_Listener.filter_chains>`. Order matters as the
	// filters are processed sequentially right after a socket has been accepted by the listener, and
	// before a connection is created.
	// UDP Listener filters can be specified when the protocol in the listener socket address in
	// :ref:`protocol <envoy_api_field_core.SocketAddress.protocol>` is :ref:`UDP
	// <envoy_api_enum_value_core.SocketAddress.Protocol.UDP>`.
	// UDP listeners currently support a single filter.
	ListenerFilters []*listener.ListenerFilter
	// The timeout to wait for all listener filters to complete operation. If the timeout is reached,
	// the accepted socket is closed without a connection being created unless
	// `continue_on_listener_filters_timeout` is set to true. Specify 0 to disable the
	// timeout. If not specified, a default timeout of 15s is used.
	ListenerFiltersTimeout *durationpb.Duration
	// Whether a connection should be created when listener filters timeout. Default is false.
	//
	// .. attention::
	//
	//	Some listener filters, such as :ref:`Proxy Protocol filter
	//	<config_listener_filters_proxy_protocol>`, should not be used with this option. It will cause
	//	unexpected behavior when a connection is created.
	ContinueOnListenerFiltersTimeout bool
	// Whether the listener should be set as a transparent socket.
	// When this flag is set to true, connections can be redirected to the listener using an
	// *iptables* *TPROXY* target, in which case the original source and destination addresses and
	// ports are preserved on accepted connections. This flag should be used in combination with
	// :ref:`an original_dst <config_listener_filters_original_dst>` :ref:`listener filter
	// <envoy_api_field_Listener.listener_filters>` to mark the connections' local addresses as
	// "restored." This can be used to hand off each redirected connection to another listener
	// associated with the connection's destination address. Direct connections to the socket without
	// using *TPROXY* cannot be distinguished from connections redirected using *TPROXY* and are
	// therefore treated as if they were redirected.
	// When this flag is set to false, the listener's socket is explicitly reset as non-transparent.
	// Setting this flag requires Envoy to run with the *CAP_NET_ADMIN* capability.
	// When this flag is not set (default), the socket is not modified, i.e. the transparent option
	// is neither set nor reset.
	Transparent *wrapperspb.BoolValue
	// Whether the listener should set the *IP_FREEBIND* socket option. When this
	// flag is set to true, listeners can be bound to 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.
	Freebind *wrapperspb.BoolValue
	// Additional socket options that may not be present in Envoy source code or
	// precompiled binaries.
	SocketOptions []*core.SocketOption
	// Whether the listener should accept TCP Fast Open (TFO) connections.
	// When this flag is set to a value greater than 0, the option TCP_FASTOPEN is enabled on
	// the socket, with a queue length of the specified size
	// (see `details in RFC7413 <https://tools.ietf.org/html/rfc7413#section-5.1>`_).
	// When this flag is set to 0, the option TCP_FASTOPEN 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.
	//
	// On Linux, the net.ipv4.tcp_fastopen kernel parameter must include flag 0x2 to enable
	// TCP_FASTOPEN.
	// See `ip-sysctl.txt <https://www.kernel.org/doc/Documentation/networking/ip-sysctl.txt>`_.
	//
	// On macOS, only values of 0, 1, and unset are valid; other values may result in an error.
	// To set the queue length on macOS, set the net.inet.tcp.fastopen_backlog kernel parameter.
	TcpFastOpenQueueLength *wrapperspb.UInt32Value
	// Specifies the intended direction of the traffic relative to the local Envoy.
	// This property is required on Windows for listeners using the original destination filter,
	// see :ref:`Original Destination <config_listener_filters_original_dst>`.
	TrafficDirection core.TrafficDirection
	// If the protocol in the listener socket address in :ref:`protocol
	// <envoy_api_field_core.SocketAddress.protocol>` is :ref:`UDP
	// <envoy_api_enum_value_core.SocketAddress.Protocol.UDP>`, this field specifies the actual udp
	// listener to create, i.e. :ref:`udp_listener_name
	// <envoy_api_field_listener.UdpListenerConfig.udp_listener_name>` = "raw_udp_listener" for
	// creating a packet-oriented UDP listener. If not present, treat it as "raw_udp_listener".
	UdpListenerConfig *listener.UdpListenerConfig
	// Used to represent an API listener, which is used in non-proxy clients. The type of API
	// exposed to the non-proxy application depends on the type of API listener.
	// When this field is set, no other field except for :ref:`name<envoy_api_field_Listener.name>`
	// should be set.
	//
	// .. note::
	//
	//	Currently only one ApiListener can be installed; and it can only be done via bootstrap config,
	//	not LDS.
	//
	// [#next-major-version: In the v3 API, instead of this messy approach where the socket
	// listener fields are directly in the top-level Listener message and the API listener types
	// are in the ApiListener message, the socket listener messages should be in their own message,
	// and the top-level Listener should essentially be a oneof that selects between the
	// socket listener and the various types of API listener. That way, a given Listener message
	// can structurally only contain the fields of the relevant type.]
	ApiListener *v2.ApiListener
	// The listener's connection balancer configuration, currently only applicable to TCP listeners.
	// If no configuration is specified, Envoy will not attempt to balance active connections between
	// worker threads.
	ConnectionBalanceConfig *Listener_ConnectionBalanceConfig
	// When this flag is set to true, listeners set the *SO_REUSEPORT* socket option and
	// create one socket for each worker thread. This makes inbound connections
	// distribute among worker threads roughly evenly in cases where there are a high number
	// of connections. When this flag is set to false, all worker threads share one socket.
	//
	// Before Linux v4.19-rc1, new TCP connections may be rejected during hot restart
	// (see `3rd paragraph in 'soreuseport' commit message
	// <https://github.com/torvalds/linux/commit/c617f398edd4db2b8567a28e89>`_).
	// This issue was fixed by `tcp: Avoid TCP syncookie rejected by SO_REUSEPORT socket
	// <https://github.com/torvalds/linux/commit/40a1227ea845a37ab197dd1caffb60b047fa36b1>`_.
	ReusePort bool
	// Configuration for :ref:`access logs <arch_overview_access_logs>`
	// emitted by this listener.
	AccessLog []*v21.AccessLog
	// contains filtered or unexported fields
}

func (Listener_builder) Build

func (b0 Listener_builder) Build() *Listener

type LoadBalancingPolicy

type LoadBalancingPolicy struct {

	// Each client will iterate over the list in order and stop at the first policy that it
	// supports. This provides a mechanism for starting to use new LB policies that are not yet
	// supported by all clients.
	Policies []*LoadBalancingPolicy_Policy `protobuf:"bytes,1,rep,name=policies,proto3" json:"policies,omitempty"`
	// contains filtered or unexported fields
}

[#not-implemented-hide:] Extensible load balancing policy configuration.

Every LB policy defined via this mechanism will be identified via a unique name using reverse DNS notation. If the policy needs configuration parameters, it must define a message for its own configuration, which will be stored in the config field. The name of the policy will tell clients which type of message they should expect to see in the config field.

Note that there are cases where it is useful to be able to independently select LB policies for choosing a locality and for choosing an endpoint within that locality. For example, a given deployment may always use the same policy to choose the locality, but for choosing the endpoint within the locality, some clusters may use weighted-round-robin, while others may use some sort of session-based balancing.

This can be accomplished via hierarchical LB policies, where the parent LB policy creates a child LB policy for each locality. For each request, the parent chooses the locality and then delegates to the child policy for that locality to choose the endpoint within the locality.

To facilitate this, the config message for the top-level LB policy may include a field of type LoadBalancingPolicy that specifies the child policy.

func (*LoadBalancingPolicy) GetPolicies

func (x *LoadBalancingPolicy) GetPolicies() []*LoadBalancingPolicy_Policy

func (*LoadBalancingPolicy) ProtoMessage

func (*LoadBalancingPolicy) ProtoMessage()

func (*LoadBalancingPolicy) ProtoReflect

func (x *LoadBalancingPolicy) ProtoReflect() protoreflect.Message

func (*LoadBalancingPolicy) Reset

func (x *LoadBalancingPolicy) Reset()

func (*LoadBalancingPolicy) SetPolicies

func (x *LoadBalancingPolicy) SetPolicies(v []*LoadBalancingPolicy_Policy)

func (*LoadBalancingPolicy) String

func (x *LoadBalancingPolicy) String() string

type LoadBalancingPolicy_Policy

type LoadBalancingPolicy_Policy struct {

	// Required. The name of the LB policy.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Optional config for the LB policy.
	// No more than one of these two fields may be populated.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	Config      *structpb.Struct `protobuf:"bytes,2,opt,name=config,proto3" json:"config,omitempty"`
	TypedConfig *anypb.Any       `protobuf:"bytes,3,opt,name=typed_config,json=typedConfig,proto3" json:"typed_config,omitempty"`
	// contains filtered or unexported fields
}

func (*LoadBalancingPolicy_Policy) ClearConfig deprecated

func (x *LoadBalancingPolicy_Policy) ClearConfig()

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*LoadBalancingPolicy_Policy) ClearTypedConfig

func (x *LoadBalancingPolicy_Policy) ClearTypedConfig()

func (*LoadBalancingPolicy_Policy) GetConfig deprecated

func (x *LoadBalancingPolicy_Policy) GetConfig() *structpb.Struct

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*LoadBalancingPolicy_Policy) GetName

func (x *LoadBalancingPolicy_Policy) GetName() string

func (*LoadBalancingPolicy_Policy) GetTypedConfig

func (x *LoadBalancingPolicy_Policy) GetTypedConfig() *anypb.Any

func (*LoadBalancingPolicy_Policy) HasConfig deprecated

func (x *LoadBalancingPolicy_Policy) HasConfig() bool

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*LoadBalancingPolicy_Policy) HasTypedConfig

func (x *LoadBalancingPolicy_Policy) HasTypedConfig() bool

func (*LoadBalancingPolicy_Policy) ProtoMessage

func (*LoadBalancingPolicy_Policy) ProtoMessage()

func (*LoadBalancingPolicy_Policy) ProtoReflect

func (*LoadBalancingPolicy_Policy) Reset

func (x *LoadBalancingPolicy_Policy) Reset()

func (*LoadBalancingPolicy_Policy) SetConfig deprecated

func (x *LoadBalancingPolicy_Policy) SetConfig(v *structpb.Struct)

Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.

func (*LoadBalancingPolicy_Policy) SetName

func (x *LoadBalancingPolicy_Policy) SetName(v string)

func (*LoadBalancingPolicy_Policy) SetTypedConfig

func (x *LoadBalancingPolicy_Policy) SetTypedConfig(v *anypb.Any)

func (*LoadBalancingPolicy_Policy) String

func (x *LoadBalancingPolicy_Policy) String() string

type LoadBalancingPolicy_Policy_builder

type LoadBalancingPolicy_Policy_builder struct {

	// Required. The name of the LB policy.
	Name string
	// Optional config for the LB policy.
	// No more than one of these two fields may be populated.
	//
	// Deprecated: Marked as deprecated in envoy/api/v2/cluster.proto.
	Config      *structpb.Struct
	TypedConfig *anypb.Any
	// contains filtered or unexported fields
}

func (LoadBalancingPolicy_Policy_builder) Build

type LoadBalancingPolicy_builder

type LoadBalancingPolicy_builder struct {

	// Each client will iterate over the list in order and stop at the first policy that it
	// supports. This provides a mechanism for starting to use new LB policies that are not yet
	// supported by all clients.
	Policies []*LoadBalancingPolicy_Policy
	// contains filtered or unexported fields
}

func (LoadBalancingPolicy_builder) Build

type RdsDummy

type RdsDummy struct {
	// contains filtered or unexported fields
}

[#not-implemented-hide:] Not configuration. Workaround c++ protobuf issue with importing services: https://github.com/google/protobuf/issues/4221 and protoxform to upgrade the file.

func (*RdsDummy) ProtoMessage

func (*RdsDummy) ProtoMessage()

func (*RdsDummy) ProtoReflect

func (x *RdsDummy) ProtoReflect() protoreflect.Message

func (*RdsDummy) Reset

func (x *RdsDummy) Reset()

func (*RdsDummy) String

func (x *RdsDummy) String() string

type RdsDummy_builder

type RdsDummy_builder struct {
	// contains filtered or unexported fields
}

func (RdsDummy_builder) Build

func (b0 RdsDummy_builder) Build() *RdsDummy

type Resource

type Resource struct {

	// The resource's name, to distinguish it from others of the same type of resource.
	Name string `protobuf:"bytes,3,opt,name=name,proto3" json:"name,omitempty"`
	// The aliases are a list of other names that this resource can go by.
	Aliases []string `protobuf:"bytes,4,rep,name=aliases,proto3" json:"aliases,omitempty"`
	// The resource level version. It allows xDS to track the state of individual
	// resources.
	Version string `protobuf:"bytes,1,opt,name=version,proto3" json:"version,omitempty"`
	// The resource being tracked.
	Resource *anypb.Any `protobuf:"bytes,2,opt,name=resource,proto3" json:"resource,omitempty"`
	// contains filtered or unexported fields
}

func (*Resource) ClearResource

func (x *Resource) ClearResource()

func (*Resource) GetAliases

func (x *Resource) GetAliases() []string

func (*Resource) GetName

func (x *Resource) GetName() string

func (*Resource) GetResource

func (x *Resource) GetResource() *anypb.Any

func (*Resource) GetVersion

func (x *Resource) GetVersion() string

func (*Resource) HasResource

func (x *Resource) HasResource() bool

func (*Resource) ProtoMessage

func (*Resource) ProtoMessage()

func (*Resource) ProtoReflect

func (x *Resource) ProtoReflect() protoreflect.Message

func (*Resource) Reset

func (x *Resource) Reset()

func (*Resource) SetAliases

func (x *Resource) SetAliases(v []string)

func (*Resource) SetName

func (x *Resource) SetName(v string)

func (*Resource) SetResource

func (x *Resource) SetResource(v *anypb.Any)

func (*Resource) SetVersion

func (x *Resource) SetVersion(v string)

func (*Resource) String

func (x *Resource) String() string

type Resource_builder

type Resource_builder struct {

	// The resource's name, to distinguish it from others of the same type of resource.
	Name string
	// The aliases are a list of other names that this resource can go by.
	Aliases []string
	// The resource level version. It allows xDS to track the state of individual
	// resources.
	Version string
	// The resource being tracked.
	Resource *anypb.Any
	// contains filtered or unexported fields
}

func (Resource_builder) Build

func (b0 Resource_builder) Build() *Resource

type RouteConfiguration

type RouteConfiguration struct {

	// The name of the route configuration. For example, it might match
	// :ref:`route_config_name
	// <envoy_api_field_config.filter.network.http_connection_manager.v2.Rds.route_config_name>` in
	// :ref:`envoy_api_msg_config.filter.network.http_connection_manager.v2.Rds`.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// An array of virtual hosts that make up the route table.
	VirtualHosts []*route.VirtualHost `protobuf:"bytes,2,rep,name=virtual_hosts,json=virtualHosts,proto3" json:"virtual_hosts,omitempty"`
	// An array of virtual hosts will be dynamically loaded via the VHDS API.
	// Both *virtual_hosts* and *vhds* fields will be used when present. *virtual_hosts* can be used
	// for a base routing table or for infrequently changing virtual hosts. *vhds* is used for
	// on-demand discovery of virtual hosts. The contents of these two fields will be merged to
	// generate a routing table for a given RouteConfiguration, with *vhds* derived configuration
	// taking precedence.
	Vhds *Vhds `protobuf:"bytes,9,opt,name=vhds,proto3" json:"vhds,omitempty"`
	// Optionally specifies a list of HTTP headers that the connection manager
	// will consider to be internal only. If they are found on external requests they will be cleaned
	// prior to filter invocation. See :ref:`config_http_conn_man_headers_x-envoy-internal` for more
	// information.
	InternalOnlyHeaders []string `protobuf:"bytes,3,rep,name=internal_only_headers,json=internalOnlyHeaders,proto3" json:"internal_only_headers,omitempty"`
	// Specifies a list of HTTP headers that should be added to each response that
	// the connection manager encodes. Headers specified at this level are applied
	// after headers from any enclosed :ref:`envoy_api_msg_route.VirtualHost` or
	// :ref:`envoy_api_msg_route.RouteAction`. For more information, including details on
	// header value syntax, see the documentation on :ref:`custom request headers
	// <config_http_conn_man_headers_custom_request_headers>`.
	ResponseHeadersToAdd []*core.HeaderValueOption `protobuf:"bytes,4,rep,name=response_headers_to_add,json=responseHeadersToAdd,proto3" json:"response_headers_to_add,omitempty"`
	// Specifies a list of HTTP headers that should be removed from each response
	// that the connection manager encodes.
	ResponseHeadersToRemove []string `` /* 134-byte string literal not displayed */
	// Specifies a list of HTTP headers that should be added to each request
	// routed by the HTTP connection manager. Headers specified at this level are
	// applied after headers from any enclosed :ref:`envoy_api_msg_route.VirtualHost` or
	// :ref:`envoy_api_msg_route.RouteAction`. For more information, including details on
	// header value syntax, see the documentation on :ref:`custom request headers
	// <config_http_conn_man_headers_custom_request_headers>`.
	RequestHeadersToAdd []*core.HeaderValueOption `protobuf:"bytes,6,rep,name=request_headers_to_add,json=requestHeadersToAdd,proto3" json:"request_headers_to_add,omitempty"`
	// Specifies a list of HTTP headers that should be removed from each request
	// routed by the HTTP connection manager.
	RequestHeadersToRemove []string `` /* 131-byte string literal not displayed */
	// By default, headers that should be added/removed are evaluated from most to least specific:
	//
	// * route level
	// * virtual host level
	// * connection manager level
	//
	// To allow setting overrides at the route or virtual host level, this order can be reversed
	// by setting this option to true. Defaults to false.
	//
	// [#next-major-version: In the v3 API, this will default to true.]
	MostSpecificHeaderMutationsWins bool `` /* 162-byte string literal not displayed */
	// An optional boolean that specifies whether the clusters that the route
	// table refers to will be validated by the cluster manager. If set to true
	// and a route refers to a non-existent cluster, the route table will not
	// load. If set to false and a route refers to a non-existent cluster, the
	// route table will load and the router filter will return a 404 if the route
	// is selected at runtime. This setting defaults to true if the route table
	// is statically defined via the :ref:`route_config
	// <envoy_api_field_config.filter.network.http_connection_manager.v2.HttpConnectionManager.route_config>`
	// option. This setting default to false if the route table is loaded dynamically via the
	// :ref:`rds
	// <envoy_api_field_config.filter.network.http_connection_manager.v2.HttpConnectionManager.rds>`
	// option. Users may wish to override the default behavior in certain cases (for example when
	// using CDS with a static route table).
	ValidateClusters *wrapperspb.BoolValue `protobuf:"bytes,7,opt,name=validate_clusters,json=validateClusters,proto3" json:"validate_clusters,omitempty"`
	// contains filtered or unexported fields
}

[#next-free-field: 11]

func (*RouteConfiguration) ClearValidateClusters

func (x *RouteConfiguration) ClearValidateClusters()

func (*RouteConfiguration) ClearVhds

func (x *RouteConfiguration) ClearVhds()

func (*RouteConfiguration) GetInternalOnlyHeaders

func (x *RouteConfiguration) GetInternalOnlyHeaders() []string

func (*RouteConfiguration) GetMostSpecificHeaderMutationsWins

func (x *RouteConfiguration) GetMostSpecificHeaderMutationsWins() bool

func (*RouteConfiguration) GetName

func (x *RouteConfiguration) GetName() string

func (*RouteConfiguration) GetRequestHeadersToAdd

func (x *RouteConfiguration) GetRequestHeadersToAdd() []*core.HeaderValueOption

func (*RouteConfiguration) GetRequestHeadersToRemove

func (x *RouteConfiguration) GetRequestHeadersToRemove() []string

func (*RouteConfiguration) GetResponseHeadersToAdd

func (x *RouteConfiguration) GetResponseHeadersToAdd() []*core.HeaderValueOption

func (*RouteConfiguration) GetResponseHeadersToRemove

func (x *RouteConfiguration) GetResponseHeadersToRemove() []string

func (*RouteConfiguration) GetValidateClusters

func (x *RouteConfiguration) GetValidateClusters() *wrapperspb.BoolValue

func (*RouteConfiguration) GetVhds

func (x *RouteConfiguration) GetVhds() *Vhds

func (*RouteConfiguration) GetVirtualHosts

func (x *RouteConfiguration) GetVirtualHosts() []*route.VirtualHost

func (*RouteConfiguration) HasValidateClusters

func (x *RouteConfiguration) HasValidateClusters() bool

func (*RouteConfiguration) HasVhds

func (x *RouteConfiguration) HasVhds() bool

func (*RouteConfiguration) ProtoMessage

func (*RouteConfiguration) ProtoMessage()

func (*RouteConfiguration) ProtoReflect

func (x *RouteConfiguration) ProtoReflect() protoreflect.Message

func (*RouteConfiguration) Reset

func (x *RouteConfiguration) Reset()

func (*RouteConfiguration) SetInternalOnlyHeaders

func (x *RouteConfiguration) SetInternalOnlyHeaders(v []string)

func (*RouteConfiguration) SetMostSpecificHeaderMutationsWins

func (x *RouteConfiguration) SetMostSpecificHeaderMutationsWins(v bool)

func (*RouteConfiguration) SetName

func (x *RouteConfiguration) SetName(v string)

func (*RouteConfiguration) SetRequestHeadersToAdd

func (x *RouteConfiguration) SetRequestHeadersToAdd(v []*core.HeaderValueOption)

func (*RouteConfiguration) SetRequestHeadersToRemove

func (x *RouteConfiguration) SetRequestHeadersToRemove(v []string)

func (*RouteConfiguration) SetResponseHeadersToAdd

func (x *RouteConfiguration) SetResponseHeadersToAdd(v []*core.HeaderValueOption)

func (*RouteConfiguration) SetResponseHeadersToRemove

func (x *RouteConfiguration) SetResponseHeadersToRemove(v []string)

func (*RouteConfiguration) SetValidateClusters

func (x *RouteConfiguration) SetValidateClusters(v *wrapperspb.BoolValue)

func (*RouteConfiguration) SetVhds

func (x *RouteConfiguration) SetVhds(v *Vhds)

func (*RouteConfiguration) SetVirtualHosts

func (x *RouteConfiguration) SetVirtualHosts(v []*route.VirtualHost)

func (*RouteConfiguration) String

func (x *RouteConfiguration) String() string

type RouteConfiguration_builder

type RouteConfiguration_builder struct {

	// The name of the route configuration. For example, it might match
	// :ref:`route_config_name
	// <envoy_api_field_config.filter.network.http_connection_manager.v2.Rds.route_config_name>` in
	// :ref:`envoy_api_msg_config.filter.network.http_connection_manager.v2.Rds`.
	Name string
	// An array of virtual hosts that make up the route table.
	VirtualHosts []*route.VirtualHost
	// An array of virtual hosts will be dynamically loaded via the VHDS API.
	// Both *virtual_hosts* and *vhds* fields will be used when present. *virtual_hosts* can be used
	// for a base routing table or for infrequently changing virtual hosts. *vhds* is used for
	// on-demand discovery of virtual hosts. The contents of these two fields will be merged to
	// generate a routing table for a given RouteConfiguration, with *vhds* derived configuration
	// taking precedence.
	Vhds *Vhds
	// Optionally specifies a list of HTTP headers that the connection manager
	// will consider to be internal only. If they are found on external requests they will be cleaned
	// prior to filter invocation. See :ref:`config_http_conn_man_headers_x-envoy-internal` for more
	// information.
	InternalOnlyHeaders []string
	// Specifies a list of HTTP headers that should be added to each response that
	// the connection manager encodes. Headers specified at this level are applied
	// after headers from any enclosed :ref:`envoy_api_msg_route.VirtualHost` or
	// :ref:`envoy_api_msg_route.RouteAction`. For more information, including details on
	// header value syntax, see the documentation on :ref:`custom request headers
	// <config_http_conn_man_headers_custom_request_headers>`.
	ResponseHeadersToAdd []*core.HeaderValueOption
	// Specifies a list of HTTP headers that should be removed from each response
	// that the connection manager encodes.
	ResponseHeadersToRemove []string
	// Specifies a list of HTTP headers that should be added to each request
	// routed by the HTTP connection manager. Headers specified at this level are
	// applied after headers from any enclosed :ref:`envoy_api_msg_route.VirtualHost` or
	// :ref:`envoy_api_msg_route.RouteAction`. For more information, including details on
	// header value syntax, see the documentation on :ref:`custom request headers
	// <config_http_conn_man_headers_custom_request_headers>`.
	RequestHeadersToAdd []*core.HeaderValueOption
	// Specifies a list of HTTP headers that should be removed from each request
	// routed by the HTTP connection manager.
	RequestHeadersToRemove []string
	// By default, headers that should be added/removed are evaluated from most to least specific:
	//
	// * route level
	// * virtual host level
	// * connection manager level
	//
	// To allow setting overrides at the route or virtual host level, this order can be reversed
	// by setting this option to true. Defaults to false.
	//
	// [#next-major-version: In the v3 API, this will default to true.]
	MostSpecificHeaderMutationsWins bool
	// An optional boolean that specifies whether the clusters that the route
	// table refers to will be validated by the cluster manager. If set to true
	// and a route refers to a non-existent cluster, the route table will not
	// load. If set to false and a route refers to a non-existent cluster, the
	// route table will load and the router filter will return a 404 if the route
	// is selected at runtime. This setting defaults to true if the route table
	// is statically defined via the :ref:`route_config
	// <envoy_api_field_config.filter.network.http_connection_manager.v2.HttpConnectionManager.route_config>`
	// option. This setting default to false if the route table is loaded dynamically via the
	// :ref:`rds
	// <envoy_api_field_config.filter.network.http_connection_manager.v2.HttpConnectionManager.rds>`
	// option. Users may wish to override the default behavior in certain cases (for example when
	// using CDS with a static route table).
	ValidateClusters *wrapperspb.BoolValue
	// contains filtered or unexported fields
}

func (RouteConfiguration_builder) Build

type ScopedRouteConfiguration

type ScopedRouteConfiguration struct {

	// The name assigned to the routing scope.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an
	// RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated
	// with this scope.
	RouteConfigurationName string `` /* 129-byte string literal not displayed */
	// The key to match against.
	Key *ScopedRouteConfiguration_Key `protobuf:"bytes,3,opt,name=key,proto3" json:"key,omitempty"`
	// contains filtered or unexported fields
}

Specifies a routing scope, which associates a :ref:`Key<envoy_api_msg_ScopedRouteConfiguration.Key>` to a :ref:`envoy_api_msg_RouteConfiguration` (identified by its resource name).

The HTTP connection manager builds up a table consisting of these Key to RouteConfiguration mappings, and looks up the RouteConfiguration to use per request according to the algorithm specified in the :ref:`scope_key_builder<envoy_api_field_config.filter.network.http_connection_manager.v2.ScopedRoutes.scope_key_builder>` assigned to the HttpConnectionManager.

For example, with the following configurations (in YAML):

HttpConnectionManager config:

.. code::

...
scoped_routes:
  name: foo-scoped-routes
  scope_key_builder:
    fragments:
      - header_value_extractor:
          name: X-Route-Selector
          element_separator: ","
          element:
            separator: =
            key: vip

ScopedRouteConfiguration resources (specified statically via :ref:`scoped_route_configurations_list<envoy_api_field_config.filter.network.http_connection_manager.v2.ScopedRoutes.scoped_route_configurations_list>` or obtained dynamically via SRDS):

.. code::

(1)
 name: route-scope1
 route_configuration_name: route-config1
 key:
    fragments:
      - string_key: 172.10.10.20

(2)
 name: route-scope2
 route_configuration_name: route-config2
 key:
   fragments:
     - string_key: 172.20.20.30

A request from a client such as:

.. code::

GET / HTTP/1.1
Host: foo.com
X-Route-Selector: vip=172.10.10.20

would result in the routing table defined by the `route-config1` RouteConfiguration being assigned to the HTTP request/stream.

func (*ScopedRouteConfiguration) ClearKey

func (x *ScopedRouteConfiguration) ClearKey()

func (*ScopedRouteConfiguration) GetKey

func (*ScopedRouteConfiguration) GetName

func (x *ScopedRouteConfiguration) GetName() string

func (*ScopedRouteConfiguration) GetRouteConfigurationName

func (x *ScopedRouteConfiguration) GetRouteConfigurationName() string

func (*ScopedRouteConfiguration) HasKey

func (x *ScopedRouteConfiguration) HasKey() bool

func (*ScopedRouteConfiguration) ProtoMessage

func (*ScopedRouteConfiguration) ProtoMessage()

func (*ScopedRouteConfiguration) ProtoReflect

func (x *ScopedRouteConfiguration) ProtoReflect() protoreflect.Message

func (*ScopedRouteConfiguration) Reset

func (x *ScopedRouteConfiguration) Reset()

func (*ScopedRouteConfiguration) SetKey

func (*ScopedRouteConfiguration) SetName

func (x *ScopedRouteConfiguration) SetName(v string)

func (*ScopedRouteConfiguration) SetRouteConfigurationName

func (x *ScopedRouteConfiguration) SetRouteConfigurationName(v string)

func (*ScopedRouteConfiguration) String

func (x *ScopedRouteConfiguration) String() string

type ScopedRouteConfiguration_Key

type ScopedRouteConfiguration_Key struct {

	// The ordered set of fragments to match against. The order must match the
	// fragments in the corresponding
	// :ref:`scope_key_builder<envoy_api_field_config.filter.network.http_connection_manager.v2.ScopedRoutes.scope_key_builder>`.
	Fragments []*ScopedRouteConfiguration_Key_Fragment `protobuf:"bytes,1,rep,name=fragments,proto3" json:"fragments,omitempty"`
	// contains filtered or unexported fields
}

Specifies a key which is matched against the output of the :ref:`scope_key_builder<envoy_api_field_config.filter.network.http_connection_manager.v2.ScopedRoutes.scope_key_builder>` specified in the HttpConnectionManager. The matching is done per HTTP request and is dependent on the order of the fragments contained in the Key.

func (*ScopedRouteConfiguration_Key) GetFragments

func (*ScopedRouteConfiguration_Key) ProtoMessage

func (*ScopedRouteConfiguration_Key) ProtoMessage()

func (*ScopedRouteConfiguration_Key) ProtoReflect

func (*ScopedRouteConfiguration_Key) Reset

func (x *ScopedRouteConfiguration_Key) Reset()

func (*ScopedRouteConfiguration_Key) SetFragments

func (*ScopedRouteConfiguration_Key) String

type ScopedRouteConfiguration_Key_Fragment

type ScopedRouteConfiguration_Key_Fragment struct {

	// Types that are valid to be assigned to Type:
	//
	//	*ScopedRouteConfiguration_Key_Fragment_StringKey
	Type isScopedRouteConfiguration_Key_Fragment_Type `protobuf_oneof:"type"`
	// contains filtered or unexported fields
}

func (*ScopedRouteConfiguration_Key_Fragment) ClearStringKey

func (x *ScopedRouteConfiguration_Key_Fragment) ClearStringKey()

func (*ScopedRouteConfiguration_Key_Fragment) ClearType

func (*ScopedRouteConfiguration_Key_Fragment) GetStringKey

func (*ScopedRouteConfiguration_Key_Fragment) GetType

func (x *ScopedRouteConfiguration_Key_Fragment) GetType() isScopedRouteConfiguration_Key_Fragment_Type

func (*ScopedRouteConfiguration_Key_Fragment) HasStringKey

func (x *ScopedRouteConfiguration_Key_Fragment) HasStringKey() bool

func (*ScopedRouteConfiguration_Key_Fragment) HasType

func (*ScopedRouteConfiguration_Key_Fragment) ProtoMessage

func (*ScopedRouteConfiguration_Key_Fragment) ProtoMessage()

func (*ScopedRouteConfiguration_Key_Fragment) ProtoReflect

func (*ScopedRouteConfiguration_Key_Fragment) Reset

func (*ScopedRouteConfiguration_Key_Fragment) SetStringKey

func (x *ScopedRouteConfiguration_Key_Fragment) SetStringKey(v string)

func (*ScopedRouteConfiguration_Key_Fragment) String

func (*ScopedRouteConfiguration_Key_Fragment) WhichType

func (x *ScopedRouteConfiguration_Key_Fragment) WhichType() case_ScopedRouteConfiguration_Key_Fragment_Type

type ScopedRouteConfiguration_Key_Fragment_StringKey

type ScopedRouteConfiguration_Key_Fragment_StringKey struct {
	// A string to match against.
	StringKey string `protobuf:"bytes,1,opt,name=string_key,json=stringKey,proto3,oneof"`
}

type ScopedRouteConfiguration_Key_Fragment_builder

type ScopedRouteConfiguration_Key_Fragment_builder struct {

	// Fields of oneof Type:
	// A string to match against.
	StringKey *string
	// contains filtered or unexported fields
}

func (ScopedRouteConfiguration_Key_Fragment_builder) Build

type ScopedRouteConfiguration_Key_builder

type ScopedRouteConfiguration_Key_builder struct {

	// The ordered set of fragments to match against. The order must match the
	// fragments in the corresponding
	// :ref:`scope_key_builder<envoy_api_field_config.filter.network.http_connection_manager.v2.ScopedRoutes.scope_key_builder>`.
	Fragments []*ScopedRouteConfiguration_Key_Fragment
	// contains filtered or unexported fields
}

func (ScopedRouteConfiguration_Key_builder) Build

type ScopedRouteConfiguration_builder

type ScopedRouteConfiguration_builder struct {

	// The name assigned to the routing scope.
	Name string
	// The resource name to use for a :ref:`envoy_api_msg_DiscoveryRequest` to an
	// RDS server to fetch the :ref:`envoy_api_msg_RouteConfiguration` associated
	// with this scope.
	RouteConfigurationName string
	// The key to match against.
	Key *ScopedRouteConfiguration_Key
	// contains filtered or unexported fields
}

func (ScopedRouteConfiguration_builder) Build

type SrdsDummy

type SrdsDummy struct {
	// contains filtered or unexported fields
}

[#not-implemented-hide:] Not configuration. Workaround c++ protobuf issue with importing services: https://github.com/google/protobuf/issues/4221 and protoxform to upgrade the file.

func (*SrdsDummy) ProtoMessage

func (*SrdsDummy) ProtoMessage()

func (*SrdsDummy) ProtoReflect

func (x *SrdsDummy) ProtoReflect() protoreflect.Message

func (*SrdsDummy) Reset

func (x *SrdsDummy) Reset()

func (*SrdsDummy) String

func (x *SrdsDummy) String() string

type SrdsDummy_builder

type SrdsDummy_builder struct {
	// contains filtered or unexported fields
}

func (SrdsDummy_builder) Build

func (b0 SrdsDummy_builder) Build() *SrdsDummy

type UpstreamBindConfig

type UpstreamBindConfig struct {

	// The address Envoy should bind to when establishing upstream connections.
	SourceAddress *core.Address `protobuf:"bytes,1,opt,name=source_address,json=sourceAddress,proto3" json:"source_address,omitempty"`
	// contains filtered or unexported fields
}

An extensible structure containing the address Envoy should bind to when establishing upstream connections.

func (*UpstreamBindConfig) ClearSourceAddress

func (x *UpstreamBindConfig) ClearSourceAddress()

func (*UpstreamBindConfig) GetSourceAddress

func (x *UpstreamBindConfig) GetSourceAddress() *core.Address

func (*UpstreamBindConfig) HasSourceAddress

func (x *UpstreamBindConfig) HasSourceAddress() bool

func (*UpstreamBindConfig) ProtoMessage

func (*UpstreamBindConfig) ProtoMessage()

func (*UpstreamBindConfig) ProtoReflect

func (x *UpstreamBindConfig) ProtoReflect() protoreflect.Message

func (*UpstreamBindConfig) Reset

func (x *UpstreamBindConfig) Reset()

func (*UpstreamBindConfig) SetSourceAddress

func (x *UpstreamBindConfig) SetSourceAddress(v *core.Address)

func (*UpstreamBindConfig) String

func (x *UpstreamBindConfig) String() string

type UpstreamBindConfig_builder

type UpstreamBindConfig_builder struct {

	// The address Envoy should bind to when establishing upstream connections.
	SourceAddress *core.Address
	// contains filtered or unexported fields
}

func (UpstreamBindConfig_builder) Build

type UpstreamConnectionOptions

type UpstreamConnectionOptions struct {

	// If set then set SO_KEEPALIVE on the socket to enable TCP Keepalives.
	TcpKeepalive *core.TcpKeepalive `protobuf:"bytes,1,opt,name=tcp_keepalive,json=tcpKeepalive,proto3" json:"tcp_keepalive,omitempty"`
	// contains filtered or unexported fields
}

func (*UpstreamConnectionOptions) ClearTcpKeepalive

func (x *UpstreamConnectionOptions) ClearTcpKeepalive()

func (*UpstreamConnectionOptions) GetTcpKeepalive

func (x *UpstreamConnectionOptions) GetTcpKeepalive() *core.TcpKeepalive

func (*UpstreamConnectionOptions) HasTcpKeepalive

func (x *UpstreamConnectionOptions) HasTcpKeepalive() bool

func (*UpstreamConnectionOptions) ProtoMessage

func (*UpstreamConnectionOptions) ProtoMessage()

func (*UpstreamConnectionOptions) ProtoReflect

func (*UpstreamConnectionOptions) Reset

func (x *UpstreamConnectionOptions) Reset()

func (*UpstreamConnectionOptions) SetTcpKeepalive

func (x *UpstreamConnectionOptions) SetTcpKeepalive(v *core.TcpKeepalive)

func (*UpstreamConnectionOptions) String

func (x *UpstreamConnectionOptions) String() string

type UpstreamConnectionOptions_builder

type UpstreamConnectionOptions_builder struct {

	// If set then set SO_KEEPALIVE on the socket to enable TCP Keepalives.
	TcpKeepalive *core.TcpKeepalive
	// contains filtered or unexported fields
}

func (UpstreamConnectionOptions_builder) Build

type Vhds

type Vhds struct {

	// Configuration source specifier for VHDS.
	ConfigSource *core.ConfigSource `protobuf:"bytes,1,opt,name=config_source,json=configSource,proto3" json:"config_source,omitempty"`
	// contains filtered or unexported fields
}

func (*Vhds) ClearConfigSource

func (x *Vhds) ClearConfigSource()

func (*Vhds) GetConfigSource

func (x *Vhds) GetConfigSource() *core.ConfigSource

func (*Vhds) HasConfigSource

func (x *Vhds) HasConfigSource() bool

func (*Vhds) ProtoMessage

func (*Vhds) ProtoMessage()

func (*Vhds) ProtoReflect

func (x *Vhds) ProtoReflect() protoreflect.Message

func (*Vhds) Reset

func (x *Vhds) Reset()

func (*Vhds) SetConfigSource

func (x *Vhds) SetConfigSource(v *core.ConfigSource)

func (*Vhds) String

func (x *Vhds) String() string

type Vhds_builder

type Vhds_builder struct {

	// Configuration source specifier for VHDS.
	ConfigSource *core.ConfigSource
	// contains filtered or unexported fields
}

func (Vhds_builder) Build

func (b0 Vhds_builder) Build() *Vhds

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL