服务发现服务(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在某些内置负载平衡器中会使用到负载平衡权重。

返回