创建ECS集群时关联已有VPC的Terraform实现方法

AWS控制台创建ECS集群时让你选VPC，本质是帮你自动配置后续任务/容器实例的网络关联——ECS集群本身并不直接绑定VPC，VPC的关联是通过ECS服务、任务定义或者容量提供者来实现的。以下分两种常见场景说明：

场景1：使用Fargate启动类型 #

Fargate任务的网络配置直接在ECS服务或任务定义中指定，无需修改集群本身的配置。在你的现有集群代码基础上，添加ECS服务时通过network_configuration关联已有VPC的子网和安全组：

# 你的原有ECS集群配置
resource "aws_ecs_cluster" "gtm" {
  name = "gtm"
  setting {
    name  = "containerInsights"
    value = "enabled"
  }
}

# 假设已有VPC，用数据源获取
data "aws_vpc" "existing" {
  tags = {
    Name = "your-existing-vpc-name"
  }
}

# 获取已有VPC下的子网
data "aws_subnets" "existing" {
  filter {
    name   = "vpc-id"
    values = [data.aws_vpc.existing.id]
  }
}

# 获取已有安全组
data "aws_security_group" "ecs_task" {
  name = "your-existing-ecs-sg"
}

# 创建ECS服务时关联VPC资源
resource "aws_ecs_service" "gtm_service" {
  name            = "gtm-service"
  cluster         = aws_ecs_cluster.gtm.id
  task_definition = aws_ecs_task_definition.gtm.arn # 需提前定义任务定义
  desired_count   = 1
  launch_type     = "FARGATE"

  network_configuration {
    subnets          = data.aws_subnets.existing.ids
    security_groups  = [data.aws_security_group.ecs_task.id]
    assign_public_ip = true # 根据需求调整
  }
}

场景2：使用EC2容量提供者（托管EC2实例） #

如果你的ECS集群需要使用EC2实例作为计算资源，需要通过容量提供者关联到部署在目标VPC中的Auto Scaling组：

# 你的原有ECS集群配置
resource "aws_ecs_cluster" "gtm" {
  name = "gtm"
  setting {
    name  = "containerInsights"
    value = "enabled"
  }

  # 附加容量提供者到集群
  capacity_providers = [aws_ecs_capacity_provider.gtm.name]
}

# 获取已有VPC和子网
data "aws_vpc" "existing" {
  tags = {
    Name = "your-existing-vpc-name"
  }
}

data "aws_subnets" "existing" {
  filter {
    name   = "vpc-id"
    values = [data.aws_vpc.existing.id]
  }
}

# 创建Auto Scaling组（部署在已有VPC的子网中）
resource "aws_autoscaling_group" "ecs_asg" {
  name_prefix          = "ecs-gtm-asg-"
  min_size             = 1
  max_size             = 3
  desired_capacity     = 1
  vpc_zone_identifier  = data.aws_subnets.existing.ids
  # 需提前配置ECS实例的启动模板/配置
  launch_template {
    id      = aws_launch_template.ecs_instance.id
    version = "$Latest"
  }
}

# 创建ECS容量提供者，关联Auto Scaling组
resource "aws_ecs_capacity_provider" "gtm" {
  name = "gtm-capacity-provider"

  auto_scaling_group_provider {
    auto_scaling_group_arn = aws_autoscaling_group.ecs_asg.arn

    managed_scaling {
      status = "ENABLED"
      target_capacity = 100
    }

    managed_termination_protection = "ENABLED"
  }
}

关键说明 #

• 控制台的“选择VPC”操作是简化流程，帮你自动创建了子网、安全组、ASG等关联资源；用Terraform时需要手动明确这些关联关系。
• ECS集群本身只是一个逻辑分组，真正的网络隔离由任务/实例所在的VPC子网实现。

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