使用Helm在Kubernetes集群安装Overleaf时遇模板字段错误求助

错误根源 #

报错的核心原因是Helm模板逻辑与配置结构不匹配：

• 模板文件_ports.tpl中使用range .Values.service，这行代码期望.Values.service是一个列表（数组），会遍历列表中的每个service对象。
• 但你的配置（包括官方values.yaml）里的service是单个对象，不是列表。当模板执行range .Values.service时，会把单个service对象的所有键（比如enabled、type、ports）作为循环项，每个循环项是字符串类型，自然不存在.enabled字段，因此抛出错误。

解决方案 #

你可以选择以下两种方式解决：

方案1：调整配置为列表格式 #

把values中的service改成数组结构，匹配模板的预期：

values:
  service:
    - enabled: true
      type: ClusterIP
      ports:
        codeserver:
          port: 12321
          enabled: true
          protocol: TCP
          targetPort: codeserver
      annotations: {}
      labels: {}

方案2：修改模板适配单个对象 #

如果官方values.yaml本身就是单个service对象（说明模板可能存在bug），可以修改_ports.tpl文件，去掉不必要的range循环，直接引用单个service对象：

{{/*
 Ports included by the controller.
 */}}
{{- define "common.controller.ports" -}}
  {{- $ports := list -}}
  {{- $service := .Values.service -}}
  {{- if $service.enabled -}}
    {{- range $name, $port := $service.ports -}}
      {{- $_ := set $port "name" $name -}}
      {{- $ports = mustAppend $ports $port -}}
    {{- end }}
  {{- end }}
{{- end }}

验证修改 #

修改完成后，先执行helm template命令预览渲染结果，确认没有错误后再执行安装：

helm template your-release-name ./overleaf-chart -f your-values.yaml

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