blick882/virta

virtabulder-backup 镜像文档

1. 镜像概述

virtabulder-backup是一款专为virtabulder环境设计的备份工具Docker镜像，旨在提供简单、可靠的数据备份与恢复解决方案。通过容器化部署，该镜像可无缝集成至virtabulder工作流，实现数据自动化备份、多版本管理及安全存储，有效保障virtabulder环境中的配置数据、项目文件及运行状态的完整性。

2. 核心功能与特性

• 自动化备份：支持定时任务（基于cron）自动执行备份操作，减少人工干预
• 多版本管理：保留备份历史版本，支持按时间点恢复
• 数据压缩：内置压缩算法，减少备份文件存储空间占用
• 加密保护：可选备份数据加密功能，保障敏感信息安全
• 跨环境兼容：适配主流virtabulder版本及Docker环境
• 轻量级设计：基于Alpine基础镜像，镜像体积小，资源占用低

3. 使用场景

• 开发环境：定期备份virtabulder开发项目配置及中间状态，防止开发过程中数据丢失
• 测试环境：为virtabulder测试实例提供快照式备份，支持快速回滚至测试起点
• 生产环境：保障virtabulder生产数据的高可用性，支持故障时快速恢复
• 迁移场景：通过备份文件实现virtabulder环境在不同服务器间的迁移

4. 使用方法

4.1 基本使用（手动备份）

通过docker run命令执行单次手动备份：

bash
docker run --rm \
  -v /path/to/virtabulder/data:/virtabulder/data \  # 挂载virtabulder数据目录
  -v /path/to/backup/storage:/backup \             # 挂载备份存储目录
  -e BACKUP_NAME="virtabulder-backup-$(date +%Y%m%d)" \  # 备份文件名（含时间戳）
  virtabulder-backup:latest backup

4.2 定时自动备份

配置cron定时任务实现自动化备份：

bash
docker run -d \
  --name virtabulder-backup \
  -v /path/to/virtabulder/data:/virtabulder/data \
  -v /path/to/backup/storage:/backup \
  -e CRON_SCHEDULE="0 3 * * *" \  # 每日凌晨3点执行备份（cron表达式）
  -e BACKUP_RETENTION=7 \         # 保留最近7个备份版本
  -e ENCRYPT_ENABLE=true \        # 启用备份加密
  -e ENCRYPT_PASSWORD="your-strong-password" \  # 加密密码（建议使用环境变量注入）
  virtabulder-backup:latest

4.3 数据恢复

从备份文件恢复virtabulder数据：

bash
docker run --rm \
  -v /path/to/virtabulder/data:/virtabulder/data \
  -v /path/to/backup/storage:/backup \
  -e RESTORE_FILE="/backup/virtabulder-backup-20240520.tar.gz" \  # 指定恢复文件路径
  -e ENCRYPT_ENABLE=true \
  -e ENCRYPT_PASSWORD="your-strong-password" \
  virtabulder-backup:latest restore

4.4 环境变量配置

5. 注意事项

• 首次使用前需确保挂载的virtabulder数据目录及备份存储目录具有读写权限
• 生产环境建议启用ENCRYPT_ENABLE并使用强密码，避免敏感数据泄露
• 定时备份任务依赖容器内cron服务，需确保容器持续运行（建议配置重启策略：--restart=always）
• 备份文件建议定期验证完整性，可通过执行docker exec virtabulder-backup verify命令进行校验