Terraform部署Airflow Helm Chart时values.yaml缩进错误排查

核心问题原因 #

直接通过file()读取官方Pod模板文件嵌入extraConfigMaps时，模板内容的缩进未匹配YAML嵌套层级，导致解析器识别到非法结构（比如顶层字段apiVersion与extraConfigMaps同级），触发缩进错误。

正确配置方法 #

方法1：通过Helm Release的set参数直接配置 #

在Terraform的helm_release资源中，使用indent()函数为读取到的模板内容添加对应层级的缩进，确保YAML结构合法：

resource "helm_release" "airflow" {
  name       = "airflow"
  repository = "https://airflow.apache.org"
  chart      = "airflow"
  version    = "2.8.0" # 替换为实际使用的Chart版本

  # 配置extraConfigMaps，嵌入Pod模板
  set {
    name  = "extraConfigMaps.airflow-pod-template.data.pod-template.yaml"
    # 缩进8个空格：匹配extraConfigMaps → airflow-pod-template → data → pod-template.yaml的嵌套层级
    value = indent(8, file("./pod-template-file.kubernetes-helm-yaml"))
    type  = "string" # 强制按字符串解析，避免Terraform自动拆分YAML
  }

  # 其他Airflow配置...
}

方法2：通过模板文件渲染values.yaml #

如果使用独立的values模板文件（比如values.tpl），可以通过templatefile()传递缩进后的模板内容：

1. 创建values.tpl文件：

extraConfigMaps:
  airflow-pod-template:
    data:
      pod-template.yaml: |
        ${indent(8, pod_template_content)}

2. 在Terraform中渲染并使用该模板：

resource "helm_release" "airflow" {
  name       = "airflow"
  repository = "https://airflow.apache.org"
  chart      = "airflow"
  version    = "2.8.0"

  values = [
    templatefile("./values.tpl", {
      pod_template_content = file("./pod-template-file.kubernetes-helm-yaml")
    })
  ]

  # 其他Airflow配置...
}

关键注意事项 #

• 缩进层级计算：extraConfigMaps下嵌套3层（configmap名称→data→模板文件名），因此模板内容需要缩进8个空格（每层2个空格，最终内容相对于根层级缩进8位）
• 必须指定type = "string"：在set参数中如果不指定类型，Terraform会尝试将内容解析为YAML，导致结构混乱
• 验证模板内容：确保官方Pod模板文件本身无语法错误（官方仓库模板通常没问题，也可提前用yamllint检查）

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