2. Helm 基础回顾：Chart 结构、Release 管理、Helm install/upgrade/rollback 命令详解

在深入节点池 Chart 版本回滚巡检之前，必须牢固掌握 Helm 的核心概念与基础操作。本章将系统回顾 Helm 的三大支柱：Chart 结构、Release 管理以及核心命令（install/upgrade/rollback），为后续的兼容性验证与回滚策略打下坚实基础。

2.1 Chart 结构：应用包的标准布局

Helm Chart 是一个遵循标准目录结构的打包文件，用于描述一组相关的 Kubernetes 资源。一个典型的 Chart 结构如下：

mychart/
├── Chart.yaml          # Chart 元数据（名称、版本、描述等）
├── values.yaml         # 默认配置值
├── values.schema.json  # （可选）values 的 JSON Schema 校验文件
├── charts/             # （可选）子 Chart 依赖
├── templates/          # Go 模板文件目录
│   ├── NOTES.txt       # （可选）安装后的使用说明
│   ├── _helpers.tpl    # （可选）模板辅助函数
│   ├── deployment.yaml
│   ├── service.yaml
│   └── hpa.yaml
└── crds/               # （可选）CRD 定义目录

2.2 Release 管理：版本化部署实例

Release 是 Helm 的核心抽象，代表一次 Chart 部署的版本化实例。每次执行 helm install、helm upgrade 或 helm rollback 都会生成一个新的 Release 版本记录。

2.3 Helm install / upgrade / rollback 命令详解

这三个命令构成了 Helm 部署生命周期管理的核心循环。理解它们的差异与使用场景，是进行版本回滚巡检的前提。

2.3.1 helm install：首次部署

将 Chart 部署到 Kubernetes 集群，创建一个新的 Release。

# 基本语法
helm install [RELEASE_NAME] [CHART] [flags]

# 示例：部署节点池 Chart，指定 values 文件
helm install prod-nodepool ./nodepool-chart \
  --namespace nodepool-system \
  --values prod-values.yaml \
  --set nodePool.replicas=3

2.3.2 helm upgrade：更新部署

将 Release 升级到新版本的 Chart 或新的配置值。Helm 会对比当前 Release 与目标配置，生成增量更新。

# 基本语法
helm upgrade [RELEASE_NAME] [CHART] [flags]

# 示例：升级节点池 Chart 到新版本，同时调整副本数
helm upgrade prod-nodepool ./nodepool-chart \
  --namespace nodepool-system \
  --reuse-values \
  --set nodePool.replicas=5

# 强制升级（即使 Chart 版本未变，仅更新 values）
helm upgrade prod-nodepool ./nodepool-chart \
  --namespace nodepool-system \
  --values new-values.yaml

2.3.3 helm rollback：版本回滚

将 Release 恢复到之前的某个 Revision。这是回滚巡检的核心操作。

# 基本语法
helm rollback [RELEASE_NAME] [REVISION] [flags]

# 示例：将 prod-nodepool 回滚到 Revision 2
helm rollback prod-nodepool 2 \
  --namespace nodepool-system

# 回滚并等待所有资源就绪
helm rollback prod-nodepool 2 \
  --namespace nodepool-system \
  --wait \
  --timeout 5m

# 回滚后清理旧 Release 记录（保留最近 N 个版本）
helm rollback prod-nodepool 2 \
  --namespace nodepool-system \
  --cleanup-on-fail

2.4 版本回滚的核心机制

理解 Helm 回滚的内部机制，有助于在巡检中准确判断回滚行为：

1. Revision 递增：每次 helm rollback 都会创建一个新的 Revision（而非覆盖旧的），回滚后的版本号会继续递增。
2. 模板重新渲染：回滚时，Helm 使用目标 Revision 对应的 Chart 版本和 values 重新渲染模板，然后 apply 到集群。
3. 资源差异计算：Helm 对比新渲染的 YAML 与集群当前状态，生成 patch 或 delete/create 操作。
4. 历史记录保留：默认保留最近 10 个 Revision（可通过 --history-max 配置），超出部分会被自动清理。

2.5 常用辅助命令