3. Helm 基础回顾：Chart 结构、模板引擎、Values 文件、Release 管理

在构建故障域隔离演练自动化测试框架之前，必须牢固掌握 Helm 的核心基础。Helm 是 Kubernetes 的包管理工具，它将应用定义、配置和部署逻辑封装为 Chart。本章将系统回顾 Chart 的目录结构、Go 模板引擎的工作机制、Values 文件的层次化覆盖规则，以及 Release 的生命周期管理。

3.1 Chart 目录结构

一个标准的 Helm Chart 遵循固定的目录布局，Helm 客户端通过识别这些约定来加载模板、依赖和元数据。

3.2 模板引擎与核心函数

Helm 使用 Go 模板引擎（text/template）结合 Sprig 函数库，将 values.yaml 中的值动态渲染到 Kubernetes 资源文件中。模板引擎的核心机制包括：

• 对象访问： 通过 .Values、.Release、.Chart、.Files 等内置对象访问上下文数据。
• 控制结构： if-else、with、range 用于条件渲染和循环。
• 变量与管道： 使用 $var := 定义局部变量，通过管道 | 串联函数（如 quote、default、upper）。
• 命名模板： 使用 define 和 template（或 include）实现模板复用。

# templates/_helpers.tpl
{{- define "myapp.labels" -}}
app.kubernetes.io/name: {{ .Chart.Name }}
app.kubernetes.io/instance: {{ .Release.Name }}
{{- end -}}

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-web
  labels:
    {{- include "myapp.labels" . | nindent 4 }}
spec:
  replicas: {{ .Values.replicaCount | default 1 }}
  selector:
    matchLabels:
      app: {{ .Chart.Name }}
  template:
    metadata:
      labels:
        app: {{ .Chart.Name }}
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          ports:
            - containerPort: {{ .Values.service.port }}

3.3 Values 文件与层次化覆盖

Helm 的 Values 系统支持多层级覆盖，这是实现故障域隔离配置的关键。Helm 在渲染模板时，按照以下优先级顺序合并 Values（从低到高）：

1. Chart 内置 values.yaml：基础默认值。
2. 父 Chart 的 Values：如果当前 Chart 是子 Chart，父 Chart 的 Values 会传递下来。
3. 用户提供的 -f 文件：通过 helm install -f custom.yaml 指定的 YAML 文件，后指定的文件优先级更高。
4. 命令行 --set 参数：最高优先级，直接覆盖特定键值。

以下 SVG 图展示了 Values 的层次化覆盖流程：

3.4 Release 管理

Release 是 Helm Chart 的一次部署实例。每次执行 helm install 或 helm upgrade 都会生成一个新的 Release 版本。Release 管理是故障域演练中回滚和版本追溯的基础。

以下 SVG 图展示了 Release 的生命周期与故障域演练的对应关系：

3.5 内置对象与全局上下文

在模板渲染时，Helm 提供了多个内置对象，这些对象在故障域演练的模板编写中非常有用：

• .Values：当前 Chart 的 Values 配置，包含所有覆盖后的最终值。
• .Release.Name：Release 名称，用于生成唯一资源名称，避免多演练实例冲突。
• .Release.Namespace：Release 所在的 Kubernetes 命名空间。
• .Release.Revision：当前 Release 的版本号，可用于审计和回滚判断。
• .Chart：Chart.yaml 中的元数据。
• .Files：访问 Chart 包内的非模板文件（如配置文件、脚本）。