使用Terraform更新AWS基础设施时遇ECS任务定义注销失败问题

问题场景 #

使用Terraform v1.8.3（AWS Provider v3.75.2）更新ECS服务任务定义的环境变量时，执行terraform apply报错：

module.<redacted>.aws_ecs_task_definition.ecs_task_def: Destroying... [id=<redacted>]
╷
│ Error: ClientException: The task definition could not be deregistered because it is in the process of being deleted.
│ 
│ 
╵

问题持续2天，手动通过AWS控制台注销任务定义无效，简化代码仅添加测试环境变量也无法解决。

可行解决方案 #

1. 强制绕过旧任务定义销毁，创建新任务定义 #

修改Terraform中aws_ecs_task_definition的name参数为新值（例如原名称my-ecs-task改为my-ecs-task-new），Terraform会直接创建新的任务定义，不再尝试销毁卡在删除状态的旧定义。之后更新ECS服务配置，将task_definition指向新创建的任务定义。

2. 清理Terraform状态并重新同步 #

• 先备份当前Terraform状态文件：cp terraform.tfstate terraform.tfstate.bak
• 从状态中移除报错的任务定义资源：

  terraform state rm module.<redacted>.aws_ecs_task_definition.ecs_task_def
  

• 若已通过控制台或CLI创建了可用的任务定义，将其导入Terraform状态：

  terraform import module.<redacted>.aws_ecs_task_definition.ecs_task_def <任务定义ARN>
  

• 重新执行terraform plan和terraform apply，确认状态与实际资源一致。

3. 升级AWS Provider版本 #

当前使用的AWS Provider v3.75.2存在较多旧版本bug，升级至v5.x版本可修复部分ECS任务定义的状态同步问题：

• 修改versions.tf中的Provider配置：

  provider "aws" {
    version = ">= 5.0.0"
    # 其他配置...
  }
  

• 执行升级命令：

  terraform init -upgrade
  

• 重新尝试terraform apply。

4. 检查ECS服务与任务定义的关联状态 #

确认ECS服务是否仍在引用旧任务定义版本：

aws ecs describe-services --cluster <你的ECS集群名称> --services <你的ECS服务名称>

查看返回结果中的taskDefinition字段，若指向旧版本，先手动更新服务至最新可用的任务定义版本：

aws ecs update-service --cluster <集群名称> --service <服务名称> --task-definition <新任务定义ARN>

完成后再尝试Terraform的更新操作。

5. 触发AWS后台状态刷新（若卡住时间过长） #

若任务定义长时间处于DELETE_IN_PROGRESS状态，可通过AWS CLI重新发起注销请求，触发后台状态同步：

aws ecs deregister-task-definition --task-definition <任务定义ARN>

若仍无效，需联系AWS Support提交工单，请求清理卡住的任务定义资源。

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