通用的类型

通用类型

Locality

Locality proto

标识Envoy运行所在的位置或上游主机运行所在的位置。

{
  "region": "...",
  "zone": "...",
  "sub_zone": "..."
}

  • region (string) 当前属于哪个区域

  • zone (string) AWS上的可用区域（AZ），GCP区域等

  • sub_zone (string) 当用于上游主机的位置时，该字段进一步将区域分成更小的子区域，从而可以独立地进行负载平衡。

Node

Node proto

标识特定的Envoy实例。节点标识符将呈现给管理服务器，管理服务器可以使用该标识符来区分每个Envoy服务的配置。

{
  "id": "...",
  "cluster": "...",
  "metadata": "{...}",
  "locality": "{...}",
  "build_version": "..."
}

  • id (string) Envoy节点的标识符。

  • cluster (string) Envoy节点所属的群集。

  • metadata (Struct) 所在节点的扩展元数据，Envoy将直接传递给管理服务器。

  • locality (Locality) 指定Envoy实例的运行位置。

  • build_version (string) 在金丝雀（灰度发布）期间管理服务器，知道哪个版本的Envoy正在进行测试。这将由Envoy在管理服务器RPC中设置。

Endpoint

Endpoint proto

上游主机标识符

{
  "address": "{...}"
}

Metadata

Metadata proto

元数据用于监听器的匹配场景，为路由、端口、过滤器链等提供了额外的输入。它的结构是从过滤器名称（反向DNS格式）到特定的过滤器元数据的映射。过滤器的元数据key/value将合并在连接并发生请求时处理，同一个key的更新值将覆盖旧值。

元数据的使用示例，在HTTP连接管理追加附加信息，将体现在envoy.http_connection_manager.access_log命名空间。

为了实现负载平衡，元数据提供了一种集群端口子集的方法。端口匹配关联的元数据对象，路由匹配关联的元数据对象。当前有一些定义的元数据用于此目的：

  • {"envoy.lb": {"canary": <bool> }} 这表明了一个端口的canary状态，并且用于头部（x-envoy-upstream-canary）和统计处理。

{
  "filter_metadata": "{...}"
}

  • filter_metadata

    (map) key是反向DNS过滤器名称，例如com.acme.widget。命名空间envoy.*保留给Envoy内置过滤器使用。

RuntimeUInt32

RuntimeUInt32 proto

若没有指定时，则在运行时生成的uint32默认值。

{
  "default_value": "...",
  "runtime_key": "..."
}

  • default_value (uint32) 默认值，运行时没有可用的值时。

  • runtime_key (string, REQUIRED) 运行时，通过key以获取相应的value。如果定义，则使用此值。

HeaderValue

HeaderValue proto

Header键值对。

{
  "key": "...",
  "value": "..."
}

  • key (string) Header Key.

  • value (string) Header Value.

    HTTP访问日志记录的格式说明符可以在此处应用，但未知的Header值将替换为空字符串而不是-。

HeaderValueOption

HeaderValueOption proto

Header键值对追加控制选项。

{
  "header": "{...}",
  "append": "{...}"
}

  • header (HeaderValue) 控制选项所应用的Header键值对。

  • append (BoolValue) 是否添加的开关，如果为true（默认值），则该值将附加到现有值。

ApiConfigSource

ApiConfigSource proto

API配置源。这标识了Envoy将用来获取xDS的API类型和群集。

{
  "api_type": "...",
  "cluster_name": [],
  "refresh_delay": "{...}"
}

  • api_type (ApiConfigSource.ApiType) API类型。

  • cluster_name (string, REQUIRED) 可以提供多个群集名称。如果定义了大于1个集群，如果发生任何类型的故障，则将循环切换。

  • refresh_delay (Duration) 对于REST API，连续轮询之间的间隔。

ApiConfigSource.ApiType (Enum)

ApiConfigSource.ApiType proto

可以通过REST API或gRPC获取。

  • REST_LEGACY (DEFAULT) REST-JSON对应于传统v1 API。

  • REST REST-JSON v2 API，将使用v2 protos规范的JSON编码。

  • GRPC gRPC v2 API。

AggregatedConfigSource

AggregatedConfigSource proto

聚合发现服务（ADS）选项。这目前是空的，但在ConfigSource中设置时可以用来指定要使用ADS。

{}

ConfigSource

ConfigSource proto

监听器，集群，路由，端口等配置可以从文件系统或xDS API源获取。使用inotify监视文件系统配置以进行更新。

{
  "path": "...",
  "api_config_source": "{...}",
  "ads": "{...}"
}

  • path (string) 配置从文件系统路径来源来更新配置。

  • api_config_source (ApiConfigSource) API配置源。

  • ads (AggregatedConfigSource) 配置使用ADS将做为配置源。将使用引导程序配置中的ADS API配置源。

    注意：必须选择path,api_config_source,ads其中一个选项配置。

TransportSocket

TransportSocket proto

监听器和集群中传输套接字的配置。如果配置为空，则将根据tls_context的平台和现有的来选择默认的传输套接字实现和配置。

{
  "name": "...",
  "config": "{...}"
}

  • name (string, REQUIRED) 要实例化的传输套接字的名称。该名称必须匹配支持的传输套接字实现。

  • config (Struct) 具体将要被实例化的传输套接字配置。请参阅支持的传输套接字实现以获取更多信息。

RoutingPriority (Enum)

RoutingPriority proto

Envoy在路由和虚拟集群级别，都支持上游优先级路由。当前的实现是针对每个优先级别，使用不同的连接池和断路设置。这意味着即使对于HTTP/2请求，两个物理连接也将被用于上游主机。将来，Envoy可能会支持真正的HTTP/2优先级，而不是单个上行连接。

  • DEFAULT (DEFAULT)

  • HIGH

RequestMethod (Enum)

RequestMethod proto

HTTP请求方法

  • METHOD_UNSPECIFIED

    (DEFAULT)

  • GET

  • HEAD

  • POST

  • PUT

  • DELETE

  • CONNECT

  • OPTIONS

  • TRACE

返回

PreviousTLS配置Next网络地址

Last updated