要实现 Pod 均匀分布到不同拓扑域，K8s 官方推荐使用 TopologySpreadConstraints（拓扑分布约束），它能精准控制 Pod 在节点、可用区、机架等不同粒度的拓扑域间均衡部署，比传统的 Pod 反亲和性更灵活、更强大。
一、核心原理
通过指定 拓扑键（topologyKey） 定义拓扑域粒度，设置 Pod 数量差值上限（maxSkew），强制要求同一应用的 Pod 在各拓扑域间的数量差不超过阈值，从而实现均匀分布。
二、关键参数详解
| 参数 | 作用 | 取值说明 |
|---|---|---|
topologyKey |
定义拓扑域的划分依据（必须是 Node 上存在的标签） | 常用值：- kubernetes.io/hostname（节点级，最常用）- topology.kubernetes.io/zone（可用区级，多可用区集群）- topology.kubernetes.io/region（地域级） |
maxSkew |
任意两个拓扑域间的 最大 Pod 数量差值 | 取值为正整数，推荐设为 1（最优均匀度） |
whenUnsatisfiable |
不满足分布约束时的处理策略 | - DoNotSchedule：硬策略，不满足则 Pod 不调度（核心业务用）- ScheduleAnyway：软策略，优先均匀分布，不满足也能调度（非核心业务用） |
labelSelector |
匹配需要均匀分布的 Pod 标签 | 必须和应用的 Pod 标签一致（如 app: my-app） |
三、配置示例
场景 1：Pod 均匀分布到不同节点（单集群高可用）
适用于单可用区集群，确保同一应用的 Pod 分散在不同 Node，避免节点故障导致服务中断。
apiVersion: apps/v1
kind: Deployment
metadata:name: my-appnamespace: default
spec:replicas: 5 # 5 个副本，均匀分布到多个节点selector:matchLabels:app: my-apptemplate:metadata:labels:app: my-app # 和 labelSelector 匹配spec:topologySpreadConstraints:- maxSkew: 1 # 任意节点间 Pod 数差值 ≤1topologyKey: kubernetes.io/hostname # 拓扑域粒度：节点whenUnsatisfiable: DoNotSchedule # 硬策略：不满足则不调度labelSelector:matchLabels:app: my-app # 匹配当前应用的 Podcontainers:- name: my-appimage: nginx:alpine
效果：5 个 Pod 会均匀分布到所有可用节点，比如 3 个节点的集群会按 2:2:1 分配。
场景 2：Pod 均匀分布到不同可用区（多可用区容灾）
适用于云厂商多可用区集群，确保 Pod 跨可用区分布，提升容灾能力。
spec:template:spec:topologySpreadConstraints:# 约束1：跨可用区均匀分布（优先）- maxSkew: 1topologyKey: topology.kubernetes.io/zone # 拓扑域粒度：可用区whenUnsatisfiable: DoNotSchedulelabelSelector:matchLabels:app: my-app# 约束2：跨节点均匀分布（次级）- maxSkew: 1topologyKey: kubernetes.io/hostname # 拓扑域粒度：节点whenUnsatisfiable: ScheduleAnyway # 软策略：优先均匀，不满足也调度labelSelector:matchLabels:app: my-app
效果：Pod 优先按可用区均匀分布，再在每个可用区内按节点均匀分布。
场景 3：配合 PDB 实现高可用（生产必配）
拓扑分布约束 + PDB 组合，既保证均匀分布，又防止运维操作导致服务中断
# 1. Deployment 配置拓扑分布约束
apiVersion: apps/v1
kind: Deployment
metadata:name: my-app
spec:replicas: 4selector:matchLabels: {app: my-app}template:metadata: {labels: {app: my-app}}spec:topologySpreadConstraints:- maxSkew: 1topologyKey: kubernetes.io/hostnamewhenUnsatisfiable: DoNotSchedulelabelSelector: {matchLabels: {app: my-app}}containers: [{name: my-app, image: nginx:alpine}]
---
# 2. PDB 配置：最多不可用 1 个 Pod
apiVersion: policy/v1
kind: PodDisruptionBudget
metadata:name: my-app-pdb
spec:maxUnavailable: 1selector:matchLabels: {app: my-app}