tribalnova/aws-ecs-autoscaling

tribalnova/aws-ecs-autoscaling Docker镜像

https://hub.docker.com/r/tribalnova/aws-ecs-autoscaling/

该镜像为AWS ECS集群提供自动扩缩容机制，旨在确保集群始终有足够资源运行容器，同时降低成本并避免手动操作。它需定期在ECS集群的每个EC2实例上运行（建议每5分钟或更频繁），提供可用于配置自动扩缩组规则的CloudWatch指标，并通过实例终止保护防止缩容时停止运行中的任务。

核心功能

运行时，该镜像向CloudWatch发送以下EC2实例相关指标：

• Custom/ECS - MaxContainerSize：ECS集群所有容器定义中最大的硬/软内存限制
• Custom/ECS - RunningTaskCount：实例上运行的容器数量
• Custom/ECS - MemoryAvailable：可用于运行容器的可用内存
• Custom/ECS - ContainerSlots：基于可用内存，实例可运行的最大容器（以MaxContainerSize为单位）数量
• Custom/ECS - EmptyInstance：0表示有容器运行，1表示无容器运行

此外，若实例上有容器运行（EmptyInstance=0），镜像会保护该实例不被自动扩缩组终止；无容器时则移除保护。

使用场景

适用于需要自动调整AWS ECS集群资源的场景，如：

• 业务流量波动时自动扩缩容，保证服务可用性
• 优化资源成本，避免闲置EC2实例浪费
• 防止缩容操作导致运行中任务中断

配置说明

前提条件

1. 需为EC2实例配置AWS权限，允许写入CloudWatch指标及修改EC2终止保护状态
2. CloudWatch告警中配置的最小ContainerSlots需至少为1
3. 自动扩缩组启动配置中的EC2实例内存需大于MaxContainerSize
4. ECS集群新增服务时，需使用binpack分配规则，避免容器分散在所有实例上（防止EC2实例无法被终止）

部署示例

Docker Run命令

bash
docker run tribalnova/aws-ecs-autoscaling

定时任务配置（CRON）

建议每5分钟运行一次，可通过以下命令添加CRON任务：

bash
echo "*/5 * * * * docker run tribalnova/aws-ecs-autoscaling" | crontab -

可将该命令添加到EC2实例的User Data中。

注意事项

• 容器可能因首次下载或更新而无法立即运行，需考虑缓存问题
• 建议监控CloudWatch指标并调整告警阈值，避免EC2实例数量频繁波动
• 推荐创建CloudWatch仪表盘，包含以下图表：
  • 折线图：RunningTasksCount（总和，左Y轴）、ContainerSlots（总和，左Y轴）、EmptyInstance（总和，右Y轴）、GroupInServiceInstances（最大值，右Y轴）
  • 数值图：MaxContainerSize（最大值）