openmrs/cron-backup

openmrs/cron-backup 镜像文档

概述

openmrs/cron-backup 是一个用于从Docker卷生成备份的辅助工具，目前已迁移至 openmrsinfra/cron-backup 镜像，原镜像仅供内部使用。该工具可根据配置的定时任务，将指定目录打包为tar.gz格式的备份文件，并支持按需备份与恢复操作。

核心功能与特性

• 定时备份：通过 SCHEDULE 环境变量定义备份周期，自动执行备份
• 目录自定义：通过 DIRS 环境变量指定需备份的目录及备份名称
• 按需操作：支持手动触发备份和恢复操作
• 脚本支持：可通过 SCRIPT 环境变量指定自定义备份脚本

使用场景

适用于需要对Docker卷数据进行定时备份的场景，如数据库数据卷、应用数据卷等关键数据的定期备份需求。

使用方法与配置说明

环境变量

Docker Compose 配置示例

基本配置（指定目录备份）

yaml
backup:
  image: openmrs/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"

脚本调用配置

yaml
backup:
  image: openmrs/cron-backup:latest
  volumes:
    - scripts:/scripts  # 包含自定义脚本的卷
  environment:
    - SCRIPT=/scripts/my_backup_script.sh  # 自定义备份脚本路径
    - SCHEDULE=0 0 * * *  # 每天午夜执行备份
  restart: always
  healthcheck:
    test: "exit 0"

按需备份与恢复

手动执行备份

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

恢复备份

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

注：2017-09-27_00-00-01 为备份文件的时间戳部分，需替换为实际备份文件名中的时间戳。