路由发现服务(RDS)

  1. {
  2. "cluster": "...",
  3. "route_config_name": "...",
  4. "refresh_delay_ms": "..."
  5. }
  • cluster

    (required, string) 承载路由发现服务的上游群集的名称。群集必须实现和运行RDS HTTP API的REST服务。注:这是在群集管理器配置中定义的群集的名称,而不是群集的完整定义,如SDS和CDS的情况。

  • route_config_name

    (required, string) 路由配置的名称。这个名字将被传递给RDS HTTP API。这允许具有多个HTTP监听器(和关联的HTTP连接管理器过滤器)的Envoy配置使用不同的路由配置。默认情况下,名称的最大长度限制为60个字符。通过--max-obj-name-len命令行参数设置为所需的值,可以提高此限制。

  • refresh_delay_ms

    (optional, integer) 每次从RDS API提取的时间间隔(以毫秒为单位)。Envoy将在0和refresh_delay_ms之间的增加一个额外的随机抖动。因此,最长可能的刷新间隔是2*refresh_delay_ms。默认值是30000ms(30秒)。

REST API

  1. GET /v1/routes/(string: route_config_name)/(string: service_cluster)/(string: service_node)

请求路由发现服务返回特定route_config_nameservice_clusterservice_node的路由配置。route_config_name对应于上面的RDS配置参数。service_cluster 对应于--service-cluster 命令行选项。service_node对应于--service-node 命令行选项。响应是单个JSON对象,其中包含路由配置文档中定义的路由配置

新的路由配置将被优雅地交换,使得现有的请求不受影响。这意味着当一个请求开始时,它会看到一个一致的快照,在请求的持续时间内不会改变路由配置。因此,例如,如果更新更改超时值,则只有新的请求将使用更新后的值。

作为性能优化,Envoy对从RDS API接收的路由配置进行哈希散列处理,并且只有在哈希值发生变化时才会执行完整的重新加载。

注意:通过RDS加载的路由配置不会检查所引用的集群是否已经在集群管理器加载。RDS API被设计为与CDS API一起工作,使得Envoy最终采取一致的更新。如果一个路由引用一个未知的集群,路由器过滤器将返回一个404响应。

返回