2. Helm 基础回顾：Chart结构、模板引擎、内置对象、依赖管理、版本语义化

在深入多集群发布策略之前，必须重新夯实 Helm 的核心基础。本章将系统回顾 Chart 的物理结构、模板渲染机制、内置可访问对象、依赖管理方式以及版本号语义规范，为后续的 Values 分层与集群差异化配置建立共同语言。

2.1 Chart 目录结构与核心文件

一个标准的 Helm Chart 遵循固定的目录布局，Helm CLI 在打包、校验和渲染时依赖此结构。下表列出了每个文件/目录的职责与是否必须存在：

2.2 模板引擎与渲染流程

Helm 使用 Go 标准库 text/template 作为模板引擎，并扩展了 60+ 模板函数（通过 Sprig 库）。渲染流程分为三个阶段：

1. 值合并：将 values.yaml、用户提供的 --values 文件、--set 参数按优先级合并为最终 Values 对象。
2. 模板解析：遍历 templates/ 目录下的所有 .yaml、.tpl、.txt 文件，执行 {{ }} 指令。
3. 资源输出：将渲染后的合法 YAML 清单输出给 Kubernetes API。

2.3 内置对象与常用函数

模板中可以直接访问以下预定义对象，它们是构建动态资源清单的核心：

2.4 依赖管理：子 Chart 与条件加载

Helm 通过 Chart.yaml 中的 dependencies 字段声明依赖。依赖可以是本地子 Chart 或远程仓库 Chart。常用字段如下：

# Chart.yaml
dependencies:
  - name: redis
    version: ">=16.0.0"
    repository: "https://charts.bitnami.com/bitnami"
    condition: redis.enabled    # 条件控制：当 .Values.redis.enabled 为 true 时加载
    tags:
      - cache
    import-values:
      - child: defaults
        parent: redisDefaults

依赖管理的关键操作命令：

• helm dependency update — 根据 Chart.yaml 下载依赖包到 charts/ 目录并生成 Chart.lock 锁定版本。
• helm dependency build — 使用 Chart.lock 中的精确版本重建依赖，保证可重现。
• helm dependency list — 查看当前依赖状态（已下载/缺失/错误）。

2.5 版本语义化（SemVer 2.0）

Helm 严格遵循 语义化版本 2.0.0（SemVer 2.0），格式为 MAJOR.MINOR.PATCH，并支持预发布后缀：

在 Chart.yaml 中，version 字段代表 Chart 包本身的版本，appVersion 字段代表所部署应用的版本，两者独立管理：

# Chart.yaml
apiVersion: v2
name: my-app
version: 1.2.3          # Chart 版本，每次修改模板或默认值都需要递增
appVersion: "3.0.1"     # 应用版本，仅用于信息展示，不参与依赖解析

2.6 本章小结