GitHub Actions运行Terraform plan时重建已导入资源如何解决

核心原因是terraform import操作的结果只会写入Terraform状态文件，你本地操作时状态默认保存在本地工作目录的terraform.tfstate文件中，没有同步到GitHub Actions运行环境。GitHub Actions每次执行任务都是全新的临时环境，执行terraform init时拉取不到你本地已经记录了存量资源映射关系的状态文件，会判定配置中定义的所有资源都不存在，因此提示需要重建。

• 第一步：配置GCS远程状态后端
  GCP场景下优先使用GCS存储桶作为Terraform远程状态存储，保证本地和CI环境共用同一份状态：
  1. 在对应GCP项目中创建专用GCS存储桶，开启对象版本控制功能，关闭公共访问权限，避免状态文件丢失或泄露。
  2. 给本地操作使用的账号、GitHub Actions流水线绑定的GCP服务账号授予该存储桶的读写权限。
  3. 在你的main.tf中添加后端配置，示例如下：

  terraform {
    backend "gcs" {
      bucket = "替换为你创建的GCS桶名称"
      prefix = "env/prod/state" # 自定义状态文件在桶内的存储路径
    }
    # 原有required_providers等配置保持不变
  }
  

• 第二步：迁移本地状态到远程存储
  1. 在本地工作目录执行terraform init，命令会检测到后端配置变更，提示是否将现有本地状态迁移到GCS后端，输入yes确认迁移。
  2. 迁移完成后本地执行terraform plan，确认输出无任何资源变更，证明状态迁移正确。
  3. 将.terraform目录、*.tfstate、*.tfstate.backup加入.gitignore文件，绝对不要把本地状态文件提交到GitHub仓库，再把更新后的main.tf和.gitignore提交推送到远程仓库。
• 第三步：校验GitHub Actions流水线配置
  1. 确认流水线中Setup Gcloud步骤使用的服务账号，同时拥有GCS状态桶的读写权限、待管理GCP资源的对应操作权限。
  2. 流水线中的terraform init步骤不需要额外添加特殊参数，配置正确的话会自动从GCS拉取同步完成的状态文件。

• 如果配置完成后CI环境仍然提示重建资源，先核对本地和CI环境使用的GCP项目ID、资源区域、资源名称/ID等参数是否完全一致，参数不匹配时Terraform会判定为不同资源。
• 可以直接登录GCP控制台查看对应存储桶内的状态文件，确认文件中已经记录了你之前导入的Project、Cloud Run服务的资源映射关系。
• 流水线执行terraform init时不要随意添加状态重置类参数，避免误覆盖远程存储的正确状态。

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