Helm tpl函数在ConfigMap中解析YAML文件失败求助

问题根源 #

在range循环内部，.的作用域会切换为当前遍历的$file对象，而非Helm Chart的全局上下文（包含.Values、.Release等核心变量）。直接将.传递给tpl函数，会导致模板渲染时无法访问所需配置，进而引发语法解析错误（如你遇到的bad character U+002D '-'）。

正确的Helm模板代码 #

apiVersion: v1
kind: ConfigMap
metadata:
  name: {{ .Values.configMapName }}
  labels:
    app: {{ .Release.Name }}
data:
{{- $globalCtx := . }}  # 保存全局上下文到变量，避免range循环覆盖作用域
{{- $files := .Files.Glob (printf "%s/*" .Values.dirName) }}
{{- range $path, $file := $files }}
  {{ base $path }}: |
{{ tpl ($file | toString) $globalCtx | indent 4 }}  # 使用全局上下文渲染文件内的模板语法
{{- end }}

关键说明 #

1. 保存全局上下文：通过$globalCtx := .将Chart的全局上下文（包含.Values、.Release等）保存到变量中，确保range循环内可以访问到原始配置。
2. 传递正确上下文：在tpl函数中传入$globalCtx作为渲染上下文，这样文件内的{{ .Values.my_var }}等模板标签就能正确解析到对应配置值。
3. 保留原始内容：除{{ ... }}包裹的模板语法外，文件内的其他内容（包括复杂JSON、转义字符等）都会原封不动保留。

额外注意事项 #

• 若文件内容中存在非模板语法的{{或}}（比如JSON字符串内的转义字符），需要用{{ "{{" }}或{{ "}}" }}进行转义，避免被tpl函数错误解析。
• 确保config目录下的文件已被Helm正确识别（文件需放在Chart的根目录或指定路径下，GitOps场景需确保仓库同步正确）。

内容的提问来源于stack exchange，提问作者Alessandro D'Armiento