容器与云原生 / 系统课时

识别无端点的 Service

识别无端点的 Service

本课解决的是“Service 看起来正常,但 EndpointSlice 没有可用后端”时如何快速定性。重点不再重复完整的 Service→Pod 检查链,而是先用 EndpointSlice 的地址与条件判断故障属于发现、就绪还是端口解析,再只对命中的分支补证据。

学习目标

  • 能用 EndpointSlice 的地址与 conditions 区分“无地址”和“已有地址但不可服务”。
  • 能在 selector 已匹配 Pod 时继续识别命名 targetPort、Pod IP 等导致端点缺失的原因。
  • 能根据证据决定修 selector、修端口定义,还是转向就绪状态与网络路径排查。

先按 EndpointSlice 证据分类

对于带 selector 的普通 Service,EndpointSlice 是判断“后端地址有没有形成”的直接证据。先看切片中是否存在地址,再看 ready、serving、terminating,比从 Service、Pod 重新顺序排查更快。

现场证据 结论 下一步
没有 EndpointSlice,或切片没有任何地址 真正的“无端点”候选 检查 selector、Pod IP、命名 targetPort 解析
有地址,但 ready=false 后端已被发现,不是“无端点” 检查 Pod Ready、readiness probe、终止状态
有地址且条件正常,请求仍失败 服务发现已完成 转向应用监听、端口映射、NetworkPolicy、kube-proxy 或 CNI

Service 没有 .spec.selector 时,控制面不会根据 Pod 自动维护 EndpointSlice;ExternalName 则通过 DNS CNAME 工作。这两类对象即使没有由 Pod 自动生成的端点,也不能直接判定为服务发现故障。

如果 Service 设置了 publishNotReadyAddresses: true,端点就绪条件的解释会不同,不能仅凭 ready 判断 Pod 的真实就绪状态;此时还要回看 Pod 自身状态与 Service 配置。

无端点 Service 的故障分类与排查分支

一次采集只回答三个问题

下面的命令只围绕三个问题取证:Service 是否自动选 Pod、是否有匹配 Pod、EndpointSlice 是否形成地址。将占位符替换为现场值;<SELECTOR> 使用 Service 的完整 selector,例如 app=api,tier=backend。

bash
NAMESPACE='<NAMESPACE>'
SERVICE_NAME='<SERVICE_NAME>'
SELECTOR='<SELECTOR>'

kubectl -n "$NAMESPACE" get svc "$SERVICE_NAME"   -o jsonpath='type={.spec.type}{"\t"}selector={.spec.selector}{"\t"}publishNotReady={.spec.publishNotReadyAddresses}{"\n"}{range .spec.ports[*]}port={.port}{"\t"}targetPort={.targetPort}{"\n"}{end}'

kubectl -n "$NAMESPACE" get pods -l "$SELECTOR" -o wide --show-labels

kubectl -n "$NAMESPACE" get endpointslice   -l kubernetes.io/service-name="$SERVICE_NAME" -o wide

kubectl -n "$NAMESPACE" get endpointslice   -l kubernetes.io/service-name="$SERVICE_NAME"   -o jsonpath='{range .items[*].endpoints[*]}address={.addresses[0]}{"\t"}ready={.conditions.ready}{"\t"}serving={.conditions.serving}{"\t"}terminating={.conditions.terminating}{"\n"}{end}'

预期输出(以下示例表示 selector 没有匹配任何 Pod,因此切片中也没有后端地址;实际名称、时间和 ID 会不同):

text
type=ClusterIP	selector=map[app:api]	publishNotReady=false
port=80	targetPort=8080

No resources found in <NAMESPACE> namespace.

NAME                  ADDRESSTYPE   PORTS   ENDPOINTS   AGE
<SERVICE_NAME>-<ID>   IPv4          8080    <none>      <TIME>

最后一条 JSONPath 命令在没有 endpoint 时不会输出任何行。不同版本和协调时机下,也可能暂时看不到对应 EndpointSlice;关键判断仍是“当前没有任何后端地址”,而不是某个固定的表格形态。

无地址时只检查会阻止端点形成的条件

如果 selector 根本匹配不到 Pod,优先比较 Service 的 .spec.selector 与目标 Pod labels,检查键、值、大小写和命名空间。修正 selector 或 Pod 标签后,EndpointSlice 控制器会重新协调,不要手工编辑自动管理的切片。

如果 selector 已经匹配 Pod,却仍没有地址,就不要把“控制器坏了”当作唯一解释。至少继续核对两类会阻断端点形成的条件:Pod 是否拥有可用的 Pod IP,以及 Service 使用命名 targetPort 时,该名称是否真的存在于目标 Pod 的容器端口中。数值型 targetPort 即使指错应用实际监听端口,通常也不会让已经匹配到的 Pod 地址消失;它更常表现为端点存在但连接失败。

下面只在 targetPort 是名称时使用,用于核对 Pod 实际声明的端口名。

bash
NAMESPACE='<NAMESPACE>'
SELECTOR='<SELECTOR>'

kubectl -n "$NAMESPACE" get pods -l "$SELECTOR"   -o jsonpath='{range .items[*]}pod={.metadata.name}{"\t"}podIP={.status.podIP}{"\t"}{range .spec.containers[*].ports[*]}{.name}{":"}{.containerPort}{" "}{end}{"\n"}{end}'

预期输出:

text
pod=<POD_NAME>	podIP=<POD_IP>	http:8080

如果 Service 写的是 targetPort: web,而 Pod 只声明了 http:8080,应修正端口名使两边一致;如果 Pod 没有 Pod IP,则应先处理 Pod 本身的调度、网络或生命周期问题。

地址已经存在就停止排查“无端点”

EndpointSlice 已有 Pod IP 时,说明发现链已经完成。此时 ready=false 应转向 Pod Ready、readiness probe、终止状态,以及 ready、serving、terminating 条件的组合,而不是继续修改 selector。

修复后重新查看 EndpointSlice,验收标准是切片出现预期 Pod IP;用于普通流量的后端还应满足当前 Service 配置下的可服务条件。

bash
NAMESPACE='<NAMESPACE>'
SERVICE_NAME='<SERVICE_NAME>'

kubectl -n "$NAMESPACE" get endpointslice   -l kubernetes.io/service-name="$SERVICE_NAME" -o wide

预期输出:

text
NAME                  ADDRESSTYPE   PORTS   ENDPOINTS   AGE
<SERVICE_NAME>-<ID>   IPv4          8080    <POD_IP>    <TIME>

识别无端点故障的关键是先回答“EndpointSlice 里到底有没有地址”。没有地址时只追查会阻止端点形成的条件;地址已经存在,就立刻把排查重心移到就绪、端口监听和网络路径,避免在 selector 上反复兜圈。

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

目录与阅读设置

记录一个想法

识别无端点的 Service

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

登录哪都通