ECS集群已创建EC2实例但容器实例数显示为0的问题咨询

可能原因及对应解决步骤 #

1. IAM角色权限缺失 #

• 检查EC2实例关联的IAM角色是否包含AmazonEC2ContainerServiceforEC2Role托管策略：
  • 进入EC2控制台，找到目标实例，查看IAM角色信息
  • 如果角色不存在或未关联该策略，创建新角色（选择EC2信任实体），附加AmazonEC2ContainerServiceforEC2Role策略，再将角色关联到EC2实例
  • 注意：角色关联后需要重启EC2实例才能生效

2. ECS Agent配置错误 #

• 登录EC2实例（通过SSH或Session Manager），检查ECS配置文件：
  • 查看/etc/ecs/ecs.config文件，确认ECS_CLUSTER的值是否与你的集群名称完全一致（大小写敏感）
  • 如果配置错误，修改文件后重启ECS Agent服务：sudo systemctl restart ecs（Amazon Linux 2系统）

3. 网络连通性问题 #

• 检查安全组出站规则：确保允许HTTPS（443端口）访问ECS服务端点
  • 对于公有子网：直接允许访问0.0.0.0/0的443端口
  • 对于私有子网：需要配置NAT网关（允许实例访问公网），或者创建ECS VPC端点（在VPC控制台中创建com.amazonaws.<区域>.ecs-agent、com.amazonaws.<区域>.ecs-telemetry、com.amazonaws.<区域>.ecs端点）
• 在EC2实例上测试连通性：执行curl https://ecs.<你的区域>.amazonaws.com，如果返回403是正常的（说明能连通，只是权限问题），如果超时则说明网络不通

4. 用户数据配置错误 #

• 检查EC2实例的启动用户数据：
  • 进入EC2实例详情页，查看用户数据，确认是否包含正确的集群配置命令：

    #!/bin/bash
    echo ECS_CLUSTER=your-cluster-name >> /etc/ecs/ecs.config
    

  • 如果用户数据错误，需要重新启动实例并指定正确的用户数据，或者手动修改实例上的ecs.config文件后重启ECS Agent

5. ECS Agent运行异常 #

• 登录EC2实例，检查ECS Agent状态：
  • 执行sudo systemctl status ecs，确认服务是否处于active (running)状态
  • 如果服务未启动，执行sudo systemctl start ecs；如果启动失败，查看日志：sudo journalctl -u ecs，根据日志信息排查问题（比如依赖缺失、配置错误等）

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