ryanooi/aws-cli

AWS CLI Docker镜像

镜像概述

本镜像将AWS CLI工具容器化，基于Alpine系统构建，旨在解决CI/CD环境中无需直接安装AWS CLI即可执行相关操作的需求，简化环境配置流程。

核心功能

1. 提供完整的AWS CLI功能，支持S3文件上传、云服务管理等常见操作
2. 通过环境变量配置AWS认证信息（密钥、区域等）
3. 支持脚本或shell别名替代本地AWS CLI调用
4. 自动化构建与发布流程，确保版本更新及时

使用场景

• CI/CD流水线中执行AWS操作（如上传构建产物到S3存储桶）
• 临时使用AWS CLI但不想本地安装的场景
• 多环境下保持AWS CLI版本一致性的需求

配置说明

环境变量配置

需设置以下环境变量完成AWS认证：

• AWS_ACCESS_KEY_ID: AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY: AWS秘密访问密钥
• AWS_DEFAULT_REGION: 默认AWS区域（如cn-north-1）

使用示例

上传文件到S3

1. 配置环境变量：

bash
export AWS_ACCESS_KEY_ID="your-access-key"
export AWS_SECRET_ACCESS_KEY="your-secret-key"
export AWS_DEFAULT_REGION="cn-north-1"

2. 执行上传命令：

bash
docker run --rm -t -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 \
  ryanooi/aws-cli s3 cp ./local-file.txt s3://your-bucket/path/

设置Shell别名（替代本地AWS CLI）

添加别名到shell配置文件（如~/.bashrc）：

bash
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" ryanooi/aws-cli'

设置后可直接使用aws命令，如aws s3 ls。

维护说明

• 镜像通过Docker Hub自动构建，基于master分支提交和标签更新
• Dockerfile中需手动更新awscli和s3cmd版本

参考文档

• AWS CLI官方文档：[***]

许可证

本镜像基于Apache License 2.0授权，详情见镜像仓库LICENSE文件。