AWS CLI 2 Docker镜像文档

镜像概述

AWS CLI 2是Amazon Web Services (AWS)的命令行界面工具，允许用户通过终端或命令提示符与AWS资源交互，支持管理EC2实例、S3存储桶、Lambda函数等多种AWS服务。本Docker镜像由Oowy团队维护，基于轻量级Alpine Linux构建，将AWS CLI 2封装为容器化工具，便于在各类环境中快速部署和使用。

维护者

Oowy团队

获取帮助

• Docker社区Slack
• Server Fault
• Unix & Linux
• Stack Overflow

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 多架构支持：兼容amd64和arm64v8架构
• 版本丰富：提供多个版本标签，适配不同AWS CLI 2版本需求
• 即开即用：内置AWS CLI 2二进制文件，可直接执行aws命令
• 灵活配置：支持挂载外部配置文件或通过环境变量注入凭证

支持的标签

基于Alpine Linux 3.19

• latest
• 2.22.24 2.22.23 2.22.22 2.22.21 2.22.20 2.22.19 2.22.18 2.22.17 2.22.16 2.22.15 2.22.14 2.22.13 2.22.12 2.22.11 2.22.10 2.22.9 2.22.8 2.22.7 2.22.6 2.22.5 2.22.4 2.22.3 2.22.2 2.22.1 2.22.0
• 2.21.3 2.21.2 2.21.1 2.21.0
• 2.20.0
• 2.19.5 2.19.4 2.19.3 2.19.2 2.19.1 2.19.0
• 2.18.18 2.18.17 2.18.16 2.18.15 2.18.14 2.18.13 2.18.12 2.18.11 2.18.10 2.18.9 2.18.8 2.18.7 2.18.6 2.18.5 2.18.4 2.18.3 2.18.2 2.18.1 2.18.0
• 2.17.65 2.17.64 2.17.63 2.17.62 2.17.61 2.17.60 2.17.59 2.17.58 2.17.57 2.17.56 2.17.55 2.17.54 2.17.53 2.17.52 2.17.51 2.17.50 2.17.49 2.17.48 2.17.47 2.17.46 2.17.45 2.17.44 2.17.43 2.17.42 2.17.41 2.17.40 2.17.39 2.17.38 2.17.37 2.17.36 2.17.35 2.17.34 2.17.33 2.17.32 2.17.31 2.17.30 2.17.29 2.17.28 2.17.27 2.17.26 2.17.25 2.17.24 2.17.23 2.17.22 2.17.21 2.17.20

基于Alpine Linux 3.18

• 2.17.19 2.17.18 2.17.17 2.17.16 2.17.15 2.17.14 2.17.13 2.17.12 2.17.11 2.17.10 2.17.9 2.17.8 2.17.7 2.17.6 2.17.5 2.17.4 2.17.3 2.17.2 2.17.1 2.17.0
• 2.16.12 2.16.11 2.16.10 2.16.9 2.16.8 2.16.7 2.16.6 2.16.5 2.16.4 2.16.3 2.16.2 2.16.1 2.16.0
• 2.15.62 2.15.61 2.15.60 2.15.59 2.15.58 2.15.57 2.15.56 2.15.55 2.15.54 2.15.53 2.15.52 2.15.51 2.15.50 2.15.49 2.15.48 2.15.47 2.15.46 2.15.45 2.15.44 2.15.43 2.15.42 2.15.41 2.15.40 2.15.39 2.15.38 2.15.37 2.15.36 2.15.35 2.15.34 2.15.33 2.15.32 2.15.31 2.15.30 2.15.29 2.15.28 2.15.27 2.15.26 2.15.25 2.15.24 2.15.23 2.15.22 2.15.21 2.15.20 2.15.19 2.15.18 2.15.17 2.15.16 2.15.15 2.15.14 2.15.13 2.15.12 2.15.11 2.15.10 2.15.9 2.15.8 2.15.7 2.15.6 2.15.5 2.15.4 2.15.3 2.15.2 2.15.1 2.15.0
• 2.14.6 2.14.5 2.14.4 2.14.3 2.14.2 2.14.1 2.14.0
• 2.13.39
• 2.12.7
• 2.11.27
• 2.10.4
• 2.9.23

使用场景

• 容器化AWS管理：在容器环境中快速执行AWS资源操作命令
• CI/CD集成：在持续集成/部署流程中嵌入AWS CLI命令，自动化资源配置
• 临时环境工具：无需本地安装AWS CLI，通过容器临时执行AWS操作
• 多版本隔离：通过不同标签使用特定版本的AWS CLI，避免版本冲突
• 基础镜像定制：作为基础镜像构建包含AWS CLI的自定义工具镜像

使用方法与配置

基本使用

查看AWS CLI版本：

docker run oowy/awscli2:latest --version

执行AWS命令（需先配置凭证）：

docker run oowy/awscli2:latest s3 ls

配置AWS凭证

方法1：挂载本地配置文件

本地AWS配置文件通常位于~/.aws目录（包含credentials和config文件），可挂载到容器的/root/.aws目录：

docker run -v ~/.aws:/root/.aws oowy/awscli2:latest s3 ls

方法2：通过环境变量注入

设置AWS访问密钥环境变量：

docker run -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE -e AWS_SECRET_ACCESS_KEY=your-secret-key oowy/awscli2:latest ec2 describe-instances

方法3：构建自定义镜像（预设配置）

创建Dockerfile：

FROM oowy/awscli2:latest
COPY aws_config /root/.aws/config
COPY aws_credentials /root/.aws/credentials

构建并使用：

docker build -t my-awscli2 .
docker run my-awscli2:latest s3 ls

设置工作目录

指定容器工作目录，便于操作相对路径文件：

docker run -v $(pwd):/workdir -w /workdir oowy/awscli2:latest s3 cp localfile.txt s3://my-bucket/

社区支持

关于AWS CLI二进制文件的问题，请在AWS CLI主仓库提交issue。

如需反馈Docker镜像相关问题，可通过上述获取帮助渠道联系社区支持。