容器与云原生 / 系统课时

节点与 Pod 亲和性

节点与 Pod 亲和性

当调度规则既要判断节点属性,又要参考其他 Pod 的位置时,需要使用亲和性。本课将组合节点硬约束、节点软偏好和 Pod 共置规则,并通过实际调度结果验证它们的作用。

学习目标

  • 区分节点亲和性与 Pod 亲和性的匹配对象
  • 正确使用 required 与 preferred 规则
  • 根据拓扑键和调度事件定位亲和性失败

亲和性如何参与调度

节点亲和性读取节点标签,用于选择区域、机型或节点池。Pod 亲和性先匹配现有 Pod 的标签,再通过 topologyKey 判断“同一节点”或“同一可用区”等拓扑范围。

节点亲和性与 Pod 亲和性的调度决策链路

requiredDuringSchedulingIgnoredDuringExecution 是硬条件,不满足就无法调度;preferredDuringSchedulingIgnoredDuringExecution 按 weight 加分,但不保证一定满足。IgnoredDuringExecution 表示标签在运行后变化时,不会自动驱逐 Pod。

配置组合规则

示例让 cache 固定到演示节点,再让 web-affinity 必须位于 zone-a、必须与 cache 同节点,并优先选择 SSD 节点。执行前将 <NODE_NAME> 替换为真实节点名。

bash
kubectl label node <NODE_NAME> topology.kubernetes.io/zone=zone-a --overwrite
kubectl label node <NODE_NAME> example.com/storage-tier=ssd --overwrite
kubectl label node <NODE_NAME> example.com/cache-host=true --overwrite

预期输出如下:

text
node/<NODE_NAME> labeled
node/<NODE_NAME> labeled
node/<NODE_NAME> labeled

将下面完整配置保存为 affinity-demo.yaml:

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: cache
spec:
  replicas: 1
  selector:
    matchLabels:
      app: cache
  template:
    metadata:
      labels:
        app: cache
    spec:
      nodeSelector:
        example.com/cache-host: "true"
      containers:
        - name: cache
          image: nginx:1.27-alpine
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-affinity
spec:
  replicas: 2
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
              - matchExpressions:
                  - key: topology.kubernetes.io/zone
                    operator: In
                    values:
                      - zone-a
          preferredDuringSchedulingIgnoredDuringExecution:
            - weight: 80
              preference:
                matchExpressions:
                  - key: example.com/storage-tier
                    operator: In
                    values:
                      - ssd
        podAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            - labelSelector:
                matchLabels:
                  app: cache
              namespaces:
                - default
              topologyKey: kubernetes.io/hostname
      containers:
        - name: web
          image: nginx:1.27-alpine

nodeSelectorTerms 之间是“或”关系,同一 matchExpressions 列表中的表达式是“与”关系。Pod 亲和性匹配的是 app=cache 标签,并要求目标 Pod 与它具有相同的主机名拓扑值。

验证与故障定位

应用资源并等待两个 Deployment 完成发布:

bash
kubectl apply -f affinity-demo.yaml
kubectl rollout status deployment/cache --timeout=120s
kubectl rollout status deployment/web-affinity --timeout=120s
kubectl get pods -o wide -l 'app in (cache,web)'

预期结果中,cache 与两个 web Pod 的 NODE 列相同;名称、IP 和时间会动态变化:

text
deployment.apps/cache created
deployment.apps/web-affinity created
deployment "cache" successfully rolled out
deployment "web-affinity" successfully rolled out
NAME                  READY   STATUS    AGE      IP     NODE
cache-<ID>            1/1     Running   <TIME>   <IP>   <NODE_NAME>
web-affinity-<ID>     1/1     Running   <TIME>   <IP>   <NODE_NAME>
web-affinity-<ID>     1/1     Running   <TIME>   <IP>   <NODE_NAME>

如果 cache 尚未运行、命名空间不一致、拓扑键缺失,或没有节点同时满足硬条件,web-affinity 会保持 Pending。查看调度事件:

bash
kubectl describe pod -l app=web

典型事件可能同时指出节点亲和性和 Pod 亲和性不匹配:

text
Warning  FailedScheduling  <TIME>  default-scheduler  0/<N> nodes are available: <N1> node(s) didn't match Pod's node affinity/selector, <N2> node(s) didn't match pod affinity rules.

排查时依次检查节点标签、目标 Pod 标签、namespaces 和 topologyKey。规则过严容易形成无可用节点;需要分散副本时,应使用 Pod 反亲和性或拓扑分布约束。大规模集群中也应避免不必要的复杂 Pod 亲和性,以减少调度计算。

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

目录与阅读设置

阅读设置

17

记录一个想法

节点与 Pod 亲和性

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

登录哪都通