hkpanchani/docker-dind-awscli

Docker with AWS CLI v2.x 镜像文档

镜像概述

本镜像集成了Docker引擎和Amazon AWS CLI v2.x工具，专为Docker-in-Docker（DinD）场景设计。它允许用户在容器环境中直接运行Docker命令，同时通过AWS CLI与Amazon Web Services (AWS) 进行交互，适用于需要在隔离环境中管理容器和云资源的场景。

核心功能与特性

• 集成Docker引擎：包含完整的Docker运行时环境，支持容器构建、运行和管理
• AWS CLI v2.x：预安装Amazon AWS CLI v2.x，支持与AWS服务（如ECR、S3、EC2等）交互
• Docker-in-Docker支持：支持通过挂载Docker socket或DinD模式在容器内运行Docker
• 轻量级基础：基于官方Docker镜像构建，保持较小镜像体积
• 多平台兼容：支持常见架构（如amd64、arm64）

使用场景

• CI/CD流水线：在持续集成/部署流程中，在容器内构建Docker镜像并推送到AWS ECR
• 云资源管理：在隔离环境中执行AWS CLI命令，管理S3存储桶、EC2实例等资源
• 开发环境隔离：为开发人员提供包含Docker和AWS工具的统一环境
• 自动化脚本执行：运行需要同时操作Docker容器和AWS资源的自动化脚本

使用方法

基本使用（挂载Docker Socket）

通过挂载宿主机Docker socket，直接使用宿主机Docker引擎：

bash
docker run -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="us-east-1" \
  [镜像名称]

Docker-in-Docker模式（DinD）

独立运行Docker引擎（需特权模式）：

bash
docker run -it --privileged \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e AWS_REGION="us-east-1" \
  [镜像名称]

docker-compose配置示例

yaml
version: '3'
services:
  dind-aws:
    image: [镜像名称]
    privileged: true  # DinD模式需开启
    environment:
      - AWS_ACCESS_KEY_ID=your-access-key
      - AWS_SECRET_ACCESS_KEY=your-secret-key
      - AWS_REGION=us-east-1
    volumes:
      - ./workspace:/workspace  # 挂载工作目录
    command: /bin/bash

配置参数

环境变量

常用命令示例

1. 检查Docker版本：

   bash
   docker --version
   

2. 检查AWS CLI版本：

   bash
   aws --version
   

3. 登录AWS ECR并推送镜像：

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

注意事项

• DinD模式需使用--privileged标志，存在一定安全风险，建议仅在受控环境中使用
• 生产环境中推荐使用挂载Docker socket方式，减少安全暴露面
• AWS凭证应通过环境变量或挂载配置文件注入，避免硬编码在镜像中
• 长时间运行的容器需注意Docker存储驱动和资源限制配置