silintl/sync-with-s3

docker-sync-with-s3

Docker镜像，通过环境变量配置运行单个cron任务，实现容器与AWS S3之间的文件同步。

该镜像可用于将文件从容器同步到S3，或从S3同步到容器。建议每个镜像实例对应一个同步任务；若需同步多个目录，应运行多个容器并分别配置。

Docker Hub地址

该镜像在Docker Hub自动构建，地址为：https://hub.docker.com/r/silintl/sync-with-s3/

本地运行步骤

1. 克隆本仓库
2. 将local.env.dist复制为local.env并更新相应配置值
3. 执行docker-compose up -d启动服务

所需环境变量

1. ACCESS_KEY - AWS访问密钥（必填）
2. SECRET_KEY - AWS秘密访问密钥（必填）
3. CRON_SCHEDULE - cron任务调度规则（例如每15分钟：*/15 * * * *，必填）
4. SOURCE_PATH - 待同步的源路径（例如：/var/www/uploads，必填）
5. DESTINATION_PATH - 同步目标路径（例如：s3://my-bucket/site-uploads，必填）
6. BUCKET_LOCATION - AWS存储桶所在区域（例如：us-east-1，必填）
7. LOGENTRIES_KEY（可选）- 若提供，将命令输出发送至syslog（优先级user.info）
8. S3SYNC_ARGS（可选）- 传递给aws s3 sync的参数（例如--delete表示删除目标中源不存在的文件）

卷配置

需在Docker配置中定义卷，实现应用容器与同步容器之间的文件系统共享。

部署示例

Docker Run命令

bash
docker run -d \
  --env ACCESS_KEY=your_aws_access_key \
  --env SECRET_KEY=your_aws_secret_key \
  --env CRON_SCHEDULE="*/15 * * * *" \
  --env SOURCE_PATH="/var/www/uploads" \
  --env DESTINATION_PATH="s3://my-bucket/site-uploads" \
  --env BUCKET_LOCATION="us-east-1" \
  --volume /host/path/to/uploads:/var/www/uploads \
  docker.xuanyuan.run/silintl/sync-with-s3

Docker Compose示例

yaml
version: '3'
services:
  s3-sync:
    image: silintl/sync-with-s3
    environment:
      ACCESS_KEY: your_aws_access_key
      SECRET_KEY: your_aws_secret_key
      CRON_SCHEDULE: "*/15 * * * *"
      SOURCE_PATH: "/var/www/uploads"
      DESTINATION_PATH: "s3://my-bucket/site-uploads"
      BUCKET_LOCATION: "us-east-1"
      S3SYNC_ARGS: "--delete"
    volumes:
      - ./uploads:/var/www/uploads