如何在远程后端运行terraform test并保存状态以便手动清理？

核心思路：配置远程状态后端 #

Terraform Test 支持对接远程状态后端，只要在测试相关的配置中指定远程存储，就能让测试创建的资源状态持久化保存，后续可通过terraform destroy手动清理残留资源。

具体实现步骤 #

1. 添加远程状态配置
   在你的测试模块（或根模块）的.tf配置文件中，添加远程状态后端的定义。以AWS S3为例，配置如下：

terraform {
  backend "s3" {
    bucket                  = "your-terraform-test-state-bucket"
    key                     = "test/${terraform.workspace}/state.tfstate"
    region                  = "us-east-1"
    versioning              = true
    server_side_encryption  = "AES256"
    # 可选：搭配DynamoDB实现状态锁定
    dynamodb_table          = "terraform-test-state-lock"
  }
}

如果使用其他云厂商的存储（如Azure Blob、GCS），只需替换对应的后端类型和参数即可。同时要确保CI/CD流水线环境拥有访问该远程存储的权限。

2. 使用独立工作区隔离测试状态
   为测试创建独立的Terraform工作区，避免与其他环境的状态混淆：

terraform workspace new test-ci-pipeline

运行测试前切换到该工作区，状态会单独存储在远程后端的对应路径下。

3. 执行Terraform Test
   正常运行terraform test命令，测试过程中创建的资源状态会自动同步到远程后端，即使测试中途被取消，状态也会保留在远程存储中。

4. 手动销毁测试资源
   需要清理时，切换到对应的工作区执行销毁命令：

terraform workspace select test-ci-pipeline
terraform destroy -auto-approve

额外优化建议 #

• 流水线自动清理兜底：在CI/CD流程中添加测试完成后的自动销毁步骤，但如果测试被强制中断，该步骤可能无法执行，远程状态仍是必要的兜底方案。
• 状态锁定机制：开启远程状态的锁定功能（如S3+DynamoDB），防止多个测试进程同时操作状态引发冲突。
• 状态密钥命名规范：为状态密钥添加流水线ID、测试批次号等标识，方便快速定位和清理特定批次的测试资源。

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