架构与系统设计 / 系统课时
读懂 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 地址 |

沿引用链追一遍
对 proxyless gRPC 客户端,xds:///payments 这样的目标会先导向一个 Listener 资源。Listener 中的 HTTP API Listener 可以内联路由,也可以通过 HCM 的 RDS 配置引用一个 RouteConfiguration。这里使用更容易观察依赖关系的 RDS 形式。
下面是片段示例:为了集中展示引用字段,把四个独立的 v3 资源放进一个 JSON 数组;它不是可直接发送的 DiscoveryResponse。
[
{
"@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 管理服务后,可以先看四类资源状态,再决定从哪一层开始排查。
# 查询四类资源的客户端状态
grpcdebug <ADMIN_ADDR> xds status预期输出形态:
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 顺序追引用,能最快找到“资源已下发但选路没有改变”的断点。