容器与云原生 / 系统课时

理解 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 落在哪些拓扑域 → 当前 Pod 如何处理这些域”的顺序推导,而不是把 topologyKey 误解成固定节点名称。

用一个最小示例验证亲和关系

下面的清单先创建 app=cache 的参照 Pod,再创建 api-worker。api-worker 使用 Pod 亲和,要求自己与 cache 位于相同的 kubernetes.io/hostname 拓扑域,也就是同一节点。示例只用于验证关系方向,不展开硬约束与软偏好的差异。

yaml
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 就绪:

bash
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

预期结果

text
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 间关系读对,再继续分析规则强度、调度评分或失败原因,而不需要把整段亲和配置当成固定模板记忆。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Pod 亲和与反亲和

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

登录哪都通