服务发现服务(SDS)

服务发现服务[架构概述]。

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

  • cluster

    (required, object) 承载服务发现服务的上游群集的标准定义。该群集必须实现和运行SDS HTTP API的REST服务。

  • refresh_delay_ms

    (required, integer) 每次访问SDS群集的API延迟（以毫秒为单位）。Envoy将在0~refresh_delay_ms之间，添加一个额外的随机抖动。因此，最长可能的延迟是2*refresh_delay_ms。

REST API

Envoy希望服务发现服务提供一下API（请参阅Lyft的参考实现）：

  1. GET /v1/registration/(string: service_name)

请求发现服务返回指定service_name的所有主机。service_name对应于群集参数service_name。使用以下JSON格式响应：

  1. {
  2.   "hosts": []
  3. }
  • hosts

    (required, array) 组成该服务的主机列表。

Host(JSON)

  1. {
  2.   "ip_address": "...",
  3.   "port": "...",
  4.   "tags": {
  5.     "az": "...",
  6.     "canary": "...",
  7.     "load_balancing_weight": "..."
  8.   }
  9. }

  • ip_address

    (required, string) 上游主机的IP地址。

  • port

    (required, integer) 上游主机的端口。

  • az

    (optional, string) 可选的上游主机的区域。Envoy使用该区域记录相应的各种统计和负载平衡任务。

  • canary

    (optional, boolean) 可选的上游主机金丝雀（灰度发布）状态。 Envoy将Canary状态用于相应的各种统计和负载平衡任务。

  • load_balancing_weight

    (optional, integer) 可选的上游主机负载平衡权重，范围为1-100. Envoy在某些内置负载平衡器中会使用到负载平衡权重。

返回