Terraform创建AWS ECS集群时报错等待集群可用：找不到资源

问题原因 #

• AWS Provider版本与Terraform核心版本兼容性问题：你使用的Terraform v1.0.0是2021年发布的老旧版本，配套的低版本AWS Provider存在ECS集群状态检测的已知bug，创建集群后调用ecs:DescribeClusters接口查询状态的逻辑异常，即使集群创建成功也会返回找不到资源的错误。
• IAM权限缺失：Terraform使用的身份仅配置了ecs:CreateCluster权限，但缺少ecs:DescribeClusters权限，无法完成创建后的状态校验。
• 区域/账号配置不匹配：Terraform Provider配置的区域、账号和集群实际创建的资源所属的区域、账号不一致，导致状态查询时找不到对应资源。
• 网络延迟/接口超时：Terraform运行环境访问AWS ECS API的网络延迟较高，默认的等待超时时间不足以覆盖集群状态同步的周期。
• 配置类型错误：你当前代码中weight参数传入的是字符串类型"100"，不符合参数要求的数字类型，部分版本的Provider会因为类型校验异常导致状态检测逻辑失败。

解决方法 #

• 升级Terraform和AWS Provider版本 #

  先将Terraform核心版本升级到最新稳定版，同时将AWS Provider升级到5.0以上的稳定版本，示例配置如下：

  terraform {
    required_providers {
      aws = {
        source  = "hashicorp/aws"
        version = "~> 5.0"
      }
    }
  }
  

  配置完成后执行terraform init -upgrade更新Provider版本。

• 补全IAM权限 #

  给Terraform使用的身份添加ecs:DescribeClusters权限，示例IAM策略片段如下：

  {
    "Effect": "Allow",
    "Action": [
      "ecs:CreateCluster",
      "ecs:DescribeClusters",
      "ecs:DeleteCluster"
    ],
    "Resource": "*"
  }
  

• 校验区域和账号配置 #

  确认Provider块中配置的region参数、账号身份和你在AWS控制台查看集群的区域、账号完全一致，排除环境变量AWS_REGION、AWS_PROFILE覆盖Provider配置的情况。

• 调整参数类型和超时时间 #

  修改weight参数为数字类型，同时增加资源创建的超时时间，适配网络延迟场景，修改后的ECS集群配置如下：

  resource "aws_ecs_cluster" "cluster" {
    name               = "api-cluster"
    capacity_providers = ["FARGATE"]
  
    default_capacity_provider_strategy {
      capacity_provider = "FARGATE"
      weight            = 100
    }
  
    timeouts {
      create = "5m"
      update = "5m"
    }
  }
  

• 手动导入已有资源 #

  如果集群已经实际创建成功，可直接将资源导入Terraform状态文件，避免重复创建，执行命令如下：

  terraform import aws_ecs_cluster.cluster arn:aws:ecs:<你的区域>:<你的账号ID>:cluster/api-cluster
  

  把命令中的<你的区域>、<你的账号ID>替换为实际值即可。

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