keytelematics/docker-awscli

docker-awscli 镜像文档

概述

docker-awscli是一个集成了docker-in-docker（DinD）功能和AWS CLI工具的Docker镜像。该镜像允许在容器内部运行Docker命令，同时通过预装的AWS CLI与Amazon Web Services（AWS）进行交互，适用于需要在隔离环境中执行Docker操作并管理AWS资源的场景。

项目地址：https://hub.docker.com/r/keytelematics/docker-awscli/

核心功能与特性

1. Docker-in-Docker（DinD）支持
   内置Docker引擎，可在容器内部直接执行docker build、docker run、docker push等Docker命令，无需依赖宿主机Docker环境。

2. AWS CLI集成
   预装AWS命令行工具（AWS CLI），支持与AWS服务（如ECR、S3、ECS等）交互，可直接执行AWS资源管理命令（如镜像推送至ECR、文件同步至S3等）。

使用场景

• CI/CD流水线：在持续集成/部署流程中，于容器内构建应用镜像并推送到AWS ECR（Amazon Elastic Container Registry）。
• 开发环境隔离：为开发人员提供包含Docker和AWS工具链的统一环境，避免本地环境配置差异导致的问题。
• 自动化运维任务：执行需要Docker容器化部署并与AWS交互的自动化脚本（如批量更新ECS服务、管理Lambda函数等）。

使用方法

1. 拉取镜像

从Docker Hub拉取最新版本镜像：

bash
docker pull keytelematics/docker-awscli

2. 运行容器

由于Docker-in-Docker需要访问宿主机内核资源，运行时需添加--privileged标志以获取必要权限：

基础运行（仅使用Docker功能）

bash
docker run --privileged -it keytelematics/docker-awscli

集成AWS CLI（传递凭证）

通过环境变量注入AWS凭证（推荐用于临时场景）：

bash
docker run --privileged -it \
  -e AWS_ACCESS_KEY_ID="your_aws_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_aws_secret_key" \
  -e AWS_REGION="us-east-1" \
  keytelematics/docker-awscli

通过挂载本地AWS配置文件（推荐用于持久化场景）：

bash
docker run --privileged -it \
  -v ~/.aws:/root/.aws \  # 挂载本地AWS配置目录（包含credentials和config文件）
  keytelematics/docker-awscli

示例：在容器内构建并推送镜像至AWS ECR

bash
# 1. 登录AWS ECR（需提前配置AWS凭证）
aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 123456789012.dkr.ecr.us-east-1.amazonaws.com

# 2. 在容器内构建应用镜像
docker build -t my-app:latest /path/to/app/source

# 3. 标记镜像并推送至ECR
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

3. 本地构建镜像

如需基于源码构建镜像，克隆仓库后执行：

bash
docker build -t keytelematics/docker-awscli .

注意事项

• 安全提示：--privileged标志会赋予容器较高权限，生产环境中需谨慎使用，建议仅在可信环境（如隔离的CI/CD节点）中运行。
• 性能考量：Docker-in-Docker会增加容器资源开销，大规模场景建议评估宿主机资源或考虑使用Docker socket挂载（-v /var/run/docker.sock:/var/run/docker.sock）替代DinD。