如何在Helm Go模板中引用另一个YAML文件的部分内容

核心思路 #

先将abc.yaml解析为Go可识别的嵌套数据结构（map或结构体），再用Go模板引擎渲染values.yaml.j2，直接通过层级语法引用目标字段，替代逐行读取的低效方式。

步骤实现 #

1. 准备示例文件 #

abc.yaml（数据源）

metadata:
  test1: "foo"
  test2: "bar"
  test3: 123
container:
  image: "nginx:latest"
  text: "hello world"
variables:
  env: "prod"

values.yaml.j2（Go模板文件）

# 渲染后的values.yaml模板
app_metadata:
  key1: {{ .metadata.test1 }}
  key2: {{ .metadata.test2 }}
  key3: {{ .metadata.test3 }}
container_config:
  image: {{ .container.image }}
  description: {{ .container.text }}
environment: {{ .variables.env }}
# 可选：字段不存在时设置默认值
fallback_val: {{ .metadata.test4 | default "default_value" }}

2. Go代码实现 #

使用gopkg.in/yaml.v3解析YAML，结合text/template渲染模板：

package main

import (
	"os"
	"text/template"

	"gopkg.in/yaml.v3"
)

func main() {
	// 1. 读取并解析abc.yaml为嵌套map
	abcYAML, err := os.ReadFile("abc.yaml")
	if err != nil {
		panic(err)
	}
	var data map[string]interface{}
	if err := yaml.Unmarshal(abcYAML, &data); err != nil {
		panic(err)
	}

	// 2. 加载并解析values.yaml.j2模板
	tmpl, err := template.New("values").Funcs(template.FuncMap{
		"default": func(def interface{}, val interface{}) interface{} {
			if val == nil {
				return def
			}
			return val
		},
	}).ParseFiles("values.yaml.j2")
	if err != nil {
		panic(err)
	}

	// 3. 渲染模板并输出结果（可写入文件或直接打印）
	if err := tmpl.Execute(os.Stdout, data); err != nil {
		panic(err)
	}
}

3. 关键说明 #

• 层级字段引用：Go模板支持.语法访问嵌套字段，如.metadata.test1直接对应abc.yaml中metadata下的test1值
• 默认值处理：通过自定义default函数，可在目标字段不存在时返回默认值，避免渲染报错
• 结构体替代map：如果abc.yaml的结构固定，可定义对应的Go结构体替代map[string]interface{}，获得类型安全的字段访问

运行结果 #

执行上述代码后，输出的渲染结果为：

# 渲染后的values.yaml模板
app_metadata:
  key1: foo
  key2: bar
  key3: 123
container_config:
  image: nginx:latest
  description: hello world
environment: prod
# 可选：字段不存在时设置默认值
fallback_val: default_value

内容的提问来源于stack exchange，提问作者Prabhu Vignesh Rajagopal