一个 Helm chart 服务多个客户,告别手改 YAML
chart 带版本,每个客户一份 values 文件,每次安装都有历史,回滚只需一条命令。
要点速览
- chart 是带进客户集群的交付单元:manifest 放在 templates 里,默认配置放在 values.yaml 里,客户专属配置放在单独的 values 文件里。
- 每次安装、升级或回滚,revision 都加 1,因此客户集群上的每次变更都有一个可以回退的编号。
- 用 helm template 预览 manifest,通过 OCI 仓库分发,并给包签名,让客户能校验收到的内容。
设想下周你要把同一个服务装进两个客户的 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 的:
# 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 将要创建什么:
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,能让第五个客户的安装和第二个一样平淡无奇。
这篇文章对你有帮助吗?
感谢你的反馈!