容器与云原生 / 系统课时

理解 Kubernetes Service DNS 名称

理解 Kubernetes Service DNS 名称

本课解决 Service 名称在不同 Namespace 中为什么会解析出不同结果的问题。重点不是记住几种字符串写法,而是理解客户端 Pod 的 DNS search path 如何参与解析,并用实际 Pod 的解析环境验证目标 Service。

学习目标

  • 识别 Service 短名称、命名空间限定名称和完整集群 DNS 名称的差异
  • 理解 api 与 api.backend 分别如何依赖客户端 Pod 的 DNS search path
  • 能在实际请求 Pod 中验证名称解析、Namespace 与 Service ClusterIP 的关系

三种名称的解析条件

假设普通 ClusterIP Service 名为 api,位于 backend Namespace,示例集群域为默认的 cluster.local。常见写法是 api、api.backend 和 api.backend.svc.cluster.local,但它们不是彼此等价的绝对名称。

写法 DNS 语义 关键依赖
api 单标签相对名称 依赖客户端 Namespace 对应的 search 域,通常先尝试当前 Namespace 下的同名 Service
api.backend 两标签相对名称 仍依赖 resolver 的 search 域补全为 Service DNS 名称
api.backend.svc.cluster.local 已显式写出 Service 域和集群域的名称 通常可定位目标 Service,但在常见 ndots 配置下仍可能先尝试 search 后缀
api.backend.svc.cluster.local. 绝对 DNS 名称 末尾的点表示不再追加 search 后缀

因此,短名称 api 的含义包含“从客户端所在 Namespace 开始搜索”这一隐含条件;api.backend 虽然写出了 Namespace,也仍是相对名称。只有在客户端 resolver 的 search 域符合预期时,它才会自然补全到 api.backend.svc.cluster.local。Pod 使用自定义 dnsPolicy、dnsConfig 或非标准 resolver 配置时,这些假设都需要重新验证。

search path 如何参与解析

位于 frontend Namespace 的普通 Pod,/etc/resolv.conf 常见的 search 顺序类似 frontend.svc.cluster.local svc.cluster.local cluster.local。查询 api 时,resolver 会结合这些 search 域尝试名称,因此通常先寻找 frontend Namespace 中的 api,不会自动推断你想访问 backend/api。

查询 api.backend 时,resolver 仍把它作为相对名称处理,并可借助 svc.cluster.local search 域得到 api.backend.svc.cluster.local。完整名称已经显式包含集群域;如果排障时希望排除 search path 对查询顺序的影响,可以在末尾加点写成 api.backend.svc.cluster.local.。

Kubernetes Service DNS 名称与 Namespace 解析关系

在实际 Pod 中验证解析

排障应尽量在真正发起请求的 Pod 内执行,因为 Namespace、dnsPolicy、dnsConfig 和 /etc/resolv.conf 都属于客户端解析环境。下面把配置检查和三层名称查询合并为一个主示例;示例假设集群域是 cluster.local,实际环境不同应替换相应域名,并确保容器中提供 nslookup。

bash
kubectl exec -n frontend <POD> -- cat /etc/resolv.conf
kubectl get svc api -n backend -o wide
kubectl exec -n frontend <POD> -- nslookup api
kubectl exec -n frontend <POD> -- nslookup api.backend
kubectl exec -n frontend <POD> -- nslookup api.backend.svc.cluster.local
kubectl exec -n frontend <POD> -- nslookup api.backend.svc.cluster.local.

预期结果

text
search frontend.svc.cluster.local svc.cluster.local cluster.local
nameserver <DNS_SERVICE_IP>
options ndots:<VALUE>

NAME   TYPE        CLUSTER-IP                       PORT(S)
api    ClusterIP   <BACKEND_SERVICE_CLUSTER_IP>     <PORT>/TCP

api
<LOOKUP_FAILURE_IF_FRONTEND_API_DOES_NOT_EXIST>

api.backend
Address: <BACKEND_SERVICE_CLUSTER_IP>

api.backend.svc.cluster.local
Address: <BACKEND_SERVICE_CLUSTER_IP>

api.backend.svc.cluster.local.
Address: <BACKEND_SERVICE_CLUSTER_IP>

不同 nslookup 实现的文字格式可能不同,实际 nameserver、ndots、端口和 IP 也会变化。这里应关注解析关系:如果 frontend 中没有 api,短名称失败并不表示 backend/api 不存在;明确包含 backend 的名称在标准 Pod DNS 配置中应能定位目标 Service。

根据失败位置判断原因

如果 api 失败,而 api.backend 和完整名称成功,通常只是短名称按客户端 frontend Namespace 查找,没有命中 backend/api。这属于名称使用方式问题,不是 Service 本身故障。

如果 api.backend 失败,但 api.backend.svc.cluster.local. 成功,应重点检查 /etc/resolv.conf 的 search 域、dnsPolicy 和自定义 dnsConfig。这正说明 api.backend 的可用性依赖 resolver 的搜索规则。

如果绝对名称也解析失败,并且 kubectl get svc api -n backend 已确认 Service 存在,再继续检查集群 DNS 服务、Pod 到 DNS 服务的网络连通性以及对应 DNS 记录。

选择合适的名称

只访问同一 Namespace 时,短名称最简洁,但它把客户端 Namespace 作为隐含条件。跨 Namespace 调用在标准 Pod DNS 环境中可以使用 api.backend;如果用于排障,或运行环境可能修改 search path,应优先用完整集群 DNS 名称建立基线,必要时再使用末尾带点的绝对名称排除 resolver 搜索行为。

核心规则是:Service 名称描述目标,而相对名称能否找到目标还取决于客户端的 DNS 解析环境。 看到名称解析失败时,应先确认客户端 Namespace 与 search path,再判断 Service 或集群 DNS 是否真的异常。

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

目录与阅读设置

记录一个想法

理解 Kubernetes Service DNS 名称

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

登录哪都通