Terraform单体项目拆分咨询：无需销毁云资源拆分多项目

核心思路 #

通过Terraform状态文件迁移+资源代码拆分的方式，将原有单体项目拆分为独立组件项目，全程保留已部署的云资源，同时实现组件化流水线自动化。

1. 先明确拆分边界 #

• 按组件类型拆分：比如将Lambda函数、EventBridge规则、API Gateway分别拆为独立项目；或按业务域拆分（如用户服务相关资源一个项目，订单服务相关一个）
• 梳理资源依赖：标记跨组件的依赖关系（比如API Gateway集成Lambda），后续通过数据资源在新项目中引用外部资源，避免硬编码资源ID

2. 备份原状态文件 #

操作前必须备份状态，防止失误：

# 拉取本地/远程状态到本地文件
terraform state pull > original_backup.tfstate

如果使用远程状态（如S3），确保开启版本控制，同时手动备份一份到本地。

3. 拆分状态与代码（核心步骤） #

方式一：用terraform state mv迁移资源（推荐） #

以拆分Lambda组件到新项目lambda-service为例：

1. 创建新项目目录lambda-service，执行terraform init配置与原项目一致的后端（如S3）
2. 在原项目目录执行迁移命令：

   # 迁移单个Lambda资源
   terraform state mv aws_lambda_function.user_auth ../lambda-service/terraform.tfstate
   # 批量迁移所有Lambda资源
   terraform state mv 'aws_lambda_function.*' ../lambda-service/terraform.tfstate
   

3. 将原项目中对应Lambda的.tf代码文件复制到lambda-service目录，删除原项目中的这些代码
4. 在lambda-service目录执行terraform plan，确认输出为No changes. Your infrastructure matches the configuration.，说明状态与代码匹配

方式二：手动拆分状态文件（复杂场景适用） #

1. 打开备份的original_backup.tfstate，找到要拆分的资源块，复制到新项目的terraform.tfstate中
2. 删除原状态文件中已迁移的资源条目
3. 分别在原项目和新项目执行terraform state push <对应状态文件>更新远程状态
4. 同步复制对应.tf代码到新项目，删除原项目中的对应代码

4. 处理跨项目依赖 #

比如API Gateway项目需要引用Lambda项目的函数，在API Gateway项目中使用数据资源读取：

data "aws_lambda_function" "user_auth" {
  function_name = "user-auth-function" # 对应Lambda的名称
}

resource "aws_api_gateway_integration" "lambda_integration" {
  rest_api_id = aws_api_gateway_rest_api.user_service.id
  resource_id = aws_api_gateway_resource.auth_resource.id
  http_method = "POST"
  # 使用数据资源获取的Lambda ARN
  uri = "arn:aws:apigateway:${var.region}:lambda:path/2015-03-31/functions/${data.aws_lambda_function.user_auth.arn}/invocations"
  integration_http_method = "POST"
}

执行terraform plan验证依赖是否能正确读取。

5. 验证拆分结果 #

• 在原项目执行terraform plan，确认没有资源被标记为销毁（若有，检查是否漏迁移资源或状态）
• 在每个新项目执行terraform plan，确认无变更
• 测试现有业务流程，确保Lambda、EventBridge、API Gateway的联动正常

6. 配置组件化流水线 #

• 每个独立项目配置单独的CI/CD流水线（如GitHub Actions、GitLab CI）
• 流水线核心步骤：拉取代码 → terraform init → terraform plan → 人工审核 → terraform apply
• 启用状态锁定（如S3+DynamoDB锁），防止多流水线同时操作同一项目状态

内容的提问来源于stack exchange，提问作者Mikel David Carozzi Sanchez