readpeak/docker-aws-docker

docker-aws-docker 镜像文档

概述

docker-aws-docker 是一个集成了 AWS 命令行工具（awscli）和 Docker 客户端的 Docker 镜像。该镜像旨在提供一个便捷的容器化环境，使用户能够在单一容器中同时执行 AWS 资源管理操作和 Docker 命令，简化跨平台和环境一致性问题。

核心功能与特性

• 工具集成：包含 awscli 和 Docker 客户端，无需单独安装配置
• 环境一致性：确保在不同环境中使用统一版本的 awscli 和 Docker 客户端
• 轻量级：基于精简基础镜像构建，减少资源占用
• 灵活性：支持通过环境变量和挂载卷自定义配置

使用场景

• CI/CD 管道：在持续集成/部署流程中执行 AWS 资源操作和 Docker 镜像构建推送
• 本地开发环境：快速搭建包含 AWS 和 Docker 工具链的开发环境
• 自动化脚本执行：运行需要同时操作 AWS 和 Docker 的自动化任务
• 临时操作环境：快速启动一个包含必要工具的临时容器，完成特定任务后销毁

使用方法

基本使用

通过以下命令启动容器：

bash
docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e AWS_ACCESS_KEY_ID=your_aws_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret_key \
  -e AWS_REGION=us-east-1 \
  docker.xuanyuan.run/docker-aws-docker

参数说明

环境变量

• AWS_ACCESS_KEY_ID：AWS 访问密钥 ID（必填，用于 awscli 认证）
• AWS_SECRET_ACCESS_KEY：AWS 密钥（必填，用于 awscli 认证）
• AWS_REGION：AWS 区域（可选，默认为 us-east-1）
• AWS_SESSION_TOKEN：AWS 会话令牌（可选，用于临时凭证）

挂载卷

• /var/run/docker.sock：挂载宿主机 Docker 套接字，使容器内 Docker 客户端能与宿主机 Docker 引擎通信（推荐）
• ~/.aws:/root/.aws：挂载本地 AWS 配置目录，持久化 awscli 配置（可选）
• ~/project:/workspace：挂载工作目录，方便操作本地文件（可选）

示例

1. 检查工具版本

bash
docker run --rm docker.xuanyuan.run/docker-aws-docker aws --version
docker run --rm docker.xuanyuan.run/docker-aws-docker docker --version

2. 执行 AWS S3 命令

bash
docker run --rm -it \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=secret \
  -e AWS_REGION=us-west-2 \
  docker.xuanyuan.run/docker-aws-docker \
  aws s3 ls

3. 构建并推送 Docker 镜像到 AWS ECR

bash
docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/my-project:/workspace \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=secret \
  -e AWS_REGION=us-east-1 \
  docker.xuanyuan.run/docker-aws-docker \
  sh -c "cd /workspace && \
         aws ecr get-login-password | docker login --username AWS --password-stdin 123456789012.dkr.ecr.us-east-1.amazonaws.com && \
         docker build -t my-app . && \
         docker tag my-app:latest 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app:latest && \
         docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app:latest"

注意事项

• 挂载 /var/run/docker.sock 会赋予容器操作宿主机 Docker 引擎的权限，请确保仅在可信环境中使用
• AWS 凭证应通过环境变量或挂载配置文件提供，避免硬编码在命令中
• 对于生产环境，建议使用 AWS IAM 角色（如果在 ECS/EKS 等 AWS 服务中运行）而非长期访问密钥