容器与云原生 / 系统课时
解读 EndpointSlice 状态
解读 EndpointSlice 状态
本课解决“Service 已存在但流量为何仍进不到后端”的判断问题。你将从 EndpointSlice 的地址、端口和三个端点条件入手,区分正常可用、尚未就绪与正在终止但仍可服务的端点,避免把它们误当成三个彼此独立的健康探针。
学习目标
- 能使用
kubectl查看 Service 对应的全部 EndpointSlice。 - 能准确解释
ready、serving、terminating的关联语义。 - 能根据字段组合判断故障更可能位于后端就绪、终止流程还是 Service 数据路径。
查看 EndpointSlice 的实际内容
EndpointSlice 保存服务发现所需的端点地址、端口和条件。一个 Service 可能对应多个 EndpointSlice,因此按 kubernetes.io/service-name 标签查询时,应检查返回的全部 items,而不是只盯着某一个地址。
kubectl get endpointslice -l kubernetes.io/service-name=<SERVICE_NAME> -o 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 能回答端点是否被发现、是否可服务和是否正在终止,但不能单独证明整条网络链路一定可达。