4. Helm Chart 基础：Chart 结构、版本号规范、依赖管理与仓库

在 Kubernetes 生态中，Helm 是事实上的应用打包与交付标准。一个 Helm Chart 本质上是一个描述 Kubernetes 资源集合的模板化包。理解 Chart 的内部结构、版本号规范、依赖管理机制以及仓库操作，是进行节点池 Chart 版本兼容性验证与回滚的前提。本节将系统梳理这些基础概念。

4.1 Chart 目录结构

一个标准的 Chart 包遵循固定的目录布局。以下是一个典型 Chart 的完整结构示例：

my-chart/
├── Chart.yaml          # Chart 元数据（名称、版本、描述等）
├── values.yaml         # 默认配置值
├── values.schema.json  # （可选）values 的 JSON Schema 校验文件
├── charts/             # （可选）子 Chart 依赖包（.tgz 或目录）
├── crds/               # （可选）CustomResourceDefinition 清单
├── templates/          # 模板文件目录
│   ├── NOTES.txt       # （可选）安装后的使用说明
│   ├── _helpers.tpl    # （可选）模板辅助函数
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── ingress.yaml
│   └── ...
└── README.md           # （可选）Chart 说明文档

4.2 Chart 版本号规范

Helm Chart 的版本号严格遵循 SemVer 2.0（语义化版本）规范。版本号格式为 MAJOR.MINOR.PATCH，并支持预发布和构建元数据后缀。

4.3 依赖管理

复杂应用通常由多个子 Chart 组成。Helm 通过 Chart.yaml 中的 dependencies 字段管理这些依赖关系。

4.3.1 声明依赖

在 Chart.yaml 中声明依赖的示例如下：

dependencies:
  - name: redis
    version: ">=15.0.0 < 16.0.0"
    repository: "https://charts.bitnami.com/bitnami"
    condition: redis.enabled
    tags:
      - cache
  - name: postgresql
    version: "12.x"
    repository: "https://charts.bitnami.com/bitnami"
    alias: db

4.3.2 依赖版本约束

4.3.3 依赖管理命令

• helm dependency list — 查看当前 Chart 的依赖状态。
• helm dependency update — 根据 Chart.yaml 中的声明，下载依赖包到 charts/ 目录并生成 Chart.lock 文件。
• helm dependency build — 基于 Chart.lock 文件重建依赖，确保版本一致性。

4.4 Chart 仓库

Chart 仓库（Repository）是存储和分发 Chart 包的 HTTP 服务器。仓库索引文件 index.yaml 记录了所有可用 Chart 的元数据和下载地址。

4.4.1 仓库操作命令

• helm repo add [name] [url] — 添加仓库。
• helm repo list — 列出已添加的仓库。
• helm repo update — 更新本地仓库缓存。
• helm repo remove [name] — 移除仓库。
• helm search repo [keyword] — 在仓库中搜索 Chart。

4.4.2 仓库与版本追溯

在回滚场景中，仓库的历史版本可用性至关重要。以下命令用于查看和获取特定版本的 Chart：

# 查看 Chart 的所有可用版本
helm search repo my-chart --versions

# 查看特定版本的详细信息
helm show chart my-repo/my-chart --version 1.2.3

# 下载特定版本的 Chart 包到本地
helm pull my-repo/my-chart --version 1.2.3 --untar

4.5 Chart 结构、版本与依赖关系总览

下图展示了 Chart 包的核心组成、版本号在升级决策中的作用，以及依赖管理如何影响最终的部署状态。

4.6 版本兼容性验证清单

在节点池升级前，基于本节知识，建议执行以下验证步骤：

1. 检查 Chart 版本号：确认 version 和 appVersion 的变更范围，判断是否为 MAJOR 升级。
2. 审查依赖变更：对比新旧 Chart.lock 文件，识别所有子 Chart 的版本变化。
3. 验证仓库可用性：确保目标版本和当前版本在仓库中均可检索和拉取。
4. 本地归档：使用 helm pull 下载当前生产版本及其依赖，作为回滚备份。
5. 模拟升级：使用 helm template 或 helm install --dry-run 预览资源变更。