AWS CloudFormation关联新容量提供商至现有ECS集群失败问题

问题场景 #

已存在一个关联了EC2容量提供商的ECS集群，集群内已有运行中的服务。尝试通过CloudFormation创建新的Auto Scaling组、容量提供商，并将其关联到该现有集群时操作失败，错误提示：

my-test-cluster already exists in stack arn:aws:cloudformation:us-east-2:249717198246:stack/asdfasda/1e8230a0-b369-11ed-8adf-06ccee440287

注：新建集群并关联容量提供商可成功，但现有集群无法添加新的容量提供商；首次通过CloudFormation关联容量提供商到现有集群时能成功，再次尝试更新关联（添加新容量提供商）则失败。

核心原因 #

CloudFormation的AWS::ECS::ClusterCapacityProviderAssociations资源并非独立的云资源实体，它本质是对ECS集群的属性修改操作：

• 当ECS集群不是由当前CloudFormation栈创建时，栈没有权限管理该集群的容量提供商关联属性，重复操作时会触发资源冲突检测，提示集群已存在于其他栈（或手动创建的资源无法被当前栈接管）。
• 即使首次关联成功，后续更新时CloudFormation仍会试图以“创建新关联”的逻辑处理，而非“更新现有集群属性”，导致与已存在的集群资源冲突。

解决方案 #

方案1：直接使用AWS CLI更新集群关联 #

绕过CloudFormation的资源管理限制，直接通过CLI命令为现有集群添加新的容量提供商：

aws ecs put-cluster-capacity-providers \
  --cluster my-test-cluster \
  --capacity-providers FARGATE FARGATE_SPOT <新容量提供商名称> \
  --default-capacity-provider-strategy [] \
  --region us-east-1

该命令会直接更新ECS集群的容量提供商列表，无需依赖CloudFormation栈的资源管理逻辑。

方案2：将现有ECS集群导入CloudFormation栈 #

如果希望继续通过CloudFormation管理集群的容量提供商关联，可将现有集群导入目标栈：

1. 编写包含ECS集群资源定义的CloudFormation模板，确保集群名称与现有集群完全一致：

   {
     "AWSTemplateFormatVersion": "2010-09-09",
     "Resources": {
       "ECSCluster": {
         "Type": "AWS::ECS::Cluster",
         "Properties": {
           "ClusterName": "my-test-cluster"
         }
       }
     }
   }
   

2. 使用以下命令将现有集群导入栈：

   aws cloudformation import-stack \
     --stack-name <目标栈名称> \
     --template-body file://<模板文件路径> \
     --resources-to-import '[{\"ResourceType\":\"AWS::ECS::Cluster\",\"LogicalResourceId\":\"ECSCluster\",\"ResourceIdentifier\":{\"ClusterName\":\"my-test-cluster\"}}]' \
     --region us-east-1
   

3. 导入完成后，在栈中添加或更新ClusterCPAssociation资源，即可正常管理容量提供商的关联更新。

方案3：使用CloudFormation自定义资源实现关联 #

通过自定义资源（Custom Resource）在CloudFormation栈中调用API完成关联操作，避免直接管理集群资源：

1. 创建Lambda函数，函数逻辑调用put-cluster-capacity-providers API来更新集群的容量提供商列表。
2. 在CloudFormation模板中添加自定义资源，关联该Lambda函数，传入集群名称和目标容量提供商列表作为参数。
3. 当栈创建或更新时，自定义资源会触发Lambda函数执行关联操作，绕过CloudFormation对集群资源的冲突检测。

测试示例参考 #

用户提供的最简测试模板（用于创建ASG和容量提供商）：

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Description": "The template used to create an ECS Cluster for nocohub paid workspace",
    "Parameters": {       
        "LaunchTemplateId": {
            "Description": "AMI ID",
            "Type": "String",
            "Default": "lt-04cde001adead75f6"
          },
          "SubnetIds": {
            "Type": "CommaDelimitedList",
            "Description": "Optional - Specifies the Comma separated list of existing VPC Subnet Ids where ECS instances will run",
            "Default": "subnet-0f815721f89468e42"
          }
    },
    "Resources": {           
        "ASG": {
            "Type": "AWS::AutoScaling::AutoScalingGroup",
            "Properties": {
              "AutoScalingGroupName" : "my-test-cluster", 
              "MinSize": "1",
              "MaxSize": "4",
              "DesiredCapacity": "1",
              "LaunchTemplate": {
                "LaunchTemplateId": {
                    "Ref": "LaunchTemplateId"
                },                
                "Version": "1"
              },
              "VPCZoneIdentifier": {
                "Ref": "SubnetIds"
              }
            }
          },
          
      "EC2CapacityProvider": {        
        "Type": "AWS::ECS::CapacityProvider",
        "Properties": {
          "Name" : "my-test-capacity-provider",
          "AutoScalingGroupProvider": {
            "AutoScalingGroupArn": {
                "Ref" : "ASG"
            },
            "ManagedScaling": {
              "Status": "ENABLED",
              "TargetCapacity": 100
            },
            "ManagedTerminationProtection": "DISABLED"
          }
        }
      }
    }
  }

使用该模板创建ASG和容量提供商后，可通过方案1的CLI命令完成与现有集群的关联。

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