rommelporras/aws-cli

AWS CLI Docker容器

支持的标签、Dockerfile链接及AWS发布日期

• https://github.com/rommelporras/aws-cli/tree/master/1.18.129 - https://github.com/aws/aws-cli/releases/tag/1.18.129
• https://github.com/rommelporras/aws-cli/tree/master/1.18.4 - https://github.com/aws/aws-cli/releases/tag/1.18.4
• https://github.com/rommelporras/aws-cli/tree/master/1.17.5 - https://github.com/aws/aws-cli/releases/tag/1.17.5
• https://github.com/rommelporras/aws-cli/tree/master/1.16.313 - https://github.com/aws/aws-cli/releases/tag/1.16.313
• https://github.com/rommelporras/aws-cli/tree/master/1.16.305 - https://github.com/aws/aws-cli/releases/tag/1.16.305

运行/构建

bash
docker run --rm \
    --env AWS_ACCESS_KEY_ID=<<你的访问密钥>> \
    --env AWS_SECRET_ACCESS_KEY=<<你的秘密密钥>> \
    rommelporras/aws-cli \
    s3 ls

或

bash
docker build -t rommelporras/aws-cli:latest .

镜像概述

本镜像基于Alpine Linux构建，内置AWS CLI工具，镜像体积仅49MB，支持自动化构建并发布于Docker Hub。它允许用户无需本地安装AWS CLI即可执行各类AWS资源管理命令，适用于多环境隔离、版本统一等场景。

核心功能

1. 提供完整的AWS CLI工具集，支持EC2、S3、RDS等AWS服务的管理操作
2. 通过环境变量传递AWS认证信息，配置灵活
3. 支持别名设置，简化命令调用
4. 兼容Docker Compose，便于集成到多容器环境
5. 体积小巧，启动快速，资源占用低

使用场景

• 快速执行AWS CLI命令，无需本地安装依赖
• 团队统一使用相同版本的AWS CLI，避免版本差异导致的问题
• 隔离不同环境的AWS认证信息，提升安全性
• 在CI/CD流程中集成AWS资源操作

配置说明

环境变量配置

通过以下环境变量传递AWS认证信息：

• AWS_ACCESS_KEY_ID: AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY: AWS秘密访问密钥
• AWS_DEFAULT_REGION: 默认AWS区域

别名设置（简化命令）

bash
export AWS_ACCESS_KEY_ID="<你的AWS ID>"
export AWS_SECRET_ACCESS_KEY="<你的AWS密钥>"
export AWS_DEFAULT_REGION="eu-west-1"

alias aws='docker run --rm -t $(tty &>/dev/null && echo "-i") -e "AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}" -e "AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}" -e "AWS_DEFAULT_REGION=${AWS_DEFAULT_REGION}" -v "$(pwd):/project" rommelporras/aws-cli'

或直接硬编码密钥（不推荐用于生产环境）：

bash
alias aws='docker run --rm -t $(tty &>/dev/null && echo "-i") -e "AWS_ACCESS_KEY_ID=AKIA2XXXXXXXXX" -e "AWS_SECRET_ACCESS_KEY=q/z4m+jgXXXXXXXXXX" -e "AWS_DEFAULT_REGION=eu-west-1" -v "$(pwd):/project" rommelporras/aws-cli'

示例用法

描述EC2实例

bash
docker run --rm \
--env AWS_ACCESS_KEY_ID=<<你的访问密钥>> \
--env AWS_SECRET_ACCESS_KEY=<<你的秘密密钥>> \
--env AWS_DEFAULT_REGION=us-east-1 \
rommelporras/aws-cli \
ec2 describe-instances --instance-ids i-90949d7a

或使用别名：

bash
aws ec2 describe-instances --instance-ids i-90949d7a

列出S3桶内容

bash
docker run --rm \
--env AWS_ACCESS_KEY_ID=<<你的访问密钥>> \
--env AWS_SECRET_ACCESS_KEY=<<你的秘密密钥>> \
rommelporras/aws-cli \
s3 ls

上传当前目录文件到S3桶

bash
docker run --rm \
--env AWS_ACCESS_KEY_ID=<<你的访问密钥>> \
--env AWS_SECRET_ACCESS_KEY=<<你的秘密密钥>> \
-v $PWD:/data \
rommelporras/aws-cli \
s3 sync . s3://mybucketname

获取EC2 Windows实例的解密密码

bash
docker run --rm \
-v <<你的私钥路径>>:/tmp/key.pem \
--env AWS_ACCESS_KEY_ID=<<你的访问密钥>> \
--env AWS_SECRET_ACCESS_KEY=<<你的秘密密钥>> \
--env AWS_DEFAULT_REGION=us-east-1 \
rommelporras/aws-cli \
ec2 get-password-data --instance-id <<你的实例ID>> --priv-launch-key /tmp/key.pem

Docker Compose用法

1. 更新docker-compose.yml中的环境变量（认证信息）
2. 执行命令：

bash
docker-compose run aws s3 ls

相关文档链接

• 获取AWS密钥：AWS CLI入门指南
• 环境变量传递密钥：AWS CLI环境变量配置
• 命令行选项（如设置区域）：AWS CLI命令行参数
• AWS CLI完整命令列表：AWS CLI文档