# 一个 Helm chart 服务多个客户，告别手改 YAML

> chart 带版本，每个客户一份 values 文件，每次安装都有历史，回滚只需一条命令。

原文: https://fdetimes.net/zh/tools/helm-charts-multi-customer-deployments/

设想下周你要把同一个服务装进两个客户的 Kubernetes 集群：一家银行需要三个副本和一个内网主机名，一家物流公司只要一个副本。如果你交出去的是一个装满零散 YAML 的文件夹，每到一处就手工改一遍，到第三个客户时，你已经记不清在哪里改过什么了。

Helm 官网把这个项目定位为 Kubernetes 的包管理器。上面这种两个客户的场景，正是包管理器要解决的问题。

对前线部署工程师（FDE）来说，Helm 的价值在于用一个带版本的包取代“按客户改 YAML”。客户能读懂这个包，你能重复安装，出了问题还能退回上一个版本。

## chart 里有什么？

根据 Helm 文档，chart 是一组文件，用来描述一组相关的 Kubernetes 资源。一个 chart 至少包含三部分：描述这个包的 `Chart.yaml`；存放带占位符 manifest 的 `templates/` 目录；存放默认配置的 `values.yaml`。

有两个细节要一开始就做对。面向 Helm 3 及以上版本的 chart，必须在 `Chart.yaml` 中声明 `apiVersion: v2`。如果产品还需要数据库或 ingress controller，就在同一个文件的 `dependencies` 字段里声明，而不是让客户自己逐个安装。

看一段 Deployment 模板的节选，就能明白值是怎样填进 manifest 的：

```yaml
# templates/deployment.yaml（节选）
spec:
  replicas: {{ .Values.replicaCount }}
  template:
    spec:
      containers:
        - name: app
          image: "myrepo/app:{{ .Values.image.tag }}"
```

如果 `values.yaml` 设置了 `replicaCount: 1` 和 `image.tag: "1.4.0"`，渲染出的 manifest 就是 `replicas: 1`，镜像为 `myrepo/app:1.4.0`。到了银行那边，它自己的 values 文件只需写 `replicaCount: 3`；模板不变，变的只是填进去的数字。

把 `values.yaml` 当作存放对所有客户都安全的默认值的地方。凡是客户之间不同的东西（副本数、镜像 tag、主机名、磁盘大小），都应该是这个文件里的一个键。这样到了第十个客户，你也不必去改模板。

**要点:** 客户之间的差异应该体现在配置文件里，部署代码始终只有一个版本。

## 三处设置同一个参数，最终取哪个值？

安装时，客户专属配置可以通过 `-f` 传入一个或多个文件，也可以用 `--set` 逐个传值。Helm 文档写得很明确：两者同时使用时，`--set` 的值会合并进 `--values`，且优先级更高。

拿银行的例子推一遍。`values.yaml` 设置 `replicaCount: 1`，文件 `values-bank.yaml`（银行的配置）设置 `replicaCount: 3`，而在一次故障处理中，有人又加了 `--set replicaCount=5`。集群最终会运行 5 个副本，而 5 这个数字不在你放进 Git 的任何文件里。

所以，`--set` 只留给快速试验。客户的配置应该放在受版本控制的 values 文件里，这样下一次安装的结果才会和上一次完全一致。

动客户集群之前，先运行 `helm template`。它在你本机渲染模板并输出 manifest，让你清楚看到 Helm 将要创建什么：

```bash
helm template ./my-chart -f values-bank.yaml
helm install my-app ./my-chart -f values-bank.yaml
```

如果客户有平台团队要审阅变更，发给他们渲染好的 manifest，比发一个模板文件夹更容易通过审批。

## release 与 revision：Helm 值得学的原因

每安装一次 chart，Helm 就会创建一个 release。`helm upgrade` 作用于已有的 release，`helm rollback [RELEASE] [REVISION]` 则把它退回到更早的 revision。根据文档，每次安装、升级或回滚，revision 编号都会加 1。

数一数银行那边的一周：首次安装是 revision 1，升级镜像 tag 是 revision 2，修改主机名是 revision 3。第三个版本出了问题，于是回滚到 revision 2。结果是生成 revision 4，内容与 revision 2 相同；revision 编号并不会退回到 2。

因为编号只增不减，出问题的版本会以 3 号留在历史里，紧挨着恢复后的 4 号版本。客户问“你们昨天改了什么？”时，你能指出一个具体的 revision 编号。

## 怎样交付 chart，才能让客户放心？

Helm 建议用兼容开放容器倡议（OCI）标准的容器镜像仓库来存储和分享 chart。如果客户已经在用镜像仓库，chart 可以走同一条路，不需要额外的基础设施。

打包时还可以给 chart 签名，让客户收到后自行校验。Helm 文档说得很直接：如果校验失败，就有理由不信任这个包。如果客户有安全团队，提前准备好说明，让他们在安装前能自己校验签名。

## Helm 替你做不了的事

Helm 只会忠实地安装 chart 描述的内容。模板写错了，或者客户的 values 写错了，Helm 也会一模一样地把错误装上去。`helm template` 能帮你看到错误，但读输出的仍然是你。

在 `dependencies` 中声明的 chart，同样是别人写的代码，要运行在客户的集群里。放进你的包之前，你需要清楚它们会创建哪些资源。

版本方面呢？Helm 是云原生计算基金会（CNCF）的毕业项目：2018 年进入孵化阶段，2020 年 5 月 1 日达到 Graduated 状态。2025 年 11 月，Helm 4.0.0 在 KubeCon 上发布，这是六年来的第一个大版本。

`apiVersion: v2` 的 chart 至少需要 Helm 3，而现在 Helm 4 也已经可用。第一次技术会议时就问清客户平台团队用的是哪个版本，别等到安装当天。

## 按什么顺序学？

先学 chart 结构和 `values.yaml`，再弄清 `-f` 与 `--set` 的优先级，然后在测试集群上走一遍安装、升级、回滚的流程。打包、签名和推送到 OCI 仓库放在最后，但不要跳过。

如果 FDE 岗位描述里提到 Kubernetes，面试时大概率会问到 Helm。简历上不要只写“熟悉 Helm”。要写清你把一个服务打包成 chart，用独立的 values 文件把它装到多个环境，并在生产环境做过回滚：描述完整的工作链条，而不只是报出工具名。

好的 chart，能让第五个客户的安装和第二个一样平淡无奇。

**本周动手试试:**

- 找一个目前用零散 YAML 部署的应用，把它改成 apiVersion v2 的 chart，并把副本数、镜像 tag 和主机名移到 values.yaml 里。
- 为两个假想客户各建一份 values 文件，分别运行 helm template，对比生成的 manifest。
- 在测试集群上依次执行一次安装、两次升级，再回滚到 revision 2，每一步后记下 revision 编号，自行核对。

## 信源

- [Helm](https://helm.sh/)

- [Helm | CNCF](https://www.cncf.io/projects/helm/)

- [Charts | Helm](https://helm.sh/docs/topics/charts/)

- [Using Helm](https://helm.sh/docs/intro/using_helm/)

- [helm template | Helm](https://helm.sh/docs/helm/helm_template/)

- [Use OCI-based registries](https://helm.sh/docs/topics/registries/)

- [Helm Provenance and Integrity](https://helm.sh/docs/topics/provenance/)

- [Helm 4 Released](https://helm.sh/blog/helm-4-released/)
