如何在GitLab CI/CD中向Chart.yml传递参数化变量？

现有Chart.yml内容如下：

apiVersion: v2
name: test-api
version: 0.0.0
description: This is the job for testing 
sources:
- <gitlab project link>
maintainers:
- name: <Team Name>
  email: <Team email>

想要将GitLab CI变量传递给Chart的name字段，因此在gitlab-ci.yml中定义了变量：

variables:
  CHART_NAME: 'test-api'

尝试直接在Chart.yml中引用变量：

apiVersion: v2
name: ${CHART_NAME}
version: 0.0.0
description: This is the job for testing 
sources:
- <gitlab project link>
maintainers:
- name: <Team Name>
  email: <Team email>

但执行Helm发布时流水线失败，原因是Chart.yml无法读取CHART_NAME变量的值。请问能否从gitlab-ci.yml向Chart.yml传递变量？求解决方案。

解决方案 #

Helm本身不会解析Chart.yml中的Shell环境变量，因此需要在CI流水线中先修改Chart.yml内容，再执行Helm命令。以下是几种可行方案：

方案1：用sed命令直接替换字段值 #

在GitLab CI的Job步骤中，先通过sed替换Chart.yml里的name字段，再执行Helm操作：

# 替换Chart.yml中的name字段为CI变量值
sed -i "s/^name:.*/name: $CHART_NAME/" Chart.yml

# 后续执行Helm打包或发布命令
helm package .
helm push test-api-0.0.0.tgz <你的仓库地址>

方案2：用yq工具修改YAML文件（更灵活） #

如果需要修改多个YAML字段，推荐使用yq工具（需确保CI环境已安装）：

# 安装yq（以Debian/Ubuntu环境为例）
apt-get update && apt-get install -y yq

# 修改Chart.yml的name字段
yq eval '.name = env(CHART_NAME)' -i Chart.yml

# 执行Helm发布命令
helm install . --generate-name

方案3：仅指定Helm发布名称（无需修改Chart.yml） #

如果只是需要在安装时自定义Helm实例的发布名称，而非修改Chart本身的name字段，可以直接使用helm install的--name-template参数：

helm install --name-template $CHART_NAME .

此方法不会改动Chart.yml内容，仅影响Helm发布后的资源名称。

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