容器与云原生 / 系统课时

解读 EndpointSlice 状态

解读 EndpointSlice 状态

本课解决“Service 已存在但流量为何仍进不到后端”的判断问题。你将从 EndpointSlice 的地址、端口和三个端点条件入手,区分正常可用、尚未就绪与正在终止但仍可服务的端点,避免把它们误当成三个彼此独立的健康探针。

学习目标

  • 能使用 kubectl 查看 Service 对应的全部 EndpointSlice。
  • 能准确解释 ready、serving、terminating 的关联语义。
  • 能根据字段组合判断故障更可能位于后端就绪、终止流程还是 Service 数据路径。

查看 EndpointSlice 的实际内容

EndpointSlice 保存服务发现所需的端点地址、端口和条件。一个 Service 可能对应多个 EndpointSlice,因此按 kubernetes.io/service-name 标签查询时,应检查返回的全部 items,而不是只盯着某一个地址。

bash
kubectl get endpointslice -l kubernetes.io/service-name=<SERVICE_NAME> -o yaml

预期结果

yaml
apiVersion: v1
kind: List
items:
- apiVersion: discovery.k8s.io/v1
  kind: EndpointSlice
  metadata:
    name: <SLICE_NAME>
    labels:
      kubernetes.io/service-name: <SERVICE_NAME>
  addressType: IPv4
  endpoints:
  - addresses:
    - <POD_IP>
    conditions:
      ready: true
      serving: true
      terminating: false
    targetRef:
      kind: Pod
      name: <POD_NAME>
  - addresses:
    - <TERMINATING_POD_IP>
    conditions:
      ready: false
      serving: true
      terminating: true
    targetRef:
      kind: Pod
      name: <TERMINATING_POD_NAME>
  ports:
  - name: http
    port: <PORT>
    protocol: TCP
metadata: {}

实际切片数量、端点数量、IP、名称和端口会不同。这个示例故意同时放入一个正常端点和一个正在终止但仍可服务的端点,用来观察三个条件的差异。

正确理解三个端点条件

serving 表示端点当前是否具备接收流量的能力。对于由 EndpointSlice 控制器管理、以 Pod 为后端的端点,它对应 Pod 的 Ready 条件;即使 Pod 已经进入终止流程,serving 仍会保留这层“此刻是否还能服务”的信息,因此它主要用于描述终止期间的可服务状态,而不是一套独立健康探针。

terminating 只描述生命周期:端点对应的 Pod 已经进入终止流程。它不表示应用一定已经停止服务,也不表示该端点应继续接收普通新流量。Service 代理通常会忽略终止端点,但在所有可用端点都处于终止状态等场景下,实现可以选择把流量路由到同时满足 serving=true、terminating=true 的端点。

ready 更适合看作“可按常规 Service 流量语义使用”的快捷状态。一般情况下,端点应在 serving=true 且 terminating=false 时为 ready=true;终止端点的 ready 会变为 false,这样普通流量不会继续把它当作正常活跃副本。若 Service 设置 spec.publishNotReadyAddresses=true,ready 会被特殊处理为 true,排障时必须同时检查 Service 配置。

因此,三个字段不是三个并列的健康探针:serving 描述能否服务,terminating 描述是否正在退出,ready 则把这两类信息压缩成普通 Service 消费者最常用的判断。

ready serving terminating 含义
true true false 正常就绪,可作为常规 Service 端点
false false false 端点已发现,但后端当前未就绪
false true true 正在终止,但后端此刻仍可服务,常见于连接排空阶段
false false true 正在终止,且已经不再具备服务能力

按固定顺序判断故障方向

排障时先确认 addresses 与 ports。有地址只说明服务发现记录存在;端口还需要与 Service 的 targetPort 和应用实际监听保持一致。若一个 Service 对应多个 EndpointSlice,应把所有切片一起看,避免漏掉另一组端点。

接着看 ready。如果所有端点都为 ready=false,问题通常已经从“Service 没找到后端”收敛到“后端没有达到常规可用条件”,应继续检查 Pod 的 Readiness Probe、Readiness Gates、容器状态和应用监听,同时确认是否存在终止端点或 publishNotReadyAddresses 例外。

如果看到 terminating=true,再看 serving。serving=true 表示终止过程中的后端仍具备服务能力,这类组合主要用于优雅终止和连接排空;不要因为地址仍在 EndpointSlice 中,就把它当成普通活跃副本。

最后,如果端点为 ready=true 但请求仍失败,EndpointSlice 已经证明“服务发现和常规端点就绪信息基本成立”,此时应继续检查 Service 端口映射、应用监听、kube-proxy 或其他 Service 实现,以及 CNI 数据路径。EndpointSlice 能回答端点是否被发现、是否可服务和是否正在终止,但不能单独证明整条网络链路一定可达。

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

目录与阅读设置

记录一个想法

解读 EndpointSlice 状态

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

登录哪都通