为何无法在Helm模板助手函数中访问$.Release.Name？

核心原因 #

当子chart（bar）调用父chart（foo）中定义的模板时，模板内部的$指向的是父chart的根上下文，而非子chart的全局上下文。父chart的根上下文在子chart渲染阶段未正确填充Release对象，导致$.Release.Name触发空指针错误。而你在子chart模板中直接使用$.Release.Name正常，是因为子chart自身的全局上下文包含了完整的Release信息。

解决方案 #

方案一：传递全局上下文到模板

将子chart的全局上下文（$）作为参数传入模板，在模板中通过该参数访问Release信息。

修改模板调用代码：

apiVersion: v1
kind: ServiceAccount 
{{- $labels := include "foo.makeLabels" (dict 
    "name" $.Values.foo.namespace 
    "component" $.Values.bar.name 
    "root" $  # 传递子chart的全局上下文
) }}
{{- with .Values }} 
metadata:
  name: {{ print .foo.namespace "-" .bar.name }}
  namespace: {{ .foo.namespace }}
  labels:
{{- $labels | nindent 4 }}
{{- end -}}

修改模板定义：

{{/*
Create labels for component given by dict 
*/}}
{{- define "foo.makeLabels" -}}
{{- $new := dict "app.kubernetes.io/managed-by" "Helm"  -}}
{{- $_ := set $new "meta.helm.sh/release-name" .root.Release.Name -}}  # 使用传递的全局上下文
{{- range $key, $val := . }}
{{-   if ne $key "root" }}  # 跳过全局上下文参数
{{-     $_ := set $new (print "app.kubernetes.io/" $key) $val }}
{{-   end }}
{{- end -}}
{{- toYaml $new }}
{{- end -}}

方案二：直接传递Release名称

如果只需要Release.Name，可以直接将其作为参数传入模板，避免依赖全局上下文。

修改模板调用代码：

apiVersion: v1
kind: ServiceAccount 
{{- $labels := include "foo.makeLabels" (dict 
    "name" $.Values.foo.namespace 
    "component" $.Values.bar.name 
    "releaseName" $.Release.Name  # 直接传递Release名称
) }}
{{- with .Values }} 
metadata:
  name: {{ print .foo.namespace "-" .bar.name }}
  namespace: {{ .foo.namespace }}
  labels:
{{- $labels | nindent 4 }}
{{- end -}}

修改模板定义：

{{/*
Create labels for component given by dict 
*/}}
{{- define "foo.makeLabels" -}}
{{- $new := dict "app.kubernetes.io/managed-by" "Helm"  -}}
{{- $_ := set $new "meta.helm.sh/release-name" .releaseName -}}  # 使用传递的Release名称
{{- range $key, $val := . }}
{{-   if ne $key "releaseName" }}  # 跳过Release名称参数
{{-     $_ := set $new (print "app.kubernetes.io/" $key) $val }}
{{-   end }}
{{- end -}}
{{- toYaml $new }}
{{- end -}}

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