richarvey/awscli

AWS Toolkit Docker镜像

镜像概述

AWS Toolkit是AWS CLI的Docker化版本，无需直接安装到系统即可运行AWS命令行工具。通过映射本地AWS凭证，可轻松在命令行中使用aws命令。镜像每日自动构建，确保Linux基础镜像和AWS CLI版本持续更新，基于Alpine Linux构建，体积远小于Amazon官方镜像，同时支持x86_64和arm64架构。

自版本2.2.10起，镜像体积大幅优化至97.6MB（后续版本因功能增强略有增加，最新版本约143MB），解决了musl libc和OpenSSL兼容性问题，提供更轻量、高效的使用体验。

核心功能与特性

• 轻量级设计：相比Amazon官方镜像（约387MB），本镜像体积显著减小（最新版本约143MB），节省存储空间和网络传输成本
• 自动更新：每日自动构建，确保基础镜像和AWS CLI版本保持最新，提升安全性
• 多架构支持：同时提供x86_64和arm64架构支持，适配不同硬件环境
• 版本对齐：镜像标签与AWS CLI版本一致，可按需拉取特定版本（如2.2.6）
• 凭证集成：支持映射本地AWS凭证文件（~/.aws），无需重新配置

与官方镜像对比

使用场景

• 开发环境中快速使用AWS CLI，无需在系统中安装
• CI/CD流水线中集成AWS CLI操作，保持环境一致性
• 资源受限环境（如边缘设备）需要轻量级AWS工具
• 需要同时使用多个AWS CLI版本的场景
• 多架构部署环境（x86_64/arm64）的统一工具链

使用方法

下载镜像

bash
docker pull richarvey/awscli:latest

如需特定版本，可指定标签（与AWS CLI版本对应）：

bash
docker pull richarvey/awscli:2.2.6  # 拉取AWS CLI 2.2.6版本

所有标签可查看https://hub.docker.com/r/richarvey/awscli/tags/

运行模式

正常模式

映射当前工作目录（用于文件操作）和AWS凭证目录，限制容器对系统的访问范围：

bash
docker run -it -v `pwd`:/cfg -v ~/.aws:/home/awsuser/.aws richarvey/awscli:latest ${COMMAND}

• -v \pwd`:/cfg：映射当前工作目录到容器内/cfg`，便于操作本地文件（如CloudFormation模板）
• -v ~/.aws:/home/awsuser/.aws：映射本地AWS凭证目录，容器可直接使用本地配置的凭证

示例：查看S3存储桶列表

bash
docker run -it -v `pwd`:/cfg -v ~/.aws:/home/awsuser/.aws richarvey/awscli:latest s3 ls

开放模式

映射整个用户主目录，允许容器访问更多文件（谨慎使用）：

bash
docker run -it -v ~/:/home/awsuser richarvey/awscli:latest ${COMMAND}

切换AWS配置文件

通过环境变量AWS_PROFILE指定使用的AWS配置文件，无需在命令中添加--profile参数：

bash
docker run -it -e AWS_PROFILE=SomeProfile -v `pwd`:/cfg -v ~/.aws:/home/awsuser/.aws richarvey/awscli:latest ${COMMAND}

添加到.bash_profile简化使用

通过设置别名，可像本地安装AWS CLI一样直接使用aws命令：

基本配置（默认账户）

编辑.bash_profile：

bash
vi ~/.bash_profile

添加以下内容：

bash
aws() {
  docker run -it -v `pwd`:/cfg -v ~/.aws:/home/awsuser/.aws --rm richarvey/awscli:latest "$@";
}

使配置生效：

bash
source ~/.bash_profile

现在可直接使用aws命令：

bash
aws s3 ls  # 列出S3存储桶

多配置文件配置

为不同AWS账户设置独立别名：

bash
vi ~/.bash_profile

添加以下内容：

bash
# 默认账户
aws() {
  docker run -it -v `pwd`:/cfg -v ~/.aws:/home/awsuser/.aws --rm richarvey/awscli:latest "$@";
}

# 特定配置文件账户（对应~/.aws/config中的SomeProfile）
aws_profile_name() {
  docker run -it -e AWS_PROFILE=SomeProfile -v `pwd`:/cfg -v ~/.aws:/home/awsuser/.aws --rm richarvey/awscli:latest "$@";
}

使用示例：

bash
aws s3 ls  # 使用默认配置
aws_profile_name ec2 describe-instances  # 使用SomeProfile配置查询EC2实例

构建自己的镜像

如需自定义构建，可使用以下命令：

bash
git clone https://github.com/richarvey/aws-docker-toolkit.git
cd aws-docker-toolkit
docker build -t my-awscli .