returnpath/awscli

docker-awscli

安装了AWS CLI工具的Docker容器，基于https://github.com/sourcegraph/docker-awscli，添加了sudo、acl、locales包并修复了UTF-8 locale。

默认入口点：/usr/local/bin/aws

镜像概述

本镜像提供AWS CLI工具的容器化环境，让用户无需本地安装即可执行AWS云服务管理命令。通过挂载本地AWS配置文件，可直接使用已有凭证和配置进行操作。

核心功能

1. 提供完整AWS CLI工具，支持所有AWS服务的命令行操作
2. 支持挂载本地~/.aws目录，复用本地凭证与配置
3. 允许指定配置文件（profile）切换多环境
4. 可进入交互式bash环境处理复杂操作
5. 修复UTF-8 locale问题，确保输出编码正确

使用场景

1. 无本地AWS CLI环境时临时执行AWS命令
2. 多环境切换管理AWS资源（通过不同profile）
3. 避免本地安装依赖带来的环境冲突
4. 快速验证AWS命令语法或测试配置正确性

配置说明

• 挂载配置：将本地~/.aws目录挂载到容器/root/.aws路径，使用本地凭证
• 指定profile：通过--profile参数选择配置文件
• 交互式模式：修改入口点为/bin/bash进入bash环境

使用示例

bash
# 列出所有EC2实例的ID、公网DNS和标签
docker run --rm -v ~/.aws:/root/.aws returnpath/awscli ec2 describe-instances --output=text --query='Reservations[*].Instances[*].{ID:InstanceId,PublicDNSName:PublicDnsName,Tags:Tags[?Key==`Name`].{Name:Value}}'

# 列出标签为Name=foo的EC2实例信息
docker run --rm -v ~/.aws:/root/.aws returnpath/awscli ec2 describe-instances --filters='Name=tag-name,Values=app,Name=tag-value,Values=foo' --output=text --query='Reservations[*].Instances[*].{ID:InstanceId,PublicDNSName:PublicDnsName,Tags:Tags[?Key==`Name`].{Name:Value}}'

# 使用devops-monkey配置文件，打印Name=foo的EC2公网DNS
docker run --rm -v ~/.aws:/root/.aws returnpath/awscli --profile=devops-monkey ec2 describe-instances --filters 'Name=tag:Name,Values=foo' --query='Reservations[*].Instances[*].{PublicDNSName:PublicDnsName}' --output=text

# 使用business-monkey配置文件列出S3存储桶
docker run --rm -v ~/.aws:/root/.aws returnpath/awscli --profile=business-monkey s3 ls

# 进入交互式容器
docker run -ti --rm -v ~/.aws:/root/.aws --entrypoint=/bin/bash returnpath/awscli

许可协议

本项目为awscli工具的打包脚本，上游工具awsclihttps://github.com/aws/aws-cli/blob/develop/LICENSE.txt采用Apache 2.0许可协议，本镜像遵循相同协议。