如何通过环境变量传递Terraform JSON资源定义并执行apply？

下面是几种通过JSON输入生成Terraform资源并执行apply的标准方法，针对你遇到的TF_VAR传递问题，先修正正确用法，再补充其他可行方案：

一、修正TF_VAR传递JSON的正确姿势 #

如果之前失败，大概率是JSON字符串未正确转义或变量解析逻辑有误，步骤如下：

1. 定义变量：在variables.tf中声明字符串类型变量，用于接收JSON：

variable "resources_json" {
  type        = string
  description = "JSON格式的资源定义"
}

2. 解析并生成资源：在main.tf中用jsondecode解析JSON，结合dynamic块动态生成资源：

locals {
  resources = jsondecode(var.resources_json)
}

# 以AWS实例为例，动态生成资源
dynamic "aws_instance" {
  for_each = local.resources.aws_instance
  content {
    ami           = aws_instance.value.ami
    instance_type = aws_instance.value.instance_type
    tags = {
      Name = aws_instance.key
    }
  }
}

3. 传递环境变量：注意JSON字符串要转义特殊字符，在bash中可以用单引号包裹：

export TF_VAR_resources_json='{"aws_instance": {"web": {"ami": "ami-0c55b159cbfafe1f0", "instance_type": "t2.micro"}}}'
terraform apply

二、使用变量文件传递JSON #

如果环境变量传递复杂，更稳妥的方式是用JSON格式的变量文件：

1. 创建变量文件config.json：

{
  "resources": {
    "aws_instance": {
      "web": {
        "ami": "ami-0c55b159cbfafe1f0",
        "instance_type": "t2.micro"
      }
    }
  }
}

2. 更新variables.tf：

variable "resources" {
  type        = any
  description = "结构化的资源定义"
}

3. 执行apply：

terraform apply -var-file=config.json

三、预转换JSON为HCL配置 #

如果需要复杂的验证逻辑，可以先通过脚本将输入JSON转换成Terraform可直接识别的HCL文件，再执行apply：

1. 编写转换脚本（比如用jq）：
   假设输入JSON是input.json，内容为：

{
  "aws_instance": [
    {"name": "web", "ami": "ami-xxx", "type": "t2.micro"},
    {"name": "db", "ami": "ami-yyy", "type": "t2.small"}
  ]
}

用jq生成main.tf：

jq -r '.aws_instance[] | "resource \"aws_instance\" \"\(.name)\" {\n  ami = \"\(.ami)\"\n  instance_type = \"\(.type)\"\n}"' input.json > main.tf

2. 执行Terraform：

terraform init && terraform apply

四、结合外部脚本做验证+转换 #

如果需要对输入JSON做严格验证（比如字段校验、格式检查），可以用Terraform的external数据源调用自定义脚本：

1. 编写验证转换脚本validate_json.py：

import json
import sys

def main():
    # 读取输入的JSON
    input_json = json.load(sys.stdin)
    
    # 执行验证逻辑：比如检查ami和instance_type是否存在
    for instance in input_json.get("aws_instance", {}).values():
        if "ami" not in instance or "instance_type" not in instance:
            print(json.dumps({"error": "缺少必填字段"}))
            sys.exit(1)
    
    # 返回转换后的结构化数据
    print(json.dumps(input_json))

if __name__ == "__main__":
    main()

2. 配置main.tf：

data "external" "validated_resources" {
  program = ["python", "${path.module}/validate_json.py"]

  query = {
    # 传递JSON字符串给脚本，这里可以从变量或环境变量获取
    input_json = var.resources_json
  }
}

locals {
  resources = jsondecode(data.external.validated_resources.result["input_json"])
}

dynamic "aws_instance" {
  for_each = local.resources.aws_instance
  content {
    ami           = aws_instance.value.ami
    instance_type = aws_instance.value.instance_type
    tags = {
      Name = aws_instance.key
    }
  }
}

3. 执行命令：

export TF_VAR_resources_json='{"aws_instance": {"web": {"ami": "ami-xxx", "instance_type": "t2.micro"}}}'
terraform apply

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