edumobi/s3-sync

edumobi/s3-sync镜像说明

镜像概述

edumobi/s3-sync是一款适用于Kubernetes环境的sidecar镜像，核心功能是将S3存储服务中的指定目录同步至Pod内部本地目录，助力容器化应用高效获取与管理云存储资源。

核心功能

• 支持S3目录与Pod本地目录的单向同步
• 可作为sidecar与主应用容器协同运行
• 通过环境变量配置同步间隔、S3认证信息等参数

使用场景

• Kubernetes集群中主应用需从S3获取静态配置或资源文件的场景
• 容器化应用定期同步S3数据到本地处理/备份的需求
• 微服务架构下多服务共享S3存储资源的同步场景

配置说明

需设置以下环境变量：

• AWS_ACCESS_KEY_ID: S3访问密钥ID
• AWS_SECRET_ACCESS_KEY: S3秘密访问密钥
• S3_BUCKET: 目标S3桶名称
• S3_PATH: S3桶内待同步目录路径
• LOCAL_PATH: Pod内部本地同步目录路径
• SYNC_INTERVAL: 同步间隔（单位：秒，默认300秒）

部署示例

Docker Run命令

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e S3_BUCKET="my-bucket" \
  -e S3_PATH="/data" \
  -e LOCAL_PATH="/local/data" \
  -e SYNC_INTERVAL="60" \
  -v /host/local-data:/local/data \
  edumobi/s3-sync

Docker Compose示例

yaml
version: '3'
services:
  s3-sync-sidecar:
    image: edumobi/s3-sync
    environment:
      AWS_ACCESS_KEY_ID: "your-access-key"
      AWS_SECRET_ACCESS_KEY: "your-secret-key"
      S3_BUCKET: "my-bucket"
      S3_PATH: "/app-resources"
      LOCAL_PATH: "/local/resources"
      SYNC_INTERVAL: "120"
    volumes:
      - ./local-resources:/local/resources