• 服务发现服务(SDS)
    • REST API
    • Host(JSON)
  • 返回

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

    返回

    • 上一级
    • 首页目录