3. Helm 基础回顾：Chart 结构、Release 管理、Values 注入与模板渲染机制

在深入故障域隔离演练与 diff 复核之前，必须重新夯实 Helm 的核心抽象。本节从 Chart 结构、Release 生命周期、Values 注入链路 和 模板渲染引擎 四个维度建立统一认知基线，确保后续演练中的每一个 diff 差异都能被准确归因。

3.1 Chart 标准目录结构

一个 Helm Chart 是 Kubernetes 资源的打包单元，其目录结构遵循 Helm 社区规范。理解每个文件的作用是定位渲染异常的第一步。

3.2 Release 管理模型

Release 是 Chart 的一次部署实例。Helm v3 移除了 Tiller，采用 Secret 存储 模式，每个 Release 的状态和元数据以 Secret 形式保存在目标命名空间中。

# 查看所有 Release（含历史版本）
helm list -n <namespace> --all

# 查看 Release 历史版本
helm history <release-name> -n <namespace>

# 查看 Release 存储的 Secret
kubectl get secret -n <namespace> -l "owner=helm,name=<release-name>"

# 回滚到指定版本
helm rollback <release-name> <revision> -n <namespace>

3.3 Values 注入优先级与覆盖规则

Values 的注入遵循严格的优先级顺序。在故障域隔离演练中，不同集群使用不同的 values 文件是常见场景，理解覆盖规则能避免“预期覆盖未生效”导致的 diff 误判。

3.4 模板渲染机制与函数管道

Helm 使用 Go 模板引擎（text/template）结合 Sprig 函数库进行资源渲染。模板渲染发生在 Helm 客户端本地，不依赖 Kubernetes API Server。

3.4.1 核心模板语法

{{- /* 注释：不会出现在渲染结果中 */ -}}

{{- /* 取值 */ -}}
{{ .Values.replicaCount }}
{{ .Release.Name }}
{{ .Chart.Name }}

{{- /* 条件判断 */ -}}
{{- if .Values.autoscaling.enabled }}
apiVersion: autoscaling/v2
{{- else }}
apiVersion: apps/v1
{{- end }}

{{- /* 循环 */ -}}
{{- range .Values.ports }}
- name: {{ .name }}
  containerPort: {{ .port }}
{{- end }}

{{- /* 管道与函数 */ -}}
{{ .Values.image.tag | default "latest" | quote }}
{{ .Values.replicaCount | int | toString }}

3.4.2 内置对象与常用函数