3. Pod亲和性与反亲和性：podAffinity、podAntiAffinity、拓扑键与权重

Pod亲和性与反亲和性是Kubernetes调度器将Pod实例按照业务逻辑进行分组或隔离的核心机制。与节点亲和性（nodeAffinity）不同，Pod亲和性基于已经运行在集群中的Pod标签来决定调度目标，而非节点本身的标签。这一特性在微服务就近部署、可用区容灾、缓存局部性等场景中至关重要。

3.1 核心概念与调度语义

Pod亲和性调度规则定义在Pod规约的 spec.affinity.podAffinity 和 spec.affinity.podAntiAffinity 字段中。调度器在执行调度时，会先根据拓扑键（topologyKey）划分候选节点组，再检查该组内是否已存在满足标签选择器（labelSelector）的Pod，最后根据权重（weight）计算得分。

3.2 拓扑键（topologyKey）—— 分组边界

拓扑键是Pod亲和性规则的分组依据。调度器使用拓扑键对应的节点标签值来划分拓扑域，同一个拓扑域内的节点被视为一个调度单元。常见的拓扑键包括：

• kubernetes.io/hostname —— 以节点为粒度（最严格）
• topology.kubernetes.io/zone —— 以可用区为粒度
• topology.kubernetes.io/region —— 以地域为粒度
• 自定义标签 —— 如 rack、datacenter

3.3 调度策略类型：required vs preferred

与节点亲和性一致，Pod亲和性也分为硬约束（required）和软约束（preferred）两种类型。

3.4 权重（weight）与多规则评分

在 preferredDuringScheduling 中，每条规则可以设置 weight（1~100）。调度器对每个候选节点执行以下评分逻辑：

1. 遍历所有软约束规则，检查节点所在拓扑域是否满足该规则。
2. 如果满足，则在该规则的权重基础上累加得分。
3. 所有规则得分累加后，归一化到 0~100 区间。

权重设计原则：

• 高权重（如 100）用于关键亲和性需求，如缓存与计算同节点。
• 低权重（如 10~30）用于倾向性建议，如尽量分散但允许集中。
• 多个反亲和性规则可以叠加，实现“优先跨可用区，其次跨节点”的分级调度。

3.5 完整配置示例

apiVersion: v1
kind: Pod
metadata:
  name: web-server
  labels:
    app: web
spec:
  affinity:
    podAffinity:
      requiredDuringSchedulingIgnoredDuringExecution:
      - labelSelector:
          matchExpressions:
          - key: app
            operator: In
            values:
            - cache
        topologyKey: kubernetes.io/hostname
    podAntiAffinity:
      preferredDuringSchedulingIgnoredDuringExecution:
      - weight: 100
        podAffinityTerm:
          labelSelector:
            matchExpressions:
            - key: app
              operator: In
              values:
              - web
          topologyKey: topology.kubernetes.io/zone
  containers:
  - name: nginx
    image: nginx:1.25

上述配置含义：

• 硬亲和：web-server 必须与带有 app=cache 标签的 Pod 运行在同一节点上。
• 软反亲和：web-server 尽量不与带有 app=web 标签的 Pod 处于同一可用区，权重为 100。

3.6 调度流程与拓扑域匹配

3.7 实战设计模式与避坑

3.8 拓扑键选择与调度器参数联动

调度器参数 --failure-domains 和 --soft-pod-affinity-weight 会影响Pod亲和性的评分行为。在调度器配置文件中，可以通过 profiles.pluginConfig 调整 InterPodAffinity 插件的参数：

apiVersion: kubescheduler.config.k8s.io/v1
kind: KubeSchedulerConfiguration
profiles:
- schedulerName: default-scheduler
  pluginConfig:
  - name: InterPodAffinity
    args:
      hardPodAffinityWeight: 1          # 硬亲和性权重系数（默认0）
      softPodAffinityWeight: 50         # 软亲和性权重缩放因子（默认0）

• hardPodAffinityWeight：设置为非零值时，硬约束也会参与评分，影响多调度器场景下的优先级排序。
• softPodAffinityWeight：调整软约束评分的整体权重，值越大，软约束对最终调度决策的影响越强。