4. Pod 拓扑分布约束（Topology Spread Constraints）

Pod 拓扑分布约束是 Kubernetes 提供的一种精细化调度策略，允许管理员控制 Pod 在集群故障域（如可用区、节点、地域）之间的分布均匀性。通过合理配置，可以显著提升应用的高可用性和资源利用率，避免单点故障或资源倾斜。

4.1 核心参数详解

拓扑分布约束通过 spec.topologySpreadConstraints 字段定义，每个约束包含以下三个核心参数：

maxSkew（最大倾斜度）

定义在同一个拓扑域内，任意两个拓扑域之间 Pod 数量的最大差值。例如 maxSkew: 1 表示任意两个可用区的 Pod 数量差不能超过 1。该值越小，分布越严格，但可能导致调度失败。

topologyKey（拓扑键）

指定节点标签的键名，Kubernetes 根据该键的值将节点分组为不同的拓扑域。常用值包括：

• topology.kubernetes.io/zone —— 可用区（推荐）
• topology.kubernetes.io/region —— 地域
• kubernetes.io/hostname —— 节点级别
• 自定义标签键，如 rack、datacenter

whenUnsatisfiable（不满足时的行为）

4.2 跨可用区均匀分布配置

以下是一个完整的 Deployment 配置示例，实现 3 副本 Pod 在 3 个可用区之间均匀分布：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      topologySpreadConstraints:
        - maxSkew: 1
          topologyKey: topology.kubernetes.io/zone
          whenUnsatisfiable: DoNotSchedule
          labelSelector:
            matchLabels:
              app: web
      containers:
        - name: nginx
          image: nginx:1.25

4.3 拓扑分布约束工作流程

4.4 多约束组合与高级配置

一个 Pod 可以同时定义多个拓扑分布约束，实现多维度均匀分布。例如同时约束可用区和节点级别：

topologySpreadConstraints:
  - maxSkew: 1
    topologyKey: topology.kubernetes.io/zone
    whenUnsatisfiable: DoNotSchedule
    labelSelector:
      matchLabels:
        app: web
  - maxSkew: 2
    topologyKey: kubernetes.io/hostname
    whenUnsatisfiable: ScheduleAnyway
    labelSelector:
      matchLabels:
        app: web

4.5 常见问题与排查

4.6 跨可用区均匀分布效果示意