架构与系统设计 / 系统课时

读懂 LDS、RDS、CDS 与 EDS

读懂 LDS、RDS、CDS 与 EDS

面对一份 xDS 配置,最有效的阅读方式不是从字段表开始,而是沿着资源引用链追踪“请求最终会被送到哪里”。本课用 LDS → RDS → CDS → EDS 串起入口、路由、逻辑上游和实际端点,并解释 ACK、NACK 与版本字段到底说明了什么。

学习目标

  • 说清 LDS、RDS、CDS、EDS 各自解决的问题
  • 沿资源名定位从 Listener 到实际 Endpoint 的引用链
  • 正确解释 SotW xDS 中 ACK、NACK、version_info 与 nonce 的关系

四种资源分别回答什么

这四类资源不是四份互不相关的配置,而是一条逐层收敛的决策链。

资源 主要问题 典型向下引用
LDS / Listener 这条流量从哪个逻辑入口开始、使用哪组 HTTP/gRPC 处理规则 RouteConfiguration
RDS / RouteConfiguration 某个 authority、方法路径或请求条件应选哪个上游 Cluster
CDS / Cluster 这个逻辑上游采用什么发现方式、连接与负载均衡属性 ClusterLoadAssignment
EDS / ClusterLoadAssignment 当前有哪些可选后端、locality、权重和健康状态 实际 Endpoint 地址

LDS、RDS、CDS、EDS 资源引用链与 ACK NACK 反馈

沿引用链追一遍

对 proxyless gRPC 客户端,xds:///payments 这样的目标会先导向一个 Listener 资源。Listener 中的 HTTP API Listener 可以内联路由,也可以通过 HCM 的 RDS 配置引用一个 RouteConfiguration。这里使用更容易观察依赖关系的 RDS 形式。

下面是片段示例:为了集中展示引用字段,把四个独立的 v3 资源放进一个 JSON 数组;它不是可直接发送的 DiscoveryResponse。

json
[
  {
    "@type": "type.googleapis.com/envoy.config.listener.v3.Listener",
    "name": "payments",
    "apiListener": {
      "apiListener": {
        "@type": "type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager",
        "rds": {
          "configSource": {
            "ads": {}
          },
          "routeConfigName": "payments-routes"
        },
        "httpFilters": [
          {
            "name": "router",
            "typedConfig": {
              "@type": "type.googleapis.com/envoy.extensions.filters.http.router.v3.Router"
            }
          }
        ]
      }
    }
  },
  {
    "@type": "type.googleapis.com/envoy.config.route.v3.RouteConfiguration",
    "name": "payments-routes",
    "virtualHosts": [
      {
        "name": "payments-vhost",
        "domains": [
          "*"
        ],
        "routes": [
          {
            "match": {
              "prefix": "/"
            },
            "route": {
              "cluster": "payments-cluster"
            }
          }
        ]
      }
    ]
  },
  {
    "@type": "type.googleapis.com/envoy.config.cluster.v3.Cluster",
    "name": "payments-cluster",
    "type": "EDS",
    "edsClusterConfig": {
      "edsConfig": {
        "ads": {}
      },
      "serviceName": "payments-endpoints"
    }
  },
  {
    "@type": "type.googleapis.com/envoy.config.endpoint.v3.ClusterLoadAssignment",
    "clusterName": "payments-endpoints",
    "endpoints": [
      {
        "lbEndpoints": [
          {
            "endpoint": {
              "address": {
                "socketAddress": {
                  "address": "10.0.1.10",
                  "portValue": 8443
                }
              }
            }
          }
        ]
      }
    ]
  }
]

阅读时只追名字即可:payments → payments-routes → payments-cluster → payments-endpoints → 10.0.1.10:8443。如果 CDS 没有设置 serviceName,EDS 通常使用 Cluster 名作为所请求的 ClusterLoadAssignment 名称;一旦设置了 serviceName,就必须继续追这个名字,不能想当然地拿 Cluster 名查 EDS。

ACK 和 NACK 到底确认了什么

在 State-of-the-World(SotW)流中,管理服务器发送 DiscoveryResponse 时会携带 version_info 和 nonce。客户端处理完该响应后,再用下一条 DiscoveryRequest 明确反馈结果。

ACK 表示这次响应已成功处理:客户端回传该响应的 response_nonce,并把请求中的 version_info 更新为刚刚成功应用的版本。NACK 表示这次响应没有成功应用:客户端仍回传同一个 response_nonce,但 version_info 保持为上一份成功处理的版本,同时通过 error_detail 报告失败原因。

因此,nonce 回答“你在确认哪一条响应”,version_info 回答“你最后成功接受的是哪个版本”。NACK 并不等于客户端把旧配置清空;如果之前已有可用版本,客户端通常继续使用最后一份已接受配置。

版本更新不是全局事务

SotW 下每个 type_url 都维护自己的版本概念。LDS 的版本号和 RDS、CDS、EDS 没有必须相同的关系;ADS 只是把多种资源复用在同一条双向 gRPC 流上,并不会自动把它们变成一个跨类型原子提交。

这会直接影响控制面发布顺序。比如先让 RDS 引用一个尚未到达的 Cluster,客户端可能暂时没有可用的完整引用链。生产控制面需要按照资源依赖安排更新,并通过 ACK/NACK 判断某一类资源是否真的被客户端接受,而不是只确认“消息发出去了”。

用 CSDS 从症状反推断点

应用启用了 CSDS 管理服务后,可以先看四类资源状态,再决定从哪一层开始排查。

bash
# 查询四类资源的客户端状态
grpcdebug <ADMIN_ADDR> xds status

预期输出形态:

text
Name                Status  Version  Type                                                                 LastUpdated
payments            ACKED   <VALUE>  type.googleapis.com/envoy.config.listener.v3.Listener                <TIME>
payments-routes     NACKED  <VALUE>  type.googleapis.com/envoy.config.route.v3.RouteConfiguration         <TIME>
payments-cluster    ACKED   <VALUE>  type.googleapis.com/envoy.config.cluster.v3.Cluster                  <TIME>
payments-endpoints  ACKED   <VALUE>  type.googleapis.com/envoy.config.endpoint.v3.ClusterLoadAssignment   <TIME>

<ADMIN_ADDR>、<VALUE> 和 <TIME> 是动态值。这个例子里 RDS 已经 NACK,因此应优先查看 RouteConfiguration 的校验错误和上一已接受版本,而不是先怀疑 EDS 地址。实际排障时始终沿 LDS → RDS → CDS → EDS 顺序追引用,能最快找到“资源已下发但选路没有改变”的断点。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读懂 LDS、RDS、CDS 与 EDS

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通