Helm v3 SDK 初始化需显式配置 RESTConfig 和绝对 Chart 路径，否则 panic；Install/Upgrade 需手动启用 Wait/Timeout 并处理 rollback；values 合并应使用 chartutil.CoalesceValues；release 名须符合 DNS-1123 规则并显式设 Namespace。
helm.sh/helm/v3 包怎么初始化客户端
不初始化好客户端，后续所有操作都会 panic 或返回 nil。关键不是“能不能连上 Tiller”（v3 已弃用 Tiller），而是得明确指定 RESTConfig 和本地 Chart 路径。
常见错误现象：error: no kubernetes configuration found，或 chart not found 却路径明明存在。
- 用
rest.InClusterConfig()时，必须确保程序运行在集群内且 ServiceAccount 有足够 RBAC 权限；本地调试优先用clientcmd.BuildConfigFromFlags("", kubeconfigPath) -
action.Config的Init()方法必须传入有效的*rest.Config，且不能复用未设置 Namespace 的 config（否则 release list 可能为空） - Chart 加载路径必须是绝对路径；
helm install用相对路径能工作，但 SDK 中loader.Load()会静默失败
install 和 upgrade 操作为什么总卡住或超时
不是代码写错了，而是默认行为太“保守”：SDK 不像 CLI 那样自动带 --wait 和 --timeout，它默认不等 release 就绪，也不设超时，导致 Release 对象返回了，但 Pod 根本没起来。
使用场景：CI/CD 流水线里需要确认 Helm release 真正就绪再往下走。
立即学习“go语言免费学习笔记（深入）”；
- 给
install.ActionConfig设置Wait: true和Timeout: 300 * time.Second，否则Install()返回后状态仍是PENDING_INSTALL -
Upgrade()默认是Recreate策略，若 Chart 里用了strategy: RollingUpdate，SDK 不感知，需手动检查Release.Manifest或调用kubectl get辅助判断 - 升级失败时，
Upgrade()不自动 rollback；要实现类似--atomic，得自己捕获 error 后调用Rollback()，且注意Rollback()本身也需Wait
如何安全读取 values.yaml 并注入自定义字段
直接用 yaml.Unmarshal() 解析 values 文件，容易忽略 Helm 的 value 合并逻辑（比如子 chart values 覆盖、--set 参数优先级），导致本地测试通过，上线后行为不一致。
性能影响：每次 Install() 前都全量解析 values，对高频发布服务会造成 GC 压力。
- 优先用
chartutil.CoalesceValues()处理主 chart + 子 chart + override values，它模拟了 Helm CLI 的合并规则 - 避免把敏感字段（如密码）硬编码进 Go 变量；改用
helm install --set-file对应的逻辑：读文件内容后塞进map[string]interface{}的对应 key 下 - 如果 values 来自 HTTP API，记得加 context 控制超时；
chartutil.LoadValues()是同步阻塞调用，不支持context.Context
release 名字重复或命名空间错配导致冲突
Helm SDK 不校验 release 名是否已存在，也不强制要求 release 名符合 DNS-1123 规则——但 Kubernetes 资源名（如 Job、Secret）生成时会直接拼接 release 名，一旦含下划线或大写字母，就会创建失败，报错 Invalid value: "my_release": a lowercase RFC 1123 subdomain must consist of lower case alphanumeric characters...。
兼容性影响：不同 Helm 版本对 release 名限制略有差异，v3.8+ 更严格。
- 用
strings.ToLower(regexp.MustCompile(`[^a-z0-9\-]+`).ReplaceAllString(releaseName, "-"))预处理，再 trim 开头结尾的- - 务必显式设置
ActionConfig.Namespace；即使 Chart values 里写了namespace: prod，SDK 也不会自动应用，它只控制 Helm 自身 release 记录的 namespace，不控制资源部署目标 - list releases 时，默认只查当前 namespace；跨 ns 查要用
action.List().AllNamespaces = true，但需 RBAC 支持list helmreleases集群权限
最麻烦的是 release 名和 Chart name 混用——SDK 里两者完全独立，但人容易当成一回事。名字冲突不会报错，只会覆盖旧 release，而旧资源可能残留，尤其是用了 hook 的 Chart。
