容器与云原生 / 系统课时
理解 Pod 亲和与反亲和
理解 Pod 亲和与反亲和
Pod 亲和与反亲和用“其他 Pod 在哪里”来约束当前 Pod 的放置位置。核心不是记住一长串 YAML 字段,而是先找出参照 Pod,再确定拓扑域,最后判断当前 Pod 是要靠近这些域还是避开这些域。
学习目标
- 说清
labelSelector、参照 Pod 与topologyKey的关系 - 区分 Pod 亲和与 Pod 反亲和的放置方向
- 能从一条规则推导当前 Pod 的候选节点范围
从参照 Pod 推导候选节点
labelSelector 选择的是 Pod,不是节点;topologyKey 也不是直接填写某个节点或可用区名称,而是指定用于划分拓扑域的 节点标签键。调度器先找到满足选择器的参照 Pod,再读取这些 Pod 所在节点上的 topologyKey 标签值,据此确定相关拓扑域。
例如,若 app=cache 的 Pod 运行在某个节点,而 topologyKey 是 kubernetes.io/hostname,那么该节点自身就是一个拓扑域;若使用 topology.kubernetes.io/zone,则同一可用区内具有相同标签值的多个节点属于同一拓扑域。存在多个匹配 Pod 时,可能得到多个相关拓扑域。

因此,判断一条 Pod 间亲和规则时,应沿着“选择器找到哪些 Pod → 这些 Pod 落在哪些拓扑域 → 当前 Pod 如何处理这些域”的顺序推导,而不是把 topologyKey 误解成固定节点名称。
用一个最小示例验证亲和关系
下面的清单先创建 app=cache 的参照 Pod,再创建 api-worker。api-worker 使用 Pod 亲和,要求自己与 cache 位于相同的 kubernetes.io/hostname 拓扑域,也就是同一节点。示例只用于验证关系方向,不展开硬约束与软偏好的差异。
apiVersion: v1
kind: Pod
metadata:
name: cache
labels:
app: cache
spec:
containers:
- name: pause
image: registry.k8s.io/pause:3.10
---
apiVersion: v1
kind: Pod
metadata:
name: api-worker
spec:
affinity:
podAffinity:
requiredDuringSchedulingIgnoredDuringExecution:
- labelSelector:
matchLabels:
app: cache
topologyKey: kubernetes.io/hostname
containers:
- name: worker
image: registry.k8s.io/pause:3.10将清单保存为 pod-affinity.yaml,然后应用并等待两个 Pod 就绪:
kubectl apply -f pod-affinity.yaml
kubectl wait --for=condition=Ready pod/cache pod/api-worker --timeout=60s
kubectl get pod cache api-worker -o custom-columns=NAME:.metadata.name,NODE:.spec.nodeName,STATUS:.status.phase预期结果
pod/cache created
pod/api-worker created
pod/cache condition met
pod/api-worker condition met
NAME NODE STATUS
cache <NODE> Running
api-worker <NODE> Running两个 Pod 的 NODE 应相同;实际节点名会因集群而异。如果重复执行 kubectl apply,第一段输出也可能显示 unchanged 或 configured,这不影响后续验证。
亲和与反亲和只改变关系方向
在已经确定“参照 Pod”和“拓扑域”之后,Pod 亲和与反亲和的区别非常直接:podAffinity 把相关拓扑域视为希望或必须靠近的范围,podAntiAffinity 则把这些域视为希望或必须避开的范围。
所以,同样选择 app=cache,同样使用 kubernetes.io/hostname 时,亲和表达“与 cache 同节点”,反亲和表达“不要与 cache 同节点”。选择器负责回答“看谁”,topologyKey 负责回答“按什么空间范围比较”,亲和或反亲和只负责回答“靠近还是避开”。
掌握这三个问题后,就能先把 Pod 间关系读对,再继续分析规则强度、调度评分或失败原因,而不需要把整段亲和配置当成固定模板记忆。