容器与云原生 / 系统课时

EndpointSlice 后端发现

EndpointSlice 后端发现

Service 能否转发流量,关键不只是对象是否存在,而是控制面是否为它发现了正确的后端端点。本课从 Service、Pod 标签和 EndpointSlice 三处交叉检查,复现一次选择器不匹配故障,并修复到端点恢复可用。

学习目标

  • 理解 Service、标签选择器、Pod 与 EndpointSlice 之间的关联关系
  • 使用 kubectl 判断 EndpointSlice 中是否存在正确的后端端点
  • 根据端点数量快速定位并修复 Service 选择器不匹配问题

EndpointSlice 如何关联 Service 与 Pod

对于带选择器的 Service,EndpointSlice 控制器会根据 spec.selector 寻找符合条件的 Pod,并维护相应的 EndpointSlice。EndpointSlice 通过标签 kubernetes.io/service-name 标识自己属于哪个 Service,其中的 endpoints 保存后端地址和就绪条件。

因此排查 Service 无法访问时,需要同时追踪三个对象:Service 声明了什么选择器、Pod 实际拥有什么标签、EndpointSlice 最终收录了哪些地址。只看 Service 本身无法确认后端发现是否成功。

Service 到 EndpointSlice 的后端发现链路

构造选择器不匹配故障

下面创建两个标签为 app: web 的 Pod,但故意把 Service 的选择器写成 app: backend。Service 可以正常创建,却找不到任何符合条件的后端。

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-discovery
spec:
  replicas: 2
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
        - name: nginx
          image: nginx:1.27
          ports:
            - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: web-discovery
spec:
  selector:
    app: backend
  ports:
    - port: 80
      targetPort: 80

把内容保存为 endpointslice-demo.yaml,创建资源并等待 Pod 就绪。

bash
kubectl apply -f endpointslice-demo.yaml
kubectl rollout status deployment/web-discovery --timeout=120s

预期输出

text
deployment.apps/web-discovery created
service/web-discovery created
deployment "web-discovery" successfully rolled out

沿发现链路定位问题

先读取 Service 实际使用的选择器,再读取 Pod 的真实标签。两个结果一对比,就能发现 backend 与 web 不一致。

bash
kubectl get service web-discovery -o jsonpath='selector={.spec.selector.app}{"\n"}'
kubectl get pods -l app=web -o jsonpath='{range .items[*]}{.metadata.name}{"\tapp="}{.metadata.labels.app}{"\n"}{end}'

预期输出

text
selector=backend
web-discovery-<ID>    app=web
web-discovery-<ID>    app=web

接着直接查看属于该 Service 的 EndpointSlice,并统计每个 Slice 中的端点数量。

bash
kubectl get endpointslice -l kubernetes.io/service-name=web-discovery -o go-template='{{range .items}}{{.metadata.name}}{{"\t"}}{{len .endpoints}}{{"\n"}}{{end}}'

预期输出

text
web-discovery-<ID>    0

EndpointSlice 已经与 Service 建立关联,但端点数为 0,说明问题发生在后端选择阶段,而不是 Service 对象缺失。EndpointSlice 名称中的 <ID> 由集群生成,实际值可能不同。

修复选择器并验证端点

把 Service 的选择器改为与 Pod 标签一致的 app: web。EndpointSlice 控制器会重新计算后端集合,不需要手工填写 Pod IP。

bash
kubectl patch service web-discovery --type=merge -p '{"spec":{"selector":{"app":"web"}}}'
kubectl get endpointslice -l kubernetes.io/service-name=web-discovery -o go-template='{{range .items}}{{.metadata.name}}{{"\t"}}{{len .endpoints}}{{"\n"}}{{end}}'

预期输出

text
service/web-discovery patched
web-discovery-<ID>    2

最后检查端点地址和就绪条件。Deployment 已经完成滚动就绪,因此两个端点应处于可用状态。

bash
kubectl get endpointslice -l kubernetes.io/service-name=web-discovery -o jsonpath='{range .items[*].endpoints[*]}{.addresses[0]}{"\tready="}{.conditions.ready}{"\n"}{end}'

预期输出

text
<IP>    ready=true
<IP>    ready=true

排查这类故障时,可以固定采用“Service 选择器 → Pod 标签 → EndpointSlice 端点”的顺序。如果选择器和标签一致但端点仍异常,再继续检查 Pod 就绪状态、Service 的 targetPort 与应用实际监听端口,这样能避免直接从网络插件等更底层组件开始盲查。

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

目录与阅读设置

阅读设置

17

记录一个想法

EndpointSlice 后端发现

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

登录哪都通