Helm条件模板渲染报错：YAML解析失败问题求助

问题场景 #

尝试通过values.yaml中的istioEnabled标志条件化部署Istio的DestinationRule资源，但执行Helm安装时触发YAML解析错误：

Error: INSTALLATION FAILED: YAML parse error on backend-chart/templates/virtualservice.yaml: error converting YAML to JSON: yaml: line 2: mapping values are not allowed in this context

错误原因 #

1. 模板缩进错误：{{ if }}块内的YAML内容存在多余缩进，导致YAML解析器将apiVersion视为上一级的映射值，触发结构错误。
2. 配置值类型不规范：istioEnabled被定义为字符串"true"，虽不直接引发当前错误，但不符合Helm条件判断的布尔值规范。
3. 缺失必填配置：istio.destinationRule.maxConnections在values.yaml中未定义，模板渲染后会产生空值，可能引发后续问题。
4. Labels格式处理不当：app.labels使用多行字符串格式定义，直接通过toYaml渲染会导致YAML结构异常。

修复步骤 #

1. 修正模板文件（backend-chart/templates/virtualservice.yaml） #

{{- if .Values.istioEnabled }}
apiVersion: networking.istio.io/v1alpha3
kind: DestinationRule
metadata:
  name: {{ .Values.istio.destinationRule.name }}
  namespace: {{ .Values.namespace }}
spec:
  host:
    - {{ .Values.service.name }}
  trafficPolicy:
    connectionPool:
      tcp:
        maxConnections: {{ .Values.istio.destinationRule.maxConnections }}
    loadBalancer:
      simple: {{ .Values.istio.destinationRule.loadBalancer }}
  subsets:
    - name: v1
      labels: {{- .Values.app.labels | fromYaml | toYaml | nindent 8 }}
{{- end }}

• 移除apiVersion等字段前的多余缩进，确保YAML结构合法。
• 使用nindent替代indent，自动添加换行保证格式规范。
• 通过fromYaml解析多行字符串格式的labels，再用toYaml输出正确结构。

2. 修正Values.yaml配置 #

namespace: default
app:
  name: backend-api
  labels:
    app: backend-api  # 改为直接的YAML映射，避免多行字符串解析问题
service:
  name: backend-service
istioEnabled: true  # 改为布尔值，符合Helm条件判断规范

istio:
  destinationRule:
    name: backend-destination-rule
    loadBalancer: RANDOM
    maxConnections: 100  # 补充缺失的连接数配置

  virtualService:
    name: backend-virtual
    timeout: 5s
    retries: 3
    perTryTimeout: 3s

• 将istioEnabled改为布尔值true。
• 补充maxConnections配置项，避免模板渲染空值。
• 调整app.labels为直接的YAML映射结构，简化渲染逻辑。

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