2. Helm 基础回顾：Chart 结构、模板引擎、Values 文件、Release 管理、Helm v3 核心特性

在深入多集群变更门禁与回滚策略之前，必须重新夯实 Helm 的核心基础。Helm 是 Kubernetes 生态中事实标准的包管理工具，它将应用定义、依赖、配置与生命周期管理封装为 Chart。本章从五个维度展开：Chart 的物理结构、模板引擎的工作机制、Values 的层次化注入、Release 的生命周期状态机，以及 Helm v3 相比 v2 的关键架构变化。

2.1 Chart 目录结构与元数据

一个标准的 Helm Chart 遵循固定的目录布局，Kubernetes 资源模板存放在 templates/ 目录下，Chart 自身的元数据由 Chart.yaml 定义。

2.2 模板引擎与内置函数

Helm 使用 Go 标准库 text/template 作为模板引擎，并扩展了 60+ 内置函数（Sprig 库 + 自定义函数）。模板通过 {{ }} 双花括号语法访问 Values、内置对象和管道函数。

# 典型的 Deployment 模板片段 (templates/deployment.yaml)
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-{{ .Chart.Name }}
  labels:
    app.kubernetes.io/name: {{ .Chart.Name }}
    app.kubernetes.io/instance: {{ .Release.Name }}
spec:
  replicas: {{ .Values.replicaCount | default 1 }}
  template:
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default "latest" }}"
          ports:
            - containerPort: {{ .Values.service.port }}

模板中可访问的 内置对象 包括：

• .Values — 用户传入的配置值（合并默认值后）
• .Release — Release 元数据（Name、Namespace、Revision、Service、IsUpgrade、IsInstall）
• .Chart — Chart.yaml 中的字段（Name、Version、AppVersion、Annotations）
• .Files — 访问 Chart 内非模板文件（如配置文件、证书）
• .Capabilities — 目标集群的 Kubernetes 版本与 API 版本信息

2.3 Values 文件层次与优先级

Helm 支持多级 Values 注入，优先级从低到高依次为：Chart 内建 values.yaml → 父 Chart 的 values → -f 指定的外部文件（可多个）→ --set 命令行参数。合并策略是深度合并（deep merge），而非简单覆盖。

# 默认 values.yaml
replicaCount: 2
image:
  repository: nginx
  tag: "1.25"
service:
  type: ClusterIP
  port: 80

# 生产环境覆盖文件 values-prod.yaml
replicaCount: 5
image:
  tag: "1.25-alpine"   # 只覆盖 tag，repository 保留默认值

2.4 Release 管理与版本状态机

Release 是 Chart 的一次部署实例。Helm v3 将 Release 信息存储在集群内的 Secret 中（命名空间隔离），每个 Release 包含多个 Revision（版本）。

Revision 状态流转：pending-install → deployed / failed → superseded（被新版本替代）→ pending-rollback → deployed。

2.5 Helm v3 核心特性与架构变化

Helm v3 移除了 Tiller（服务端组件），改为纯客户端架构，安全性、RBAC 集成和命名空间隔离得到根本性改善。

Helm v3 的其他关键特性：

• OCI 注册表支持：Chart 可以打包为 OCI 镜像，存储在 Harbor、ECR 等容器镜像仓库中，不再依赖 Chart Museum。
• Library Chart：一种特殊 Chart 类型，只提供模板辅助函数（_helpers.tpl），不生成任何资源，适合多 Chart 共享逻辑。
• JSON Schema 校验：在 values.schema.json 中定义 Values 的约束条件，helm install/upgrade 时自动校验。
• Post-Render 钩子：允许在模板渲染后、提交到 Kubernetes 之前，通过外部工具（如 Kustomize）对清单进行二次处理。

2.6 本章小结