Helm中tpl调用Files.Get文件时无法引用命名模板的问题

问题场景 #

目录结构如下：

files
  alertmanager
    rules
      - alertmanager.rules
      - nodes.rules
      ...
templates
  - _helpers.tpl
  - prometheus.yaml

• files/alertmanager/rules/alertmanager.rules中引用了_default_rule_labels命名模板
• templates/_helpers.tpl定义了alertmanager.rules和_default_rule_labels两个模板
• templates/prometheus.yaml通过include "alertmanager.rules" .加载告警规则

执行命令 helm template . -s templates/prometheus.yaml 时触发错误：

parse error at (root/templates/prometheus.yaml:15): function "_default_rule_labels" not defined

当前规则文件可正常渲染.Values变量，但无法引用命名模板。

解决办法 #

1. 迁移规则文件至templates目录 #

Helm仅自动将templates目录下的文件作为模板源处理，files目录文件默认是静态资源，不会参与命名模板的注册流程。将alertmanager/rules目录整体移到templates下，调整对应引用路径后，命名模板即可被正常识别。

调整后目录结构：

templates
  - _helpers.tpl
  - prometheus.yaml
  - alertmanager
    - rules
      - alertmanager.rules
      - nodes.rules
      ...

2. 通过readFile+tpl二次渲染规则文件 #

若不想移动文件位置，可修改_helpers.tpl中的alertmanager.rules模板，用readFile读取files目录下的规则文件，再通过tpl函数二次渲染，让规则文件中的命名模板引用生效：

{{- define "alertmanager.rules" -}}
{{- tpl (readFile "files/alertmanager/rules/alertmanager.rules") . -}}
{{- end -}}

注意：readFile的路径需相对于Chart根目录，确保路径准确。

3. 确保_helpers.tpl优先加载 #

Helm按字母顺序加载templates目录文件，若_helpers.tpl加载顺序晚于prometheus.yaml，会导致命名模板未提前注册。可给_helpers.tpl添加前缀（如00_helpers.tpl），保证它被最先加载。

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