garland/docker-s3cmd

garland/docker-s3cmd镜像说明

镜像概述

garland/docker-s3cmd是将s3cmd工具封装到Docker容器中的镜像，基于轻量级Alpine Linux构建，镜像体积仅31MB。它允许用户在Docker环境中便捷实现本地与Amazon S3之间的文件同步，或通过交互式方式使用s3cmd进行S3资源管理。

核心功能

1. 本地文件/文件夹与S3存储桶的双向同步（上传至S3、从S3下载）
2. 支持交互式模式执行各类s3cmd操作
3. 若环境配置IAM角色，可省略AWS密钥直接访问S3
4. 轻量级镜像，启动速度快，资源占用低

使用场景

• Docker环境下需要管理Amazon S3资源的开发者
• 批量同步本地文件到S3或从S3下载文件的运维人员
• 无需在主机直接安装s3cmd即可快速使用的场景

配置说明

可选配置项

若运行环境已通过IAM角色授予S3访问权限，可省略以下环境变量：

• AWS_KEY: AWS访问密钥
• AWS_SECRET: AWS秘密密钥

部署示例

1. 本地文件同步至S3

bash
AWS_KEY=<你的AWS密钥>
AWS_SECRET=<你的AWS秘密密钥>
BUCKET=s3://garland.public.bucket/database2/
LOCAL_FILE=/tmp/database

docker run \
--env aws_key=${AWS_KEY} \
--env aws_secret=${AWS_SECRET} \
--env cmd=sync-local-to-s3 \
--env DEST_S3=${BUCKET}  \
-v ${LOCAL_FILE}:/opt/src \
garland/docker-s3cmd

• 替换LOCAL_FILE为需上传至S3的文件/文件夹路径

2. S3文件同步至本地

bash
AWS_KEY=<你的AWS密钥>
AWS_SECRET=<你的AWS秘密密钥>
BUCKET=s3://garland.public.bucket/database
LOCAL_FILE=/tmp

docker run \
--env aws_key=${AWS_KEY} \
--env aws_secret=${AWS_SECRET} \
--env cmd=sync-s3-to-local \
--env SRC_S3=${BUCKET} \
-v ${LOCAL_FILE}:/opt/dest \
garland/docker-s3cmd

• 替换LOCAL_FILE为保存S3文件的本地路径

3. 交互式使用s3cmd

bash
AWS_KEY=<你的AWS密钥>
AWS_SECRET=<你的AWS秘密密钥>

docker run -it \
--env aws_key=${AWS_KEY} \
--env aws_secret=${AWS_SECRET} \
--env cmd=interactive \
-v /:/opt/dest \
garland/docker-s3cmd /bin/sh

进入容器后初始化配置：

bash
/opt/main.sh

执行s3cmd命令（例如列出S3资源）：

bash
s3cmd ls /