dinkel/backup

docker-backup

镜像概述

该Docker镜像基于https://github.com/dinkel/btr-backup脚本构建，用于备份文件、数据库等数据至本地Btrfs格式介质。镜像提供一致的备份环境，执行完备份任务后即退出，未安装`cron`等调度工具，需由主机操作系统负责任务的调度与状态监控。

核心功能

1. 文件备份：通过挂载数据卷或数据容器，备份指定目录的文件。
2. 数据库备份：通过链接数据库容器，生成数据库完整dump。
3. Btrfs快照管理：自动清理旧快照（保留最新12个、12个最近“每日”、12个最近“每月”快照及所有“每年”快照）。

使用场景

适用于Docker容器化应用的备份场景，例如包含Web容器、数据库容器及数据卷的复杂应用，需对其文件和数据库进行定期备份以保障数据安全。

配置说明

1. 挂载Btrfs备份介质

将本地Btrfs格式的备份介质挂载到容器的/backup目录，需使用--privileged权限以允许删除快照：

bash
docker run -d --privileged --volume /media/backup:/backup [...] dinkel/backup

2. 连接数据卷或容器

通过--volumes-from连接数据容器，或--volume挂载命名卷：

bash
docker run -d [...] --volumes-from application-config --volumes-from application-data --volume named_volume:/path/inside/container [...] dinkel/backup

3. 链接数据库容器

使用--link连接数据库容器，指定内部hostname：

bash
docker run -d [...] --link application-db:db [...] dinkel/backup

4. 设置项目名称

通过环境变量BACKUP_PROJECT指定备份项目名称：

bash
docker run -d [...] --env BACKUP_PROJECT="application-name" [...] dinkel/backup

5. 设置备份文件路径

通过BACKUP_FILES_PATHS指定容器内需备份的绝对目录（用冒号分隔）：

bash
docker run -d [...] --env BACKUP_FILES_PATHS=/var/www/config:/var/www/data [...] dinkel/backup

6. 设置数据库信息

以PostgreSQL为例，通过环境变量指定数据库连接信息：

bash
docker run -d [...] --env BACKUP_POSTGRESQL_HOST=db --env BACKUP_POSTGRESQL_USER=admin --env BACKUP_POSTGRESQL_PASSWORD=mysecretpassword [...] dinkel/backup

完整示例

bash
docker run -d --privileged --volume /media/backup:/backup --volumes-from application-config --volumes-from application-data --link application-db:db --env BACKUP_PROJECT="application-name" --env BACKUP_FILES_PATHS=/var/www/config:/var/www/data --env BACKUP_POSTGRESQL_HOST=db --env BACKUP_POSTGRESQL_USER=admin --env BACKUP_POSTGRESQL_PASSWORD=mysecretpassword docker.xuanyuan.run/dinkel/backup

环境变量

详细环境变量说明请参考https://github.com/dinkel/btr-backup文档。