Helm模板渲染：如何保留Vault注入模板及实现部分变量替换

问题1：让Helm跳过Vault模板脚本，原样输出 #

Helm默认会解析{{ ... }}格式的内容，而Vault Agent的模板恰好使用相同语法，导致冲突失效。有两种可靠解决方式：

• 原始块包裹：将整段Vault模板用Helm的原始块标记包裹，Helm会直接输出这段内容，不做解析。示例：

  {{- /* raw */}}
  vault-agent-template: |
    {{ with secret "database/creds/my-role" }}
    username: {{ .Data.username }}
    password: {{ .Data.password }}
    {{ end }}
  {{- /* endraw */}}
  

• 转义双大括号：把Vault模板中的{{替换为{{ "{{" }}，}}替换为{{ "}}" }}，让Helm将其识别为普通字符串输出。适合小段模板内容，示例：

  vault-agent-template: |
    {{ "{{ with secret \"database/creds/my-role\" }}" }}
    username: {{ "{{ .Data.username }}" }}
    password: {{ "{{ .Data.password }}" }}
    {{ "{{ end }}" }}
  

问题2：混合使用Helm变量与Vault模板 #

要实现用values.yaml中的变量替换Vault模板部分内容，同时保留Vault自身的语法，可采用以下两种方式：

• 局部转义+Helm变量渲染：在需要替换的位置直接写Helm变量，其余Vault语法部分转义。示例：

  vault-agent-template: |
    {{ "{{ with secret \"database/creds/" }}{{ .Values.vault.roleName }}{{ "\" }}" }}
    username: {{ "{{ .Data.username }}" }}
    password: {{ "{{ .Data.password }}" }}
    user_role: {{ .Values.user_name_amin }}
    {{ "{{ end }}" }}
  

  这里Helm会正常渲染{{ .Values.vault.roleName }}和{{ .Values.user_name_amin }}，转义后的{{ "{{ ... }}" }}则会原样输出给Vault解析。

• tpl函数结合占位符：将Vault模板定义在values.yaml中，用Helm变量作为占位符，再通过tpl函数完成替换。
  values.yaml配置：

  vault:
    template: |
      {{ with secret "database/creds/{{ .roleName }}" }}
      username: {{ .Data.username }}
      password: {{ .Data.password }}
      user_role: {{ .userName }}
      {{ end }}
    roleName: my-app-role
    userName: {{ .Values.user_name_amin }}
  

  deployment.yaml中调用：

  vault-agent-template: |
    {{ tpl .Values.vault.template . }}
  

  这种方式通过tpl函数渲染values中的模板，替换占位符后，Vault的语法会被完整保留。

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