4. Helm 调度亲和配置实践

调度亲和性（Affinity）是 Kubernetes 调度器将 Pod 分配到特定节点的核心策略。在 Helm Chart 中定义亲和性，需要兼顾声明式模板与参数化灵活性，避免硬编码导致的配置漂移。本节将围绕亲和性在 Chart 中的定义、values.yaml 的参数化设计以及动态模板编写展开。

4.1 亲和性类型与 Helm 中的声明方式

Kubernetes 支持三种亲和性策略，Helm 通过 spec.template.spec.affinity 字段暴露。下表总结了各策略的用途与 Helm 中的典型字段路径：

4.2 values.yaml 中的亲和性参数化设计

参数化设计的核心是将亲和性规则从模板中抽离到 values.yaml，使运维人员无需修改模板即可调整调度策略。以下是一个经过治理优化的参数化结构：

# values.yaml
affinity:
  # 节点亲和性：required 与 preferred 分离
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
            - key: "topology.kubernetes.io/zone"
              operator: In
              values:
                - "us-east-1a"
                - "us-east-1b"
    preferredDuringSchedulingIgnoredDuringExecution:
      - weight: 50
        preference:
          matchExpressions:
            - key: "node.kubernetes.io/instance-type"
              operator: In
              values:
                - "m5.large"
  # Pod 反亲和性：拓扑域与标签选择器参数化
  podAntiAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      - labelSelector:
          matchExpressions:
            - key: "app.kubernetes.io/name"
              operator: In
              values:
                - "{{ .Values.nameOverride | default .Chart.Name }}"
        topologyKey: "kubernetes.io/hostname"
  # Pod 亲和性：可选，默认关闭
  podAffinity: {}

4.3 动态亲和性模板编写

在 deployment.yaml 或 statefulset.yaml 中，使用 toYaml 与 default 函数将 values 中的亲和性配置注入到 Pod 规范中。以下是一个经过生产验证的模板片段：

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "myapp.fullname" . }}
spec:
  replicas: {{ .Values.replicaCount }}
  template:
    spec:
      {{- with .Values.affinity }}
      affinity:
        {{- toYaml . | nindent 8 }}
      {{- end }}
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"

4.4 动态亲和性模板编写（进阶：条件与循环）

对于需要根据环境动态生成多条亲和性规则的场景，可以使用 range 与 if 实现条件化模板。以下示例展示了如何根据 .Values.environment 动态注入节点亲和性：

# templates/_helpers.tpl
{{- define "myapp.nodeAffinity" -}}
{{- if eq .Values.environment "production" }}
requiredDuringSchedulingIgnoredDuringExecution:
  nodeSelectorTerms:
    - matchExpressions:
        - key: "node.kubernetes.io/role"
          operator: In
          values:
            - "prod"
{{- else }}
preferredDuringSchedulingIgnoredDuringExecution:
  - weight: 30
    preference:
      matchExpressions:
        - key: "node.kubernetes.io/role"
          operator: In
          values:
            - "staging"
{{- end }}
{{- end -}}

# templates/deployment.yaml
spec:
  template:
    spec:
      affinity:
        nodeAffinity:
          {{- include "myapp.nodeAffinity" . | nindent 10 }}

4.5 亲和性配置漂移的审计锚点

在 Helm 治理中，亲和性配置漂移通常表现为：预期调度策略与实际调度结果不一致。以下表格列出了关键的审计锚点：

4.6 实践：完整亲和性配置示例

以下是一个结合了节点亲和性与 Pod 反亲和性的完整 values.yaml 与模板示例，适用于生产环境的多可用区部署：

# values.yaml (生产环境)
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
            - key: "topology.kubernetes.io/zone"
              operator: In
              values:
                - "us-east-1a"
                - "us-east-1b"
                - "us-east-1c"
    preferredDuringSchedulingIgnoredDuringExecution:
      - weight: 80
        preference:
          matchExpressions:
            - key: "node.kubernetes.io/instance-type"
              operator: In
              values:
                - "c5.xlarge"
  podAntiAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      - labelSelector:
          matchExpressions:
            - key: "app.kubernetes.io/name"
              operator: In
              values:
                - "myapp"
        topologyKey: "topology.kubernetes.io/zone"

# templates/deployment.yaml (核心片段)
spec:
  template:
    spec:
      {{- with .Values.affinity }}
      affinity:
        {{- toYaml . | nindent 8 }}
      {{- end }}
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"

4.7 配置漂移的自动化检测

在 CI/CD 流水线中集成以下检查，可以提前捕获亲和性配置漂移：

• 模板差异对比：使用 helm diff upgrade 对比当前部署与预期模板的差异。
• 标签一致性校验：编写脚本检查 matchExpressions 中的 values 是否与集群节点标签匹配。
• 拓扑键白名单：在 values.schema.json 中限制 topologyKey 的可选值，防止非法拓扑键注入。