如何在Helm3 Chart中正确设置appVersion字段实现动态替换生效

问题根因 #

Chart.yaml 是 Helm Chart 的静态元数据文件，Helm 默认不会对该文件执行模板渲染，你在字段中写入的 Go 模板表达式 {{ .Values.image.tag }} 会被直接识别为纯字符串，不会解析为对应的变量值。

可行解决方案 #

方案1：升级时直接指定--app-version参数 #

这是最简便的方案，直接在helm upgrade命令中追加参数指定版本即可，修改后的命令如下：

helm upgrade my-app my-app-chart --atomic --set image.tag=123 --app-version 123

执行后查询helm history的APP VERSION列就会直接显示123。

方案2：部署前动态修改Chart.yaml的appVersion字段 #

如果需要自动化同步镜像tag和appVersion，可以在CI/CD流程中通过命令行工具直接修改Chart.yaml的取值：
比如使用yq工具修改的命令如下：

yq eval ".appVersion = \"123\"" -i Chart.yaml

修改完成后再执行helm upgrade命令即可。

方案3：预渲染Chart.yaml文件 #

如果不想手动维护两个重复的版本参数，可以在执行Helm命令前，使用gomplate等模板渲染工具先对Chart.yaml进行预渲染，将模板变量替换为实际取值后再执行部署操作。

注意事项 #

• Helm官方默认不支持对Chart.yaml做模板渲染，所有元数据字段均为静态值，不要在生产环境使用实验性的元数据模板功能
• Chart.yaml中的version字段（Chart自身版本）同样属于静态元数据，也不支持模板表达式

内容的提问来源于stack exchange，提问作者Tim