Helm Chart配置Ingress tls.hosts时如何同时写入静态域名与不定长扩展域名数组
Helm Ingress TLS多域名hosts数组渲染报错解决方案
报错核心原因
你写的模板根本没生成合法的YAML数组结构,两层错误直接触发了校验失败:
- YAML结构解析错位。
{{- range}}语法的前导减号作用是吃掉控制符之前的所有空白(包括换行、缩进),你之前把控制符放在列表项的缩进层级里,直接把上一行的换行符吃掉了,导致原本应该换行分隔的多个域名被挤成了同一行,最终被YAML解析器识别为"domain1 - domain2 - domain3"的单个长字符串,完全不符合tls.hosts需要字符串数组的要求。 - 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
相关产品推荐
相关产品推荐

