更新变量后Terraform Apply未更新ECS任务，如何强制更新？

问题根源分析 #

• force_new_deployment 参数配置错误：这个参数属于 aws_ecs_service 资源，而非容器定义（container_definitions）的属性，当前写在容器配置里完全无效。
• 环境变量语法错误：BUILD_NO的键写成了 "name:"（多了冒号），导致Terraform解析时忽略该变量，更新BUILD_NO后无法检测到配置变化。
• 使用:latest镜像标签：Terraform仅对比镜像字符串，不会检查镜像实际内容，即便ECR里的latest镜像更新，Terraform仍会判定配置无变化。

具体解决办法 #

1. 修正环境变量语法错误 #

将BUILD_NO的键从 "name:" 改为 "name"，同时统一使用HCL规范的等号语法，确保环境变量被正确识别：

resource "aws_ecs_task_definition" "pq-backend-task" {
  family = "pq-backend-task"
  container_definitions = jsonencode([
    {
      name                 = "pq-backend-container"
      image                = "${data.terraform_remote_state.infra.outputs.pq_backend_ecr_url}:latest"
      cpu                  = 2
      memory               = 4096
      essential            = true
      portMappings = [
        {
          containerPort = 80
          hostPort      = 0
        }
      ]
      environment = [
        {
          "name" : "DB_PASSWORD",
          "value" : var.DB_PASSWORD
        },
        {
          "name" : "BUILD_NO",
          "value" : var.BUILD_NO
        },
      ]
    }
  ])
}

2. 正确配置强制部署参数 #

把force_new_deployment移到aws_ecs_service资源中，需要强制更新服务时设置为true：

resource "aws_ecs_service" "pq-backend-service" {
  name            = "pq-backend-service"
  cluster         = aws_ecs_cluster.pq-cluster.id
  task_definition = aws_ecs_task_definition.pq-backend-task.arn
  desired_count   = 1

  # 触发强制部署时设为true，部署完成后可改回false，后续Terraform会自动检测任务定义变化
  force_new_deployment = true
}

3. 替换:latest标签（推荐） #

使用镜像的SHA摘要或版本号替代:latest，让Terraform能准确检测镜像更新：

# 通过data源获取ECR镜像的最新摘要
data "aws_ecr_image" "pq-backend-latest" {
  repository_name = data.terraform_remote_state.infra.outputs.pq_backend_ecr_repo_name
  image_tag       = "latest"
}

# 在任务定义中使用镜像摘要
resource "aws_ecs_task_definition" "pq-backend-task" {
  family = "pq-backend-task"
  container_definitions = jsonencode([
    {
      # ...其他配置
      image = "${data.terraform_remote_state.infra.outputs.pq_backend_ecr_url}@${data.aws_ecr_image.pq-backend-latest.image_digest}"
      # ...其他配置
    }
  ])
}

4. 手动触发任务定义更新（临时方案） #

若需立即强制更新，可通过修改任务定义的family或添加关联BUILD_NO的临时标签触发重建：

resource "aws_ecs_task_definition" "pq-backend-task" {
  family = "pq-backend-task"
  # 添加关联BUILD_NO的标签，每次BUILD_NO更新都会触发任务定义重建
  tags = {
    BuildNumber = var.BUILD_NO
  }
  # ...其他配置
}

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