itobjects/docker-with-awscli

AWS CLI Docker镜像文档

镜像概述

本镜像基于轻量级基础镜像构建，预安装了AWS CLI工具，提供在容器环境中便捷执行AWS命令的能力。无需在本地系统安装AWS CLI及其依赖，通过容器化方式即可与AWS服务（如ECS、ECR、S3等）进行交互，特别适用于CI/CD流程、自动化脚本及临时AWS操作场景。

核心功能与特性

• 预安装AWS CLI：包含最新稳定版AWS CLI，支持完整的AWS服务命令集
• 轻量级设计：基于精简基础镜像，减少资源占用
• 灵活认证：支持通过环境变量、挂载配置文件等多种方式配置AWS认证信息
• 多平台支持：兼容常见的容器运行环境（Docker、Kubernetes等）
• 即开即用：无需额外配置即可执行AWS命令，简化操作流程

使用场景

• CI/CD流水线：在持续集成/部署流程中，用于推送Docker镜像到ECR、更新ECS服务配置等操作
• 本地开发环境：避免本地安装AWS CLI，通过容器临时执行AWS命令
• 自动化脚本：在批处理或定时任务中，执行AWS资源管理、数据备份等操作
• 多环境隔离：通过不同容器实例配置不同AWS账号或区域，实现环境隔离

使用方法

基本使用（通过环境变量认证）

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="us-west-2" \
  awscli-docker-image \
  aws ecs describe-services --cluster your-cluster --services your-service

通过挂载AWS配置文件认证

将本地AWS配置文件（通常位于~/.aws/）挂载到容器中：

bash
docker run --rm \
  -v ~/.aws:/root/.aws \
  awscli-docker-image \
  aws s3 ls

常用操作示例

1. 登录ECR并推送镜像

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="us-west-2" \
  -v /var/run/docker.sock:/var/run/docker.sock \
  awscli-docker-image \
  sh -c "aws ecr get-login-password | docker login --username AWS --password-stdin 123456789012.dkr.ecr.us-west-2.amazonaws.com && docker push 123456789012.dkr.ecr.us-west-2.amazonaws.com/your-image:latest"

2. 更新ECS服务

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="us-west-2" \
  awscli-docker-image \
  aws ecs update-service --cluster your-cluster --service your-service --force-new-deployment

环境变量配置

注意事项

• 确保AWS凭证（访问密钥/密钥）具有足够权限执行目标操作
• 敏感信息（如密钥）建议通过环境变量注入或安全挂载配置文件，避免硬编码
• 长时间运行的场景建议使用容器编排工具（如Docker Compose、Kubernetes）管理容器生命周期