3. 基础Chart结构解析：Chart.yaml、values.yaml、templates/目录、_helpers.tpl的作用与最佳实践

在深入故障域隔离与Values调优之前，必须彻底理解Helm Chart的骨架结构。一个标准的Chart由四个核心组件构成，它们共同定义了应用的交付逻辑、默认配置、资源模板和可复用辅助函数。本章将逐一拆解每个组件的作用、字段含义及生产级最佳实践。

3.1 Chart.yaml：Chart的元数据清单

Chart.yaml 是Chart的“身份证”，Helm通过它识别Chart的名称、版本、依赖关系及API兼容性。任何Chart都必须包含此文件。

3.2 values.yaml：默认配置的单一事实来源

values.yaml 是Chart的默认参数文件，定义了所有可配置项的默认值。它是故障域隔离演练中参数调优的核心操作对象。

• 层级结构： 使用YAML嵌套组织参数，避免扁平化命名。例如 service.port 优于 servicePort。
• 类型明确： 字符串、整数、布尔值、列表、字典需显式声明，Helm不会自动类型转换。
• 注释完备： 每个参数上方添加 # @param 注释，说明用途、默认值、可选值。
• 全局参数： 使用 global 前缀定义跨Chart共享参数，如 global.imageRegistry。

# values.yaml 示例
replicaCount: 3

image:
  repository: nginx
  tag: "1.25.3"
  pullPolicy: IfNotPresent

service:
  type: ClusterIP
  port: 80

resources:
  limits:
    cpu: "500m"
    memory: "512Mi"
  requests:
    cpu: "250m"
    memory: "256Mi"

# 故障域隔离专用参数
faultDomain:
  enabled: false
  zone: "az-1"
  affinityType: "preferred"

3.3 templates/目录：Kubernetes资源模板引擎

templates/ 目录存放Go模板文件，Helm将 values.yaml 中的参数渲染为最终的Kubernetes资源清单。每个模板文件对应一个Kubernetes资源类型。

模板中常用的Helm内置函数包括：quote、default、required、include、tpl。故障域隔离场景中，required 函数用于强制用户填写关键参数，避免误部署到错误区域。

{{- /* templates/deployment.yaml 片段 */ -}}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "my-chart.fullname" . }}
spec:
  replicas: {{ .Values.replicaCount }}
  template:
    spec:
      affinity:
        podAntiAffinity:
          preferredDuringSchedulingIgnoredDuringExecution:
          - weight: 100
            podAffinityTerm:
              labelSelector:
                matchLabels:
                  app: {{ include "my-chart.name" . }}
              topologyKey: "topology.kubernetes.io/zone"

3.4 _helpers.tpl：可复用模板函数库

_helpers.tpl 是Chart的“工具库”，用于定义可复用的命名模板。它以 define 关键字开头，以 end 结尾，通过 include 或 template 函数在其他模板中调用。

• 命名规范： 使用 chartName.functionName 格式，如 my-chart.fullname，避免与其他Chart冲突。
• 常见用途： 生成资源名称、标签、选择器、环境变量、故障域标识。
• 作用域： 所有 _helpers.tpl 中定义的模板自动全局可用，无需显式导入。

{{- /* _helpers.tpl 示例 */ -}}
{{- define "my-chart.fullname" -}}
{{- printf "%s-%s" .Release.Name .Chart.Name | trunc 63 | trimSuffix "-" -}}
{{- end -}}

{{- define "my-chart.labels" -}}
app.kubernetes.io/name: {{ include "my-chart.name" . }}
app.kubernetes.io/instance: {{ .Release.Name }}
app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
helm.sh/chart: {{ printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
{{- end -}}

{{- define "my-chart.faultDomainLabel" -}}
{{- if .Values.faultDomain.enabled -}}
failure-domain.beta.kubernetes.io/zone: {{ .Values.faultDomain.zone | quote }}
{{- end -}}
{{- end -}}

3.5 核心组件关系图

下图展示了四个核心组件之间的数据流与依赖关系，帮助理解参数如何从 values.yaml 流向最终资源清单。

3.6 故障域隔离场景下的最佳实践清单

1. 参数分层： 将故障域参数放在 values.yaml 的 faultDomain 层级下，避免与业务参数混杂。
2. 模板抽象： 在 _helpers.tpl 中定义 faultDomain.affinity 和 faultDomain.topologyKey，所有Deployment、StatefulSet统一引用。
3. 版本关联： 在 Chart.yaml 的 version 中嵌入故障域标识（如 1.0.0-az1），确保回滚时Chart版本与故障域绑定。
4. 默认安全： values.yaml 中 faultDomain.enabled 默认为 false，避免未配置时意外启用区域亲和性。
5. 强制校验： 在模板中使用 required 函数校验 faultDomain.zone 非空，防止部署到错误区域。
6. 覆盖文件： 为每个故障域准备独立的 values-az1.yaml、values-az2.yaml，演练时通过 -f 参数加载。