3、拓扑分布约束（TopologySpreadConstraints）基础：定义、作用、与故障域的关系、在Helm Values中的配置入口

3.1 什么是拓扑分布约束

拓扑分布约束（TopologySpreadConstraints）是 Kubernetes 自 1.19（GA 于 1.24）引入的一种 Pod 调度策略，它允许用户显式控制同一工作负载的 Pod 在集群拓扑域之间的分布均匀性。与 PodAntiAffinity 的“硬性不共位”不同，拓扑分布约束提供的是“尽量均匀分布”的软性约束，并且支持跨任意拓扑键（如 kubernetes.io/hostname、topology.kubernetes.io/zone）进行分布计算。

3.2 拓扑分布约束的作用

• 提升可用性：将 Pod 分散到不同节点或可用区，避免单点故障导致整个服务不可用。
• 优化资源利用率：防止 Pod 堆积在少数节点上，造成局部资源争抢而其他节点空闲。
• 实现精细化故障域隔离：相比 PodAntiAffinity 的“一对一”限制，拓扑分布约束支持“一对多”的均匀分布，更适合大规模集群。
• 降低调度冲突：当多个工作负载同时使用 PodAntiAffinity 时，容易产生调度死锁；拓扑分布约束的软性特性可缓解此问题。

3.3 拓扑分布约束与故障域的关系

故障域（Failure Domain）是集群中可能同时发生故障的一组资源集合。常见的故障域层级包括：

拓扑分布约束通过指定 topologyKey 来定义“按什么维度进行分布”，从而将 Pod 隔离到不同的故障域中。例如，使用 topology.kubernetes.io/zone 作为拓扑键，可以确保 Pod 均匀分布在多个可用区，实现跨 AZ 的故障域隔离。

3.4 拓扑分布约束的配置结构

一个完整的拓扑分布约束配置包含以下字段：

3.5 在 Helm Values 中的配置入口

在 Helm Chart 中，拓扑分布约束通常通过 values.yaml 暴露为可配置项，然后在 Deployment 或 StatefulSet 模板中通过模板语法渲染。以下是标准的配置入口模式：

3.5.1 values.yaml 中的定义

# values.yaml
topologySpreadConstraints:
  enabled: true
  constraints:
    - maxSkew: 1
      topologyKey: topology.kubernetes.io/zone
      whenUnsatisfiable: DoNotSchedule
      labelSelector:
        matchLabels:
          app: "{{ .Chart.Name }}"
    - maxSkew: 2
      topologyKey: kubernetes.io/hostname
      whenUnsatisfiable: ScheduleAnyway
      labelSelector:
        matchLabels:
          app: "{{ .Chart.Name }}"

3.5.2 Deployment 模板中的渲染

{{- if .Values.topologySpreadConstraints.enabled }}
{{- range .Values.topologySpreadConstraints.constraints }}
      topologySpreadConstraints:
        - maxSkew: {{ .maxSkew }}
          topologyKey: {{ .topologyKey }}
          whenUnsatisfiable: {{ .whenUnsatisfiable }}
          labelSelector:
            matchLabels:
              {{- range $key, $value := .labelSelector.matchLabels }}
              {{ $key }}: {{ $value | quote }}
              {{- end }}
{{- end }}
{{- end }}

3.6 多约束组合示例

以下是一个同时使用两个拓扑分布约束的完整示例，实现跨可用区和跨节点的双重故障域隔离：

3.7 常见配置陷阱与避坑

3.8 生产环境推荐配置模板

# values.yaml 生产推荐配置
topologySpreadConstraints:
  enabled: true
  constraints:
    # 硬约束：跨可用区均匀分布
    - maxSkew: 1
      topologyKey: topology.kubernetes.io/zone
      whenUnsatisfiable: DoNotSchedule
      labelSelector:
        matchLabels:
          app: "{{ .Chart.Name }}"
    # 软约束：跨节点尽量分散
    - maxSkew: 2
      topologyKey: kubernetes.io/hostname
      whenUnsatisfiable: ScheduleAnyway
      labelSelector:
        matchLabels:
          app: "{{ .Chart.Name }}"