You need to enable JavaScript to run this app. Helm Chart配置Ingress tls.hosts时如何同时写入静态域名与不定长扩展域名数组
优惠活动
大模型
产品
解决方案
定价
更多

Helm Chart配置Ingress tls.hosts时如何同时写入静态域名与不定长扩展域名数组

Helm Ingress TLS多域名hosts数组渲染报错解决方案

报错核心原因

你写的模板根本没生成合法的YAML数组结构,两层错误直接触发了校验失败:

  1. YAML结构解析错位。{{- range}}语法的前导减号作用是吃掉控制符之前的所有空白(包括换行、缩进),你之前把控制符放在列表项的缩进层级里,直接把上一行的换行符吃掉了,导致原本应该换行分隔的多个域名被挤成了同一行,最终被YAML解析器识别为"domain1 - domain2 - domain3"的单个长字符串,完全不符合tls.hosts需要字符串数组的要求。
  2. K8s DNS格式校验不通过。预期里hosts是多元素数组,每个元素是一个独立的合法域名;现在变成了单元素的长文本,K8s按照单DNS域名的规则校验时,自然会报DNS-1123格式错误——也就是报错规则要求的“DNS子域名必须由小写字母、数字、短横线、点组成,首尾为字母或数字”,因为这一整串文本根本不是单个域名。

稳定实现方案

方案1:内置函数数组合并(推荐,零格式问题)

别手动拆默认值写循环了,直接用Helm内置的list、concat、toYaml把固定默认域名和扩展域名数组合并输出,从根源上规避缩进、控制符吃换行的坑,不管扩展域名数量是0个、10个还是100个,都不会出格式问题:

spec:
  tls:
    hosts:
{{ list .Values.domain | concat .Values.regionalDomain | toYaml | indent 6 }}

逻辑很简单:先把固定的默认域名转成单元素数组,再和Values里的regionalDomain扩展域名数组合并,直接输出标准YAML数组结构,最后通过indent把整体缩进到hosts字段的子层级,完全不会出现格式错乱。

方案2:手动写默认值+循环的兼容写法

如果一定要保留“先写默认域名、再循环追加扩展域名”的结构,必须调整控制符的位置和缩进规则,核心是别把{{- range}}写在缩进层级里,不然肯定会吃掉换行搞乱结构:

spec:
  tls:
    hosts:
      - {{ .Values.domain }}
{{- range .Values.regionalDomain }}
      - {{ . }}
{{- end }}

两个必须注意的细节:

  • {{- range}}和对应的{{- end}}必须顶格写,控制符的前导减号只会吃掉上一行末尾的多余空白,不会破坏行与行之间的结构
  • 循环体内的列表项缩进,必须和默认域名的列表项完全一致(都是6个空格的缩进),别在循环块里额外加缩进

最终渲染效果

两种写法最终都会生成符合要求的YAML结构:

spec:
  tls:
    hosts:
      - domain1
      - domain2
      - domain3

额外提醒:确保Values里的regionalDomain配置项是纯字符串数组类型(比如regionalDomain: ["domain2.example.com", "domain3.example.com"]),别写成逗号拼接的字符串、键值对结构,不然循环或合并时取出来的值根本不对。

内容的提问来源于stack exchange,提问作者Timotei Manolache

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 21:15:10