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

让 gRPC 客户端接入 xDS

让 gRPC 客户端接入 xDS

这节把普通 gRPC-Go 客户端改造成 xDS 客户端:用 bootstrap 找到控制面,用 xds:/// 目标订阅服务配置,并通过连续 RPC 观察端点更新后同一个 ClientConn 如何自动收敛到新的后端。

学习目标

  • 能写出 gRPC-Go 可识别的 xDS bootstrap,并区分控制面连接凭据与后端连接凭据。
  • 能用 xds:///service 创建客户端,并理解 Listener、Route、Cluster 与 Endpoint 的典型解析链路。
  • 能通过 RPC 的实际 peer 地址验证端点更新,而不是只看控制面是否“下发成功”。

接入链路先看清

bootstrap 只负责告诉 gRPC 去哪里找 xDS 控制面、客户端是谁;xds:///payments 才是业务客户端的目标。典型情况下,目标路径 payments 会成为 Listener 资源名,Listener 再关联 Route,Route 选择 Cluster,Cluster 最终通过 EDS 或静态端点得到可连接地址。

gRPC-Go 客户端接入 xDS 与动态收敛链路

gRPC-Go 客户端还需要导入 google.golang.org/grpc/xds 以注册 xDS resolver 和相关能力。业务代码不直接解析 EDS,也不自行维护地址列表;资源更新会进入 gRPC 内部的解析、子连接管理与负载均衡流程。

准备 bootstrap 与依赖

下面的实验假设本机已有一个 xDS v3 控制面监听 127.0.0.1:18000,并能为 payments 下发完整、彼此引用一致的 Listener、Route、Cluster 和 Endpoint 资源。bootstrap 中的 insecure 只表示客户端到控制面使用明文连接,生产环境应按控制面要求改用受保护的凭据。

json
{
  "xds_servers": [
    {
      "server_uri": "127.0.0.1:18000",
      "channel_creds": [
        {
          "type": "insecure"
        }
      ],
      "server_features": [
        "xds_v3"
      ]
    }
  ],
  "node": {
    "id": "payments-client-01",
    "cluster": "payments-client",
    "locality": {
      "region": "us-west1",
      "zone": "us-west1-a",
      "sub_zone": ""
    }
  }
}

把它保存为 bootstrap.json。node.id 应能让控制面稳定识别该客户端;node.locality 是否参与流量优先级取决于控制面下发的资源与负载均衡配置,不能仅凭这些标签推断“同区优先”。

实验项目固定 gRPC-Go 版本,避免依赖漂移影响实验行为。

text
module xds-client-demo

go 1.25

require google.golang.org/grpc v1.83.2

这是 go.mod 的最小内容。首次执行 go run . 时 Go 会解析模块并下载依赖;若运行环境禁止联网,应提前把依赖准备到模块缓存或内部模块代理。

用 xDS 目标创建客户端

下面的主示例调用标准 gRPC Health 服务,因此不需要自定义 proto。程序连续发送 12 次请求,并通过 grpc.Peer 打印每次真正选中的后端地址;控制面若在运行期间替换端点,可以直接观察 peer 变化。

go
package main

import (
    "context"
    "fmt"
    "log"
    "time"

    "google.golang.org/grpc"
    xdscreds "google.golang.org/grpc/credentials/xds"
    "google.golang.org/grpc/credentials/insecure"
    healthpb "google.golang.org/grpc/health/grpc_health_v1"
    "google.golang.org/grpc/peer"
    _ "google.golang.org/grpc/xds"
)

func main() {
    // xDS 下发了安全配置时使用该配置;否则回退到实验用明文后端连接。
    creds, err := xdscreds.NewClientCredentials(xdscreds.ClientOptions{
        FallbackCreds: insecure.NewCredentials(),
    })
    if err != nil {
        log.Fatal(err)
    }

    conn, err := grpc.NewClient(
        "xds:///payments",
        grpc.WithTransportCredentials(creds),
    )
    if err != nil {
        log.Fatal(err)
    }
    defer conn.Close()

    client := healthpb.NewHealthClient(conn)
    for i := 1; i <= 12; i++ {
        ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
        var p peer.Peer

        resp, err := client.Check(
            ctx,
            &healthpb.HealthCheckRequest{},
            grpc.Peer(&p),
        )
        cancel()

        if err != nil {
            fmt.Printf("attempt=%02d err=%v\n", i, err)
            time.Sleep(time.Second)
            continue
        }

        addr := "<unknown>"
        if p.Addr != nil {
            addr = p.Addr.String()
        }
        fmt.Printf("attempt=%02d peer=%s status=%s\n", i, addr, resp.Status)
        time.Sleep(time.Second)
    }
}

预期结果:代码可编译;成功的 Health RPC 会打印实际 peer。端点切换发生在哪一次请求取决于 xDS 更新到达时间、子连接状态和当前负载均衡策略。

运行前让环境变量指向 bootstrap 文件,再启动程序。

bash
export GRPC_XDS_BOOTSTRAP="$PWD/bootstrap.json"
go run .

预期输出

text
attempt=<ID> peer=127.0.0.1:50051 status=SERVING
attempt=<ID> peer=127.0.0.1:50051 status=SERVING
attempt=<ID> peer=127.0.0.1:50052 status=SERVING
attempt=<ID> peer=127.0.0.1:50052 status=SERVING

<ID> 和切换发生在哪一次请求取决于控制面更新时间、连接建立速度与负载均衡策略。关键现象不是固定序号,而是同一个进程、同一个 ClientConn 可以在资源更新后选到新端点。

验证控制面更新是否真正生效

先让 EDS 只返回 127.0.0.1:50051,确认 peer 稳定命中它;程序运行期间把端点集合改为 127.0.0.1:50052,再观察后续 RPC。若控制面同时修改了集群的负载均衡策略,应以一段时间内的 peer 分布变化判断策略是否生效。

如果始终没有请求成功,按顺序检查:进程是否读到了正确的 GRPC_XDS_BOOTSTRAP、是否导入了 google.golang.org/grpc/xds、payments 是否与控制面资源名匹配、客户端是否成功接收并 ACK 相关资源,最后再检查后端地址与传输凭据。这样可以把 bootstrap、资源命名和数据面连通性问题分开定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

让 gRPC 客户端接入 xDS

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

登录哪都通