如何在单个backends.tf中为多GCP项目配置独立GCS Terraform后端？

要实现将不同GCP项目的资源状态分别存储到对应项目的GCS存储桶中，你需要结合Terraform工作区和动态后端配置来完成，具体步骤如下：

1. 提前在各GCP项目创建状态存储桶 #

首先在每个GCP项目（project-01、project-02、project-03）中创建一个用于存储Terraform状态的GCS桶，注意桶名必须全球唯一，建议命名格式如tf-state-<项目ID>-<唯一后缀>（比如tf-state-project-01-2024）。

同时给桶启用版本控制（可选但推荐），防止状态文件意外丢失或覆盖；并确保Terraform使用的服务账号拥有该桶的读写权限（需包含storage.objects.create、storage.objects.get、storage.objects.list、storage.objects.delete权限）。

2. 编写动态后端配置文件（backends.tf） #

在Terraform根目录创建backends.tf，使用变量来动态指定后端参数，这样不同工作区可以指向不同项目的桶：

terraform {
  backend "gcs" {
    prefix = "terraform/state" # 状态文件在桶中的存储路径前缀
  }
}

# 定义所需变量
variable "project_id" {
  type        = string
  description = "当前工作区对应的GCP项目ID"
}

variable "tf_state_bucket" {
  type        = string
  description = "存储当前工作区状态的GCS桶名"
}

3. 为每个项目创建单独的后端配置文件 #

在根目录下为每个项目创建一个后端配置文件，用于指定对应项目的桶和项目ID：

• backend-project-01.hcl

bucket  = "tf-state-project-01-2024" # 替换为你创建的project-01的桶名
project = "project-01"

• backend-project-02.hcl

bucket  = "tf-state-project-02-2024" # 替换为你创建的project-02的桶名
project = "project-02"

• backend-project-03.hcl

bucket  = "tf-state-project-03-2024" # 替换为你创建的project-03的桶名
project = "project-03"

4. 创建并配置Terraform工作区 #

每个工作区对应一个GCP项目，用于隔离不同项目的状态和资源：

# 创建三个工作区，分别对应三个项目
terraform workspace new project-01
terraform workspace new project-02
terraform workspace new project-03

# 为每个工作区初始化后端配置
# 处理project-01
terraform workspace select project-01
terraform init -backend-config=backend-project-01.hcl

# 处理project-02
terraform workspace select project-02
terraform init -backend-config=backend-project-02.hcl

# 处理project-03
terraform workspace select project-03
terraform init -backend-config=backend-project-03.hcl

5. 调整模块调用逻辑，按工作区过滤资源 #

在main.tf中调整模块调用的for_each逻辑，让每个工作区只创建对应项目的云实例：

module "compute_instances" {
  source = "./modules/compute_instance" # 替换为你的Compute Instance模块路径

  # 只筛选当前工作区对应项目的实例配置
  for_each = {
    for k, v in var.compute_instances : k => v
    if v.project_id == terraform.workspace
  }

  project_id     = each.value.project_id
  instance_name  = each.value.instance_name
  zone           = each.value.zone
  machine_type   = each.value.machine_type
}

后续操作流程 #

之后管理资源时，只需切换到对应工作区执行Terraform命令即可：

# 比如管理project-01的资源
terraform workspace select project-01
terraform plan
terraform apply

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