如何在Helm中读取模板文件？执行tpl函数时遇报错求助

报错原因分析 #

你的报错出在tpl函数执行阶段，主要有两个核心诱因：

• 用quote处理多行模板内容：quote仅适配单行字符串，多行内容会被强制转义成单行，既破坏格式又触发语法解析错误。
• 目标模板文件（nginx.ingress.tmpl）包含Helm模板语法（比如{{ ... }}），但其中存在未定义的变量、未闭合的模板标签等语法问题，导致tpl渲染失败。

正确配置方案 #

根据模板文件是否包含Helm语法，分两种场景处理：

场景1：模板文件是纯静态内容（无Helm语法） #

无需tpl渲染，直接用Files.Get读取后以块文本格式输出即可：

apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx
  namespace: nginx-ingress
data:
  nginx.ingress.tmpl: |
{{ .Files.Get "nginx.ingress.tmpl" | indent 4 }}

场景2：模板文件包含Helm语法（需要渲染） #

使用tpl渲染后以块文本格式输出，同时要确保模板内的所有变量在当前Helm上下文（.)中已定义：

apiVersion: v1
kind: ConfigMap
metadata:
  name: nginx
  namespace: nginx-ingress
data:
  nginx.ingress.tmpl: |
{{ tpl (.Files.Get "nginx.ingress.tmpl") . | indent 4 }}

额外排查步骤 #

若场景2配置仍报错，需做以下检查：

• 核对nginx.ingress.tmpl内的模板语法，确保所有{{都有对应的}}，无语法疏漏。
• 确认模板中引用的变量（比如.Values.someKey）在values.yaml中已定义，或设置了默认值。
• 执行helm template命令查看完整渲染内容，定位具体的语法错误位置。

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