pdffiller/ecs-service-update

ECS服务更新镜像

镜像概述

该镜像用于创建“一次性”(one shot)Docker容器，专门用于更新AWS ECS(Elastic Container Service)服务。适用于自动化部署流程中，通过容器化方式执行ECS服务更新操作，无需在部署环境中预先安装AWS CLI或相关依赖。

核心功能与特性

• 一次性执行：容器启动后完成ECS服务更新操作即退出，适合短期任务场景
• AWS ECS集成：与AWS ECS API直接交互，支持更新服务的任务定义、容量、部署配置等
• 环境变量配置：通过环境变量传递AWS凭证及更新参数，无需修改镜像内部配置
• 轻量级设计：优化镜像体积，仅包含执行ECS更新所需的最小依赖

使用场景

• CI/CD管道集成：在持续集成/持续部署流程中，作为部署阶段的一部分自动更新ECS服务
• 手动触发更新：通过命令行手动启动容器，临时更新ECS服务配置
• 多环境管理：针对开发、测试、生产等不同环境，通过环境变量快速切换更新目标

使用方法与配置说明

前提条件

• 已配置AWS访问凭证（Access Key ID和Secret Access Key），且该凭证具有ECS服务更新权限（如ecs:UpdateService权限）
• Docker环境已安装并运行

环境变量参数

Docker Run示例

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="us-east-1" \
  -e ECS_CLUSTER="my-ecs-cluster" \
  -e ECS_SERVICE="my-ecs-service" \
  -e TASK_DEFINITION="my-task-definition:1" \
  -e FORCE_NEW_DEPLOYMENT="true" \
  pdffiller/ecs-service-update

注意事项

• 容器执行完成后会自动退出，可通过docker run --rm参数自动清理容器
• AWS凭证应通过环境变量安全传递，避免硬编码在命令中或镜像内
• 确保提供的AWS凭证具有足够权限，否则可能导致更新失败
• 详细参数及高级用法可参考项目GitHub文档：https://github.com/pdffiller/system-utils/tree/master/AWS_API/ecs-service-update