如何将Go Template放入环境值并在releases.values中解析？

问题核心 #

环境值文件中的Go模板在环境加载阶段过早解析，此时依赖的全局值（如registry.docker.url）还未完成合并，导致解析结果为空。需要让这些模板延迟到releases.values阶段，待所有Values合并完成后再执行渲染。

解决方案思路 #

1. 保留环境中的模板字符串：将环境值里需要动态渲染的内容以原始字符串形式保存，避免在环境加载时提前解析。
2. 在release阶段渲染模板：在release的values模板中，使用Helmfile的tpl函数，结合合并后的完整.Values上下文来渲染环境传递过来的模板字符串。

修改后的示例文件 #

1. helmfile.yaml（保持不变）

releases:
  - name: cluster
    chart: ../charts/cluster
    values:
      - values/cluster/values.yaml.gotmpl

environments:
  development:
    values:
      - ./environments/development/values.yaml.gotmpl

2. environments/development/values.yaml.gotmpl

将需要延迟渲染的chartValues改为模板字符串（用|定义多行原始内容）：

registry:
  docker:
    url: "registry.hub.docker.com"

service-1:
  enabled: true
  chartValuesTpl: |
    image:
      repository: {{ .Values.registry.docker.url }}/service-1

service-2:
  enabled: true
  chartValuesTpl: |
    image:
      repository: {{ .Values.registry.docker.url }}/service-2

3. values/cluster/values.yaml.gotmpl

使用tpl函数渲染环境传递的模板字符串，此时.Values已包含所有合并后的数据：

registry:
  docker:
    url: '{{ .Values | get "registry.docker.url" "" }}'

service-1:
  enabled: {{ .Values | get "service-1.enabled" false }}
  chartValues:
{{ tpl .Values.service-1.chartValuesTpl $ | indent 4 }}

service-2:
  enabled: {{ .Values | get "service-2.enabled" false }}
  chartValues:
{{ tpl .Values.service-2.chartValuesTpl $ | indent 4 }}

关键说明 #

• chartValuesTpl作为原始字符串传递，不会在环境加载阶段解析，完整保留模板语法。
• tpl .Values.service-1.chartValuesTpl $中的$表示根上下文，包含了环境值、release值等所有合并后的全局数据，此时{{ .Values.registry.docker.url }}能正确获取到环境中定义的地址。
• 该方案支持嵌套的chartValues结构，多行模板字符串渲染后会自动保持YAML缩进格式。

内容的提问来源于stack exchange，提问作者stucki-stuck