如何在Terraform Helm Release中正确遍历用户对象列表？

问题根源 #

用helm_release的set参数传递嵌套列表/对象时，Terraform会自动将复杂结构序列化为字符串，导致Helm接收到的不是可迭代的列表类型，自然无法用range遍历。而你直接在helm-playground测试模板逻辑正常，说明模板本身没问题，问题出在Terraform到Helm的参数传递格式上。

正确实现步骤 #

1. 确保Terraform变量定义正确 #

先确认你的users变量是list(object)类型，示例定义：

variable "users" {
  type = list(object({
    username  = string
    role      = string
    databases = list(string)
  }))
  default = [
    {
      username  = "dev_user"
      role      = "readwrite"
      databases = ["app_db", "log_db"]
    },
    {
      username  = "readonly_user"
      role      = "readonly"
      databases = ["app_db"]
    }
  ]
}

2. 用values参数传递完整结构 #

不要用set传递复杂对象，改用values参数直接传入序列化后的YAML结构，确保Helm收到的是原生列表。

方法一：仅传递users配置

resource "helm_release" "my_service" {
  name       = "my-service"
  repository = "https://your-chart-repo.com/"
  chart      = "your-chart"
  version    = "2.1.0"

  values = [
    yamlencode({
      users = var.users
    })
  ]
}

方法二：结合本地values.yaml文件

如果需要和本地的values.yaml合并，直接将序列化后的配置加入values列表（后面的配置会覆盖前面的同名键）：

resource "helm_release" "my_service" {
  name       = "my-service"
  repository = "https://your-chart-repo.com/"
  chart      = "your-chart"
  version    = "2.1.0"

  values = [
    file("${path.module}/values.yaml"),
    yamlencode({
      users = var.users
    })
  ]
}

3. 确认Helm模板的遍历逻辑 #

确保模板里的遍历语法正确（你已经测试过，但再贴一个典型示例）：
比如在deployment.yaml中生成用户配置环境变量：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}
spec:
  template:
    spec:
      containers:
      - name: app-container
        image: your-app-image:latest
        env:
        {{- range .Values.users }}
        - name: USER_{{ .username | upper }}_CONFIG
          value: |
            username: {{ .username }}
            role: {{ .role }}
            databases: {{ join "," .databases }}
        {{- end }}

4. 验证传递结果 #

部署后执行以下命令，检查Helm接收到的users是否为正确的列表结构：

helm get values my-service

输出应该显示users是数组而非字符串。

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