amaysim/ecs-utils

ecs-utils镜像说明

镜像概述

ecs-utils是一套用于自动化部署和管理AWS ECS服务的脚本工具集，支持蓝绿部署、应用负载均衡器（ALB）路由规则管理及旧版本自动清理等功能，基于3 Musketeers模式设计，旨在简化ECS服务的部署与运维流程。

核心功能

• 完全自动化的ECS服务部署流程
• 蓝绿部署（通过ALB路由规则实现，无需DNS切换）
• 支持3 Musketeers（Make、Docker、docker-compose）协作模式
• 自动生成并上传ECS任务定义
• 基于CloudFormation管理部署版本
• 容器健康检查验证及版本流量切换
• 非活跃版本自动清理

使用场景

• CI/CD流水线中集成自动化部署AWS ECS服务
• 生产环境中安全执行蓝绿部署以降低业务中断风险
• 管理ECS服务多版本并实现快速回滚
• 批量清理旧的非活跃部署版本以优化资源占用

配置说明

前提条件

1. 安装Make、Docker和docker-compose工具
2. 拥有可用的AWS ECS集群及对应的应用负载均衡器（ALB）
3. 配置AWS访问凭证（通过环境变量或AWS配置文件）

主要操作

部署新版本

运行以下命令部署应用版本到ECS：

bash
make deploy

脚本执行步骤：

1. 查询ALB获取可用的路由规则优先级
2. 从环境变量或.env文件读取配置参数
3. 生成ECS任务定义并上传至AWS
4. 创建CloudFormation栈部署新版本
5. 验证容器健康状态并输出版本访问URL

切换生产流量

将新部署版本切换为接收生产流量：

bash
make cutover

该操作修改ALB默认路由规则指向新版本，切换过程原子且即时生效。

清理旧版本

自动清理非活跃的旧部署版本：

bash
make autocleanup

Docker部署示例

直接使用镜像运行部署命令（需挂载配置文件和设置AWS凭证）：

bash
docker run --rm \
  -v $(pwd)/deployment:/app/deployment \
  -v $(pwd)/.env:/app/.env \
  -e AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY \
  -e AWS_SECRET_ACCESS_KEY=YOUR_SECRET_KEY \
  amaysim/ecs-utils make deploy

Cookiecutter模板使用

通过cookiecutter生成自定义ECS项目：

bash
# 安装cookiecutter
pip install -U cookiecutter
# 生成ECS项目
cookiecutter https://github.com/amaysim-au/docker-ecs-utils