Helm 基础回顾：Chart结构、Values文件、模板引擎、Release生命周期

在深入故障域隔离与配置模板参数校验之前，必须牢固掌握 Helm 的核心基础。Helm 是 Kubernetes 的包管理工具，它将应用定义、配置和部署逻辑封装为 Chart。本节将系统回顾 Chart 的目录结构、Values 文件的层级覆盖机制、模板引擎的核心语法以及 Release 的完整生命周期。

2.1 Chart 目录结构

一个标准的 Helm Chart 是一个遵循特定布局的目录集合。Helm 通过解析该目录下的文件来生成 Kubernetes 资源清单。

路径 / 文件 是否必需 说明
Chart.yaml 是 Chart 的元数据文件，包含名称、版本、描述、API 版本等。
values.yaml 是 默认配置值文件，定义了所有可配置参数的默认值。
templates/ 是 存放 Go 模板文件，渲染后生成 Kubernetes 资源 YAML。
charts/ 否 存放子 Chart（依赖 Chart）的目录。
crds/ 否 存放自定义资源定义（CRD）的 YAML 文件。
README.md 否 Chart 的使用说明文档。
templates/NOTES.txt 否 安装成功后向用户输出的提示信息模板。
关键点： templates/ 目录下的文件必须遵循 *.yaml、*.tpl 或 *.txt 命名规则。Helm 不会渲染非标准后缀的文件。

2.2 Values 文件与层级覆盖

Values 是 Helm 配置的核心。Helm 支持多级 Values 文件，并按照优先级进行合并覆盖。理解这一机制对于实现故障域隔离至关重要。

Values 的加载顺序（后加载的覆盖先加载的）：

  1. Chart 内置 values.yaml（最低优先级）
  2. 父 Chart 的 values.yaml（当存在子 Chart 时）
  3. 用户提供的 -f 或 --values 文件（可指定多个，按顺序覆盖）
  4. 命令行 --set 参数（最高优先级）
故障域隔离实践： 在故障域隔离场景中，通常将全局默认配置放在 values.yaml，而将特定故障域（如 az-a、az-b）的差异化配置放在独立的 values-az-a.yaml 和 values-az-b.yaml 中，通过 -f 参数按需加载。 
# 示例：加载基础配置后，再加载故障域特定配置
helm install my-release ./mychart \
  -f values.yaml \
  -f values-az-a.yaml

2.3 模板引擎核心语法

Helm 使用 Go 模板引擎，并扩展了 Sprig 函数库。模板文件通过 {{ }} 双花括号引用 Values 或执行函数。

语法 / 函数 示例 说明
.Values {{ .Values.replicaCount }} 访问 Values 对象中的值。
.Chart {{ .Chart.Name }}-{{ .Chart.Version }} 访问 Chart.yaml 中的元数据。
.Release {{ .Release.Name }} 访问当前 Release 的元数据（名称、命名空间等）。
include {{ include "mychart.labels" . }} 引入并执行命名模板（在 _helpers.tpl 中定义）。
required {{ required "A valid .Values.db.url is required!" .Values.db.url }} 参数校验：若值为空则报错并终止渲染。
toYaml {{ toYaml .Values.resources | indent 8 }} 将对象/列表格式化为 YAML 字符串，并缩进。
default {{ default "nginx" .Values.image.repository }} 提供默认值，当 .Values.image.repository 为空时使用。
常见陷阱： 模板中的缩进必须手动控制。使用 nindent 或 indent 函数来保持 YAML 格式正确，否则会导致资源创建失败。 
# 推荐做法：使用 nindent 自动换行并缩进
env:
  {{- range $key, $value := .Values.envVars }}
  - name: {{ $key }}
    value: {{ $value | quote }}
  {{- end }}

2.4 Release 生命周期

一个 Release 是 Chart 的一次部署实例。Helm 管理着 Release 从创建到删除的完整状态。

Helm Release 生命周期 helm install DEPLOYED helm upgrade DEPLOYED FAILED helm rollback DEPLOYED helm uninstall UNINSTALLED helm uninstall

Release 的核心状态包括：

  • DEPLOYED：当前 Release 已成功部署并处于运行状态。
  • FAILED：部署或升级过程中发生错误，Release 未达到预期状态。
  • PENDING_INSTALL / PENDING_UPGRADE：正在执行安装或升级操作，尚未完成。
  • UNINSTALLED：Release 已被删除，但历史记录保留（可通过 --keep-history 查看）。
故障域隔离关联： 每个故障域（如不同的可用区）应拥有独立的 Release。通过 helm upgrade --install 命令，可以为每个故障域创建或更新独立的 Release 实例，从而实现配置隔离与独立生命周期管理。

2.5 核心概念总结

概念 作用 在故障域隔离中的角色
Chart 应用的定义与打包格式 同一 Chart 部署到不同故障域，保持应用逻辑一致
Values 配置参数与默认值 通过多 Values 文件实现故障域差异化配置
模板引擎 将 Values 渲染为 Kubernetes 资源 利用 required、toYaml 等函数实现参数校验与格式化
Release Chart 的一次部署实例 每个故障域对应一个独立 Release，实现隔离部署与回滚
← 上一章 📖 返回目录 下一章 →