maorfr/s3-reload

S3对象更新触发重新加载镜像

概述

该Docker镜像包含一个轻量级二进制程序，用于监控指定S3存储桶中的特定对象。当对象发生更新（如内容修改、新增或替换）时，程序会自动执行预配置的重新加载命令，实现基于S3对象变更的自动化操作触发。

核心功能与特性

• S3对象监控：持续监测指定S3存储桶中的目标对象，跟踪其ETag或最后修改时间变化
• 自动触发机制：当检测到对象更新时，立即执行用户定义的重新加载命令
• 轻量级设计：采用精简二进制构建，镜像体积小，资源占用低
• 灵活配置：支持通过环境变量自定义S3连接参数、监控对象及触发命令

使用场景

• 动态配置文件管理：当S3中的配置文件更新时，自动触发应用服务重新加载配置
• 静态资源更新：监控S3中的静态资源（如HTML、CSS文件）变更，触发前端服务刷新
• 数据文件同步：检测数据文件更新后，触发数据处理服务重新加载数据

使用方法与配置说明

环境变量配置

Docker Run示例

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="YOUR_AWS_ACCESS_KEY" \
  -e AWS_SECRET_ACCESS_KEY="YOUR_AWS_SECRET_KEY" \
  -e AWS_REGION="us-east-1" \
  -e S3_BUCKET="my-config-bucket" \
  -e S3_OBJECT_KEY="app/config.json" \
  -e RELOAD_COMMAND="curl -X POST http://localhost:8080/reload" \
  -e CHECK_INTERVAL=60 \
  --name s3-reload-trigger \
  [镜像名称]

Docker Compose示例

yaml
version: '3'
services:
  s3-reload-trigger:
    image: [镜像名称]
    environment:
      - AWS_ACCESS_KEY_ID=YOUR_AWS_ACCESS_KEY
      - AWS_SECRET_ACCESS_KEY=YOUR_AWS_SECRET_KEY
      - AWS_REGION=us-east-1
      - S3_BUCKET=my-config-bucket
      - S3_OBJECT_KEY=app/config.json
      - RELOAD_COMMAND=curl -X POST http://app-service:8080/reload
      - CHECK_INTERVAL=60
    restart: unless-stopped

注意事项

• 确保配置的AWS密钥具有S3对象的读取权限（至少需要s3:GetObject权限）
• RELOAD_COMMAND需根据实际需求配置，确保容器内可执行（如依赖curl需确保镜像包含该工具）
• 检查间隔（CHECK_INTERVAL）建议根据更新频率调整，高频更新场景可缩短间隔