如何在GCP上实现Terraform后端参数化配置？

1. 调整Terraform配置文件（main.tf） #

Terraform的backend块不支持直接引用输入变量，因此需要移除硬编码的占位符，改为通过命令行传入动态配置：

terraform {
  required_version = ">= 0.13"
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "~> 4.9.0"
    }
  }
  # 仅声明GCS backend类型，具体配置通过命令行传入
  backend "gcs" {}
}

如果bucket是固定值（如my-bucket），也可以保留在配置中简化命令：

terraform {
  required_version = ">= 0.13"
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "~> 4.9.0"
    }
  }
  backend "gcs" {
    bucket = "my-bucket"
  }
}

2. 编写可复用的Cloud Build模板（terraform_apply.yaml） #

创建通用模板文件，接收环境和国家参数，执行完整的Terraflow流程：

steps:
  # 初始化Terraform，传入动态backend配置
  - name: 'hashicorp/terraform:1.3'
    args:
      - 'init'
      - '-backend-config=bucket=my-bucket'
      - '-backend-config=prefix=/tfstate/${_PREPROD_OR_PROD}/${_COUNTRY}'
    env:
      - 'TF_IN_AUTOMATION=true'

  # 生成执行计划
  - name: 'hashicorp/terraform:1.3'
    args:
      - 'plan'
      - '-out=tfplan'
    env:
      - 'TF_IN_AUTOMATION=true'

  # 应用变更
  - name: 'hashicorp/terraform:1.3'
    args:
      - 'apply'
      - 'tfplan'
    env:
      - 'TF_IN_AUTOMATION=true'

若main.tf中已定义bucket，可删除-backend-config=bucket=my-bucket参数

3. 编写主Cloud Build配置文件（cloudbuild.yaml） #

通过substitutions传递参数，复用上述模板：

# 设置默认参数（触发时可覆盖）
substitutions:
  _PREPROD_OR_PROD: 'pre-prod'
  _COUNTRY: 'portugal'

steps:
  - name: 'gcr.io/cloud-builders/gcloud'
    args: 
      [
        'builds', 'submit', 
        '--config=terraform_apply.yaml', 
        '--substitutions', '_PREPROD_OR_PROD=${_PREPROD_OR_PROD},_COUNTRY=${_COUNTRY}'
      ]

4. 触发不同场景的构建 #

通过替换参数适配6种场景，示例命令：

• 预生产环境-葡萄牙：
  gcloud builds submit --config=cloudbuild.yaml --substitutions="_PREPROD_OR_PROD=pre-prod,_COUNTRY=portugal"
• 生产环境-意大利：
  gcloud builds submit --config=cloudbuild.yaml --substitutions="_PREPROD_OR_PROD=prod,_COUNTRY=italy"
• 其余场景只需替换对应的_PREPROD_OR_PROD和_COUNTRY值即可

关键说明 #

• Terraform backend配置无法直接使用变量，必须通过terraform init -backend-config动态传入完整路径；
• Cloud Build通过substitutions实现模板复用，避免重复编写相同流程；
• TF_IN_AUTOMATION=true用于禁用Terraform的交互式提示，适配自动化环境。

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