openmrsinfra/cron-backup

openmrsinfra/cron-backup 镜像描述

镜像概述

openmrsinfra/cron-backup是OpenMRS基础设施团队提供的Docker镜像，用于为Docker容器环境提供定时备份能力，可实现目录压缩备份、自定义脚本执行及手动备份/恢复操作。

核心功能

1. 定时目录备份：通过环境变量指定需备份的目录及对应名称，按cron表达式定时生成带时间戳的压缩包。
2. 自定义脚本支持：允许运行自定义备份脚本，满足个性化备份逻辑需求。
3. 手动操作：可按需触发备份或从指定备份文件恢复数据。

使用场景

• MongoDB、Solr等服务的数据目录定期备份。
• 自定义业务数据目录的定时备份。
• 需要按特定逻辑执行的备份任务（如多步骤备份流程）。

配置说明

环境变量

• DIRS：备份目录与名称映射，格式为DIR1:NAME1,DIR2:NAME2,...（例：/mongo_data:mongo,/solr_data:solr）。
• SCHEDULE：cron表达式，定义备份执行时间（例：0 0 * * *表示每日凌晨）。
• SCRIPT：自定义备份脚本路径（例：/scripts/my_backup_script.sh），与DIRS二选一使用。

卷挂载

• 需备份的目录（如MongoDB数据卷mongo_data:/mongo_data）。
• 备份存储目录（如./backups:/backup）。
• 自定义脚本目录（如scripts:/scripts）。

部署示例

Docker Compose（目录备份）

yaml
backup:
  image: openmrsinfra/cron-backup:latest
  depends_on:
    - api
  volumes:
    - mongo_data:/mongo_data
    - solr_data:/solr_data
    - ${BACKUP_DIR-./backups}:/backup
  environment:
    - DIRS=/mongo_data:mongo,/solr_data:solr
    - SCHEDULE=0 0 * * *
  restart: always
  healthcheck:
    test: "exit 0"

手动备份

bash
docker-compose run --rm backup bash backup.sh

恢复备份

bash
docker-compose run --rm backup bash restore.sh 2017-09-27_00-00-01

Docker Compose（自定义脚本）

yaml
backup:
  image: openmrsinfra/cron-backup:latest
  volumes:
    - scripts:/scripts
  environment:
    - SCRIPT=/scripts/my_backup_script.sh
    - SCHEDULE=0 0 * * *
  restart: always
  healthcheck:
    test: "exit 0"