容器与云原生 / 系统课时
节点与 Pod 亲和性
节点与 Pod 亲和性
当调度规则既要判断节点属性,又要参考其他 Pod 的位置时,需要使用亲和性。本课将组合节点硬约束、节点软偏好和 Pod 共置规则,并通过实际调度结果验证它们的作用。
学习目标
- 区分节点亲和性与 Pod 亲和性的匹配对象
- 正确使用
required与preferred规则 - 根据拓扑键和调度事件定位亲和性失败
亲和性如何参与调度
节点亲和性读取节点标签,用于选择区域、机型或节点池。Pod 亲和性先匹配现有 Pod 的标签,再通过 topologyKey 判断“同一节点”或“同一可用区”等拓扑范围。

requiredDuringSchedulingIgnoredDuringExecution 是硬条件,不满足就无法调度;preferredDuringSchedulingIgnoredDuringExecution 按 weight 加分,但不保证一定满足。IgnoredDuringExecution 表示标签在运行后变化时,不会自动驱逐 Pod。
配置组合规则
示例让 cache 固定到演示节点,再让 web-affinity 必须位于 zone-a、必须与 cache 同节点,并优先选择 SSD 节点。执行前将 <NODE_NAME> 替换为真实节点名。
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预期输出如下:
node/<NODE_NAME> labeled
node/<NODE_NAME> labeled
node/<NODE_NAME> labeled将下面完整配置保存为 affinity-demo.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-alpinenodeSelectorTerms 之间是“或”关系,同一 matchExpressions 列表中的表达式是“与”关系。Pod 亲和性匹配的是 app=cache 标签,并要求目标 Pod 与它具有相同的主机名拓扑值。
验证与故障定位
应用资源并等待两个 Deployment 完成发布:
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 和时间会动态变化:
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。查看调度事件:
kubectl describe pod -l app=web典型事件可能同时指出节点亲和性和 Pod 亲和性不匹配:
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 亲和性,以减少调度计算。