zndevops/aws-docker

AWS CLI 与 Docker 集成工具镜像

镜像概述

本镜像基于轻量级基础镜像构建，集成了AWS CLI（Amazon Web Services Command Line Interface）和Docker客户端，提供一站式工具环境，支持在容器中同时执行AWS云资源管理命令和Docker容器操作，无需在宿主机单独安装配置，降低环境依赖复杂度。

核心功能与特性

• 集成AWS CLI：包含最新稳定版AWS CLI，支持完整的AWS服务命令（如S3、EC2、ECS等）。
• 内置Docker客户端：预装Docker命令行工具，可与宿主机或远程Docker守护进程通信。
• 轻量级基础：基于Alpine或Debian Slim等轻量级基础镜像，减小镜像体积，提升启动速度。
• 灵活配置：支持通过环境变量或挂载配置文件自定义AWS CLI和Docker客户端参数。
• 多平台支持：提供amd64、arm64等主流架构镜像，适配不同运行环境。

使用场景

• CI/CD流水线：在持续集成/部署流程中，执行AWS资源部署（如ECS服务更新、S3文件上传）和Docker镜像构建推送。
• 云资源管理：临时或批量执行AWS资源操作（如查看EC2实例、管理S3存储桶），避免在宿主机留存敏感凭证。
• 容器化应用部署：结合AWS ECS/EKS等服务，在容器中完成Docker镜像构建、推送至ECR及云容器服务部署。
• 开发环境统一：为团队提供标准化的AWS CLI和Docker工具版本，避免因本地工具版本差异导致的兼容性问题。

使用方法与配置说明

快速启动

通过docker run命令直接启动容器，示例如下：

bash
docker run -it --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载宿主机Docker套接字，使容器内Docker客户端可访问宿主机Docker守护进程
  -e AWS_ACCESS_KEY_ID="your-aws-access-key" \    # AWS访问密钥ID
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret-key" \# AWS密钥
  -e AWS_REGION="us-west-2" \                     # 默认AWS区域
  aws-cli-docker:latest

环境变量配置

Docker Compose配置示例

创建docker-compose.yml文件，定义服务配置：

yaml
version: '3'
services:
  aws-docker-tool:
    image: aws-cli-docker:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 共享宿主机Docker套接字
      - ./aws-config:/root/.aws                    # 挂载本地AWS配置文件（可选，替代环境变量）
    environment:
      - AWS_ACCESS_KEY_ID=your-aws-access-key
      - AWS_SECRET_ACCESS_KEY=your-aws-secret-key
      - AWS_REGION=us-west-2
    tty: true  # 保持终端交互

启动服务：

bash
docker-compose up -d
docker-compose exec aws-docker-tool sh  # 进入容器终端

基本操作示例

执行AWS CLI命令

在容器终端中运行AWS命令，例如列出S3存储桶：

bash
aws s3 ls

查看EC2实例：

bash
aws ec2 describe-instances --query 'Reservations[*].Instances[*].{ID:InstanceId,State:State.Name}'

执行Docker命令

查看宿主机Docker容器状态：

bash
docker ps

构建并推送Docker镜像至AWS ECR（需先登录ECR）：

bash
aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin 123456789012.dkr.ecr.us-west-2.amazonaws.com
docker build -t my-app:latest .
docker tag my-app:latest 123456789012.dkr.ecr.us-west-2.amazonaws.com/my-app:latest
docker push 123456789012.dkr.ecr.us-west-2.amazonaws.com/my-app:latest

注意事项

• Docker守护进程访问：容器内Docker客户端需通过挂载/var/run/docker.sock或配置DOCKER_HOST连接到Docker守护进程。
• AWS凭证安全：避免在镜像或代码中硬编码AWS凭证，优先使用环境变量或挂载配置文件（~/.aws/credentials）。
• 权限控制：挂载宿主机Docker套接字时，容器内用户将获得与宿主机Docker相同的权限，需注意安全风险。