trivadis/awscli-s3cmd

docker-awscli-s3cmd

镜像概述

docker-awscli-s3cmd是一个集成了AWS CLI（Amazon Web Services Command Line Interface）和S3cmd工具的Docker镜像。该镜像提供容器化环境，使用户无需在本地系统安装工具即可执行与AWS S3服务相关的操作，如文件上传、下载及存储桶管理等。

核心功能与特性

• 工具集成：包含AWS CLI和S3cmd两种S3操作工具，满足不同操作习惯需求
• 容器化运行：无需本地配置依赖，避免环境冲突，直接通过容器执行操作
• 轻量级设计：基于精简基础镜像构建，体积小巧，启动快速
• 灵活配置：支持通过环境变量或挂载配置文件设置AWS凭证，适应多场景使用

使用场景与适用范围

• 自动化脚本：在Shell脚本或自动化任务中调用工具执行S3操作
• CI/CD流程：集成到持续集成/部署流水线，实现构建产物的S3上传下载
• 临时操作环境：需临时操作S3但不想本地安装工具的场景
• 多账号隔离：通过不同容器实例配置不同AWS账号凭证，实现多账号操作隔离

使用方法与配置说明

前提条件

• 已安装Docker引擎
• 拥有具备S3操作权限的AWS账号访问凭证（Access Key ID和Secret Access Key）

基本使用方式

通过环境变量配置AWS凭证

bash
docker run --rm -e AWS_ACCESS_KEY_ID=your_access_key -e AWS_SECRET_ACCESS_KEY=your_secret_key docker-awscli-s3cmd aws s3 ls

通过挂载本地AWS配置文件

本地已配置AWS CLI时（~/.aws/目录包含credentials和config文件）：

bash
docker run --rm -v ~/.aws:/root/.aws docker-awscli-s3cmd aws s3 ls

使用S3cmd工具

bash
# 需挂载S3cmd配置文件（通常位于~/.s3cfg）
docker run --rm -v ~/.s3cfg:/root/.s3cfg docker-awscli-s3cmd s3cmd ls

常用命令示例

AWS CLI示例

• 列出所有S3存储桶：

  bash
  docker run --rm -v ~/.aws:/root/.aws docker-awscli-s3cmd aws s3 ls
  

• 上传本地文件到S3：

  bash
  docker run --rm -v ~/.aws:/root/.aws -v $(pwd):/data docker-awscli-s3cmd aws s3 cp /data/localfile.txt s3://your-bucket/path/
  

• 下载S3文件到本地：

  bash
  docker run --rm -v ~/.aws:/root/.aws -v $(pwd):/data docker-awscli-s3cmd aws s3 cp s3://your-bucket/path/remotefile.txt /data/
  

S3cmd示例

• 列出存储桶内容：

  bash
  docker run --rm -v ~/.s3cfg:/root/.s3cfg docker-awscli-s3cmd s3cmd ls s3://your-bucket/
  

• 同步本地目录到S3：

  bash
  docker run --rm -v ~/.s3cfg:/root/.s3cfg -v $(pwd):/data docker-awscli-s3cmd s3cmd sync /data/ s3://your-bucket/path/
  

配置说明

• AWS CLI配置：支持通过环境变量（AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION等）或挂载~/.aws/credentials和~/.aws/config文件配置
• S3cmd配置：需挂载s3cfg配置文件（通常位于~/.s3cfg）或在容器内执行s3cmd --configure生成配置文件