jetbrainsinfra/s3-pit-restore

S3时间点恢复工具

镜像概述

这是s3-pit-restore工具的Docker镜像，用于Amazon S3的时间点恢复。当S3桶启用版本控制时，该工具可快速将部分或全部文件恢复到指定时间点，支持恢复到本地文件系统、同一S3桶或不同S3桶，解决了S3 Web界面批量恢复操作繁琐的问题。

核心功能

• 支持将S3桶内容恢复到本地文件系统或其他S3桶
• 可指定前缀（子文件夹）进行精准恢复
• 通过多并行worker提升恢复速度
• 支持指定时间范围（起始和结束时间）恢复
• 支持从Glacier存储类恢复内容
• 提供干运行模式（仅查询不传输文件）
• 支持详细日志输出和调试模式

使用场景

• 误操作删除或修改S3文件后的快速恢复
• 将S3桶数据回滚到历史版本状态
• 批量迁移指定时间点的S3内容到本地或其他桶
• 验证S3版本控制数据的历史状态

配置说明

主要命令行参数：

• -b/--bucket: 源S3桶名称
• -d/--dest: 本地目标路径（恢复到本地时使用）
• -B/--dest-bucket: 目标S3桶名称（恢复到S3时使用）
• -p/--prefix: 源S3桶中的前缀（子文件夹）
• -t/--timestamp: 恢复的目标时间点（格式如"06-17-2016 23:59:50 +2"）
• -f/--from-timestamp: 恢复的起始时间点
• --max-workers: 并行恢复的最大worker数量
• --dry-run: 干运行模式（不实际传输文件）

Docker部署示例

bash
# 创建本地恢复目录
mkdir restore

# 运行Docker镜像进行恢复（替换占位符为实际值）
docker run -ti --rm --name=s3-pit-restore \
  -v ${PWD}/restore:/tmp \
  -e AWS_ACCESS_KEY_ID=[你的AWS访问密钥ID] \
  -e AWS_SECRET_ACCESS_KEY=[你的AWS秘密访问密钥] \
  jetbrainsinfra/s3-pit-restore:latest \
  s3-pit-restore -b [源S3桶名称] -p [源前缀（可选）] -d /tmp -t "目标时间点"

注意：使用前需确保已配置正确的AWS凭证，且拥有源桶的读取权限和目标位置的写入权限。