partos/ecs_toolbox

AWS ECS CI/CD辅助Docker镜像

镜像概述

本Docker镜像专为AWS ECS（Amazon Elastic Container Service）服务设计，旨在简化容器化应用的CI/CD（持续集成/持续部署）流程。镜像集成了与AWS ECS交互所需的核心工具和环境配置，帮助开发团队统一部署环境，自动化完成应用的构建、容器镜像推送、ECS任务定义更新及服务部署等关键步骤，提升AWS ECS服务的管理效率。

核心功能和特性

• AWS ECS集成工具链：内置AWS CLI、ECS CLI及相关依赖，支持与AWS ECS服务直接交互
• 任务定义管理：提供任务定义创建、更新、验证工具，支持JSON/YAML格式配置文件
• 服务部署自动化：支持ECS服务创建、更新、回滚操作，集成部署状态检查
• 轻量级基础：基于Alpine或Debian Slim基础镜像，减小镜像体积，缩短拉取时间
• 灵活配置：支持通过环境变量或挂载配置文件自定义AWS认证信息、ECS集群参数等
• 多平台支持：兼容amd64和arm64架构，适配不同AWS ECS运行环境

使用场景和适用范围

适用场景

• 开发团队通过CI/CD管道（如Jenkins、GitHub Actions、GitLab CI等）自动化部署容器化应用到AWS ECS集群
• 需要统一CI/CD工具环境，避免因本地环境差异导致的部署问题
• 频繁更新ECS服务（如每日多次部署），需简化任务定义管理和服务更新流程
• 希望集成AWS ECS与其他AWS服务（如ECR、CloudWatch Logs）的部署流程

适用范围

• AWS ECS Fargate或EC2启动类型的集群
• 基于Docker的容器化应用
• 需要通过命令行工具自动化ECS操作的场景

使用方法和配置说明

前提条件

• 已安装Docker环境
• 拥有AWS账号及具备ECS操作权限的IAM凭证（需包含ecs:UpdateService、ecs:DescribeServices、ecs:RegisterTaskDefinition等权限）
• 目标AWS ECS集群已创建并正常运行

镜像拉取

bash
docker pull [镜像仓库地址]/aws-ecs-cicd-helper:latest

基本使用示例

1. 执行ECS服务部署（通过环境变量传入AWS凭证）

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID=your_aws_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret_key \
  -e AWS_REGION=us-west-2 \
  -e ECS_CLUSTER=my-ecs-cluster \
  -e ECS_SERVICE=my-ecs-service \
  -e TASK_DEFINITION_FILE=/task-definition.json \
  -v $(pwd)/task-definition.json:/task-definition.json \
  [镜像仓库地址]/aws-ecs-cicd-helper:latest \
  deploy-ecs-service

2. 使用docker-compose集成到CI/CD管道

yaml
version: '3'
services:
  ecs-deploy:
    image: [镜像仓库地址]/aws-ecs-cicd-helper:latest
    environment:
      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
      - AWS_REGION=${AWS_REGION}
      - ECS_CLUSTER=${ECS_CLUSTER}
      - ECS_SERVICE=${ECS_SERVICE}
      - TASK_DEFINITION_FILE=/app/task-definition.json
    volumes:
      - ./task-definition.json:/app/task-definition.json
    command: deploy-ecs-service

环境变量配置说明

常用命令

注意事项

• AWS凭证建议通过CI/CD管道的安全存储（如GitHub Secrets、Jenkins Credentials）传入，避免硬编码
• 任务定义文件需符合AWS ECS任务定义规范，包含必要字段（如family、networkMode、containerDefinitions等）
• 部署前建议通过validate-task-def命令验证任务定义文件合法性，避免部署失败
• 对于生产环境，建议指定具体镜像标签（而非latest），确保部署版本可追溯