📚 课程目录第4章 Pod亲和性与反亲和性

4. Pod亲和性与反亲和性：podAffinity、podAntiAffinity、拓扑键（topologyKey）概念

Pod 亲和性与反亲和性是 Kubernetes 调度系统中用于控制 Pod 之间相对位置的核心机制。与节点亲和性（nodeAffinity）不同，Pod 亲和性规则不是基于节点标签，而是基于集群中已经运行的其他 Pod 的标签来决定调度目标。这使得调度器能够实现“将同类服务部署在一起”或“将冲突服务分散部署”等高级策略。

4.1 核心概念与作用

Pod 亲和性（podAffinity）用于表达“我希望与某些 Pod 运行在同一个拓扑域中”；Pod 反亲和性（podAntiAffinity）则表达“我希望避免与某些 Pod 运行在同一个拓扑域中”。这里的“拓扑域”由 topologyKey 定义，可以是节点、可用区、机房等任意粒度的标签键。

规则类型	语义	典型场景
podAffinity	Pod 倾向于/必须与匹配标签的 Pod 共处同一拓扑域	将缓存层与计算层部署在同一节点以减少网络延迟
podAntiAffinity	Pod 倾向于/必须避免与匹配标签的 Pod 共处同一拓扑域	将多个副本分散到不同节点或可用区以提高容错性

关键区别：节点亲和性关注的是节点本身的属性（如硬件类型、地域标签），而 Pod 亲和性关注的是节点上已经运行了哪些 Pod。后者在微服务架构中更为灵活，能够表达服务间的部署依赖关系。

4.2 拓扑键（topologyKey）详解

topologyKey 是 Pod 亲和性/反亲和性规则中最核心的参数。它指定了调度器在判断“同一拓扑域”时使用的节点标签键。调度器会检查所有节点，将具有相同 topologyKey 标签值的节点视为同一个拓扑域。

常见的 topologyKey 取值包括：

kubernetes.io/hostname —— 节点级别，每个节点是一个独立的拓扑域
topology.kubernetes.io/zone —— 可用区级别，同一可用区内的节点属于同一拓扑域
topology.kubernetes.io/region —— 地域级别，同一地域内的节点属于同一拓扑域
自定义标签键 —— 如 rack、datacenter，用于匹配私有云或物理机架拓扑

重要约束：对于 requiredDuringScheduling 类型的反亲和性，topologyKey 不能为空，且当使用 kubernetes.io/hostname 时，如果集群节点数少于副本数，会导致部分 Pod 无法调度。建议在反亲和性场景中优先使用 topology.kubernetes.io/zone 以获得更好的调度弹性。

4.3 规则语法与权重

Pod 亲和性/反亲和性规则支持两种调度条件：

requiredDuringSchedulingIgnoredDuringExecution —— 硬约束，调度时必须满足，否则 Pod 无法调度
preferredDuringSchedulingIgnoredDuringExecution —— 软约束，调度时尽量满足，但不强制

每个规则包含以下字段：

affinity:
  podAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
    - labelSelector:
        matchExpressions:
        - key: app
          operator: In
          values:
          - cache
      topologyKey: kubernetes.io/hostname
    preferredDuringSchedulingIgnoredDuringExecution:
    - weight: 100
      podAffinityTerm:
        labelSelector:
          matchLabels:
            app: web
        topologyKey: topology.kubernetes.io/zone
  podAntiAffinity:
    preferredDuringSchedulingIgnoredDuringExecution:
    - weight: 50
      podAffinityTerm:
        labelSelector:
          matchLabels:
            app: frontend
        topologyKey: kubernetes.io/hostname

参数说明：

labelSelector：选择目标 Pod 的标签匹配规则，支持 matchLabels 和 matchExpressions
topologyKey：定义拓扑域的节点标签键
weight：仅用于软约束，取值范围 1–100，权重越高调度器越优先满足
namespaces：可选字段，指定匹配 Pod 所在的命名空间，默认匹配当前命名空间

4.4 调度决策流程

下图展示了调度器在处理 Pod 亲和性规则时的核心决策路径：

4.5 实际应用场景对比

场景	推荐规则	topologyKey	说明
缓存与计算层就近部署	podAffinity (preferred)	`kubernetes.io/hostname`	减少跨节点网络开销，提升数据访问性能
高可用多副本分散	podAntiAffinity (required)	`topology.kubernetes.io/zone`	确保副本分布在不同可用区，防止单点故障
批处理任务隔离	podAntiAffinity (preferred)	`kubernetes.io/hostname`	避免多个计算密集型 Pod 争抢同一节点资源
有状态服务与监控代理	podAffinity (required)	`kubernetes.io/hostname`	确保监控 Sidecar 与主服务运行在同一节点

4.6 常见陷阱与最佳实践

陷阱 1：required 反亲和性 + hostname 导致调度死锁

当副本数大于节点数时，使用 requiredDuringScheduling 反亲和性且 topologyKey 为 kubernetes.io/hostname，会导致部分 Pod 永远无法调度。解决方案：改用 preferred 或扩大拓扑域粒度。

陷阱 2：忽略命名空间作用域

默认情况下，labelSelector 只匹配同一命名空间中的 Pod。如果需要跨命名空间匹配，必须显式设置 namespaces 字段，否则规则可能不生效。

陷阱 3：软约束权重设置不当

多个软约束的 weight 值差异过小时，调度器可能无法有效区分优先级。建议将关键约束的 weight 设为 100，次要约束设为 50 以下，形成明显的优先级梯度。

4.7 与网络拓扑的关联

在基于网络拓扑的调度优化中，Pod 亲和性与反亲和性扮演着流量局部性控制的角色。通过合理设置 topologyKey，可以实现：

东西向流量优化：将频繁通信的微服务通过 podAffinity 调度到同一节点或同一机架，减少跨架跳数
南北向流量分散：将对外提供服务的 Pod 通过 podAntiAffinity 分散到不同可用区，均衡入口流量
故障域隔离：结合 topology.kubernetes.io/region 实现跨地域容灾部署

下图展示了基于网络拓扑的亲和性部署策略：

网络拓扑优化要点：在跨可用区部署时，建议将 podAntiAffinity 的 topologyKey 设置为 topology.kubernetes.io/zone，确保每个可用区只运行一个副本；同时使用 podAffinity 将同一可用区内的 Web 和 Cache 绑定到同一节点，最大化本地流量占比，降低跨节点网络延迟。