如何通过Helm Go SDK安装Chart时传入YAML配置文件？

我们使用helm.sh/helm/v3/pkg/action包安装Helm Chart时，必须先将values.yaml文件反序列化为map[string]interface{}，再传入client.Run()方法——action包的Run方法仅接收map[string]interface{}类型的参数，没有直接传入文件路径或YAML内容的接口。

这和Helm CLI的-f values.yaml逻辑本质一致：CLI底层也是读取文件后解析为map，再传递给安装逻辑，只是这一步在CLI中自动完成了，而Go客户端需要我们手动实现。

完整示例代码 #

package main

import (
	"log"
	"os"

	"helm.sh/helm/v3/pkg/action"
	"helm.sh/helm/v3/pkg/chart/loader"
	"gopkg.in/yaml.v3"
)

func main() {
	// 初始化action配置与安装客户端
	cfg := new(action.Configuration)
	installClient, err := action.NewInstall(cfg)
	if err != nil {
		log.Fatalf("初始化安装客户端失败: %v", err)
	}

	// 配置安装参数
	installClient.Namespace = "default"
	installClient.ReleaseName = "my-demo-release"

	// 加载目标Helm Chart
	targetChart, err := loader.Load("./charts/my-chart")
	if err != nil {
		log.Fatalf("加载Chart失败: %v", err)
	}

	// 读取并解析values.yaml文件
	customVals := make(map[string]interface{})
	yamlData, err := os.ReadFile("./utils/values.yaml")
	if err != nil {
		log.Fatalf("读取values.yaml失败: %v", err)
	}
	if err := yaml.Unmarshal(yamlData, &customVals); err != nil {
		log.Fatalf("解析values.yaml失败: %v", err)
	}

	// 执行Chart安装
	release, err := installClient.Run(targetChart, customVals)
	if err != nil {
		log.Fatalf("安装Chart失败: %v", err)
	}

	log.Printf("Chart安装成功，Release名称: %s", release.Name)
}

额外说明 #

如果需要合并多组values（比如Chart默认values + 自定义values.yaml + 临时传入的参数map），可以使用helm.sh/helm/v3/pkg/chartutil包的CoalesceValues方法自动处理覆盖优先级，无需手动合并：

import "helm.sh/helm/v3/pkg/chartutil"

// 合并默认values与自定义values
mergedVals, err := chartutil.CoalesceValues(targetChart, customVals)
if err != nil {
	log.Fatalf("合并values失败: %v", err)
}

// 使用合并后的values执行安装
rel, err := installClient.Run(targetChart, mergedVals)

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