在Helm中实现‘存在则插入’辅助函数的技术咨询

我正在创建一个用于十余个不同部署的Helm库图表，每个部署仅包含一个容器。部分部署的容器定义需要包含imagePullPolicy、ports字段，其余部署则不需要：

spec:
  containers: 
    - image: hostname/imagename:versionNumber
      imagePullPolicy: Always # 仅部分图表需要该字段
      ports:             
      - containerPort: xxxx # 同样不是所有YAML文件都需要

目前我通过嵌套if语句实现字段的可选渲染，但重复使用这套逻辑违反DRY原则：

{{ if .Values.container }}
{{ if .Values.container.port }}
ports: {{ .Values.container.port }}
{{ end }}
{{ end }}

请问是否存在具备该功能的现有Helm函数？若没有，能否编写仅需传入完整路径作为参数的辅助函数？

现有Helm内置函数解决方案 #

Helm 3提供了dig函数，可以安全地嵌套查找值，避免因父级字段不存在而引发的模板渲染错误，同时简化判断逻辑：

使用dig函数 #

dig函数接收路径片段、默认值和根对象，若路径不存在则返回默认值，我们可以利用这一点做条件判断：

spec:
  containers:
    - image: {{ .Values.container.image }}
      {{- if dig "container" "imagePullPolicy" nil .Values }}
      imagePullPolicy: {{ .Values.container.imagePullPolicy }}
      {{- end }}
      {{- if dig "container" "ports" nil .Values }}
      ports: {{- toYaml .Values.container.ports | nindent 8 }}
      {{- end }}

这种方式无需嵌套if，一次判断即可完成字段存在性检查。

使用hasKey函数（需注意父级存在性） #

如果能确保父级字段（如.Values.container）一定存在，也可以用hasKey直接检查子字段：

{{- if hasKey .Values.container "imagePullPolicy" }}
imagePullPolicy: {{ .Values.container.imagePullPolicy }}
{{- end }}

但如果父级字段可能不存在，hasKey会触发模板错误，因此dig是更安全的选择。

自定义辅助函数实现 #

如果需要更简洁的调用方式（仅传入字段路径即可），可以在库图表的templates/_helpers.tpl中定义自定义函数：

定义辅助函数 #

{{/*
安全渲染指定路径的Kubernetes字段，仅当路径存在且有值时输出
参数说明:
1. 字段路径（字符串，如 "container.imagePullPolicy"）
2. 根对象（通常为 .Values）
3. 可选：自定义字段名（默认使用路径最后一段）
*/}}
{{- define "lib.renderIfExists" -}}
{{- $pathParts := splitList "." (index . 0) -}}
{{- $root := index . 1 -}}
{{- $fieldName := default (last $pathParts) (index . 2) -}}
{{- $currentValue := $root -}}
{{- $pathExists := true -}}

{{- range $part := $pathParts -}}
  {{- if not (hasKey $currentValue $part) -}}
    {{- $pathExists = false -}}
    {{- break -}}
  {{- end -}}
  {{- $currentValue = index $currentValue $part -}}
{{- end -}}

{{- if and $pathExists $currentValue -}}
  {{- printf "%s:" $fieldName | nindent 6 -}}
  {{- toYaml $currentValue | nindent 8 -}}
{{- end -}}
{{- end -}}

在模板中使用 #

只需传入字段路径和.Values即可，无需重复写判断逻辑：

spec:
  containers:
    - image: {{ .Values.container.image }}
      {{- include "lib.renderIfExists" (list "container.imagePullPolicy" .Values) }}
      {{- include "lib.renderIfExists" (list "container.ports" .Values) }}

如果需要自定义输出的字段名（比如路径和实际字段名不一致），可以传入第三个参数：

{{- include "lib.renderIfExists" (list "container.customPort" .Values "ports") }}

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