kaorimatz/s3-sync

s3-sync

镜像概述

该镜像提供本地目录与Amazon S3前缀之间的同步功能，支持定时同步任务，并可在同步完成后自动构建并推送容器镜像至指定registry，适用于数据备份、同步及镜像自动化构建场景。

核心功能

• 本地目录与S3前缀双向同步
• 定时同步（通过schedule参数设置频率）
• 一次性同步模式（oneshot参数）
• 同步后构建并推送容器镜像至目标registry

使用场景

1. 定期将本地数据备份至Amazon S3
2. 从S3同步数据到本地环境用于开发或分析
3. 数据同步完成后自动构建推送容器镜像至仓库

配置说明

命令参数

• --image-tag: 指定同步后需构建推送的容器镜像标签（格式：registry.example.com/repository:tag）
• --oneshot: 执行一次同步后退出，不启动定时任务
• --stop-timeout: 停止操作的超时时间（默认10秒）
• --sync: 同步配置项，格式为schedule=@every Xm,bucket=桶名,prefix=前缀,dst=本地目录（多个任务可重复指定）

Docker部署示例

定时同步任务

bash
docker run -v /host/local/path:/data kaorimatz/s3-sync \
  --sync "schedule=@every 5m,bucket=my-s3-bucket,prefix=my-data,dst=/data"

一次性同步

bash
docker run -v /host/local/path:/data kaorimatz/s3-sync \
  --oneshot \
  --sync "bucket=my-s3-bucket,prefix=my-data,dst=/data"

同步后推送镜像

bash
docker run -v /host/local/path:/data kaorimatz/s3-sync \
  --image-tag my-registry.com/my-image:latest \
  --sync "schedule=@every 10m,bucket=my-s3-bucket,prefix=my-data,dst=/data"

开发说明

构建二进制文件

bash
go build

构建Docker镜像

bash
docker build .