容器与云原生 / 系统课时
拓扑分布约束
拓扑分布约束
当一个应用有多个副本时,只靠默认调度可能把 Pod 集中到少数节点或同一可用区。本课使用 topologySpreadConstraints 声明“尽量均匀分散”的规则,并通过 maxSkew 与不可满足策略控制调度边界,最终能验证副本是否真正跨拓扑域分布。
学习目标
- 理解
topologyKey、maxSkew、labelSelector如何共同计算分布偏差。 - 为 Deployment 配置跨可用区的拓扑分布约束。
- 识别
DoNotSchedule与ScheduleAnyway的适用差异。
分布约束如何参与调度
调度器先用 labelSelector 找出属于同一应用的 Pod,再按 topologyKey 把可用节点划分成多个拓扑域,例如不同可用区。它比较各域内匹配 Pod 的数量,并用 maxSkew 限制最拥挤域与最稀疏域之间允许出现的最大差值。

whenUnsatisfiable 决定规则无法满足时怎么处理。DoNotSchedule 会阻止产生超出偏差上限的新调度;ScheduleAnyway 仍允许调度,只把均匀分布作为优先级。需要高可用隔离时通常选前者,需要保证副本尽快启动时可考虑后者。
配置跨可用区分布
下面示例假设集群至少有三个可调度节点,并且节点已经带有 topology.kubernetes.io/zone 标签。Deployment 创建 6 个副本,并要求同一应用在不同可用区之间的数量差不超过 1。
apiVersion: apps/v1
kind: Deployment
metadata:
name: spread-demo
spec:
replicas: 6
selector:
matchLabels:
app: spread-demo
template:
metadata:
labels:
app: spread-demo
spec:
topologySpreadConstraints:
- maxSkew: 1
topologyKey: topology.kubernetes.io/zone
whenUnsatisfiable: DoNotSchedule
labelSelector:
matchLabels:
app: spread-demo
containers:
- name: web
image: nginx:1.27
ports:
- containerPort: 80将配置保存为 topology-spread.yaml 后应用:
kubectl apply -f topology-spread.yaml
kubectl rollout status deployment/spread-demo预期输出:
deployment.apps/spread-demo created
deployment "spread-demo" successfully rolled out如果 Deployment 已存在,第一行可能显示 configured 或 unchanged,这是正常结果。
验证 Pod 是否跨域分散
先查看 Pod 被分配到哪些节点,再查看这些节点对应的可用区标签。
kubectl get pods -l app=spread-demo -o wide
kubectl get nodes -L topology.kubernetes.io/zone预期结果:
NAME READY STATUS NODE
spread-demo-<ID> 1/1 Running <VALUE>
spread-demo-<ID> 1/1 Running <VALUE>
spread-demo-<ID> 1/1 Running <VALUE>
spread-demo-<ID> 1/1 Running <VALUE>
spread-demo-<ID> 1/1 Running <VALUE>
spread-demo-<ID> 1/1 Running <VALUE>
NAME STATUS ROLES ZONE
<VALUE> Ready <VALUE> zone-a
<VALUE> Ready <VALUE> zone-b
<VALUE> Ready <VALUE> zone-cPod 名和节点名会随集群而变化。结合两段输出统计每个 zone 中的副本数;在三个拓扑域都可用且无其他调度限制时,6 个副本通常会形成 2、2、2 的分布。
处理常见边界
拓扑分布约束不是强制“每个域必须至少一个 Pod”。如果某个域没有可用节点、节点存在不可容忍污点,或资源不足,调度器只能在符合全部约束的节点中选择。严格使用 DoNotSchedule 时,部分 Pod 可能保持 Pending,这比为了凑足副本而破坏故障域隔离更符合规则语义。
labelSelector 还必须与 Pod 模板标签匹配,否则调度器无法把已有副本纳入同一组计数。排查分布异常时,应同时检查 Pod 标签、节点拓扑标签和事件中的调度失败原因,而不是只看 Deployment 的副本数。