dinkel/backup

docker-backup

镜像概述

该Docker镜像基于https://github.com/dinkel/btr-backup%E8%84%9A%E6%9C%AC%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%A4%87%E4%BB%BD%E6%96%87%E4%BB%B6%E3%80%81%E6%95%B0%E6%8D%AE%E5%BA%93%E7%AD%89%E6%95%B0%E6%8D%AE%E8%87%B3%E6%9C%AC%E5%9C%B0Btrfs%E6%A0%BC%E5%BC%8F%E4%BB%8B%E8%B4%A8%E3%80%82%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%B8%80%E8%87%B4%E7%9A%84%E5%A4%87%E4%BB%BD%E7%8E%AF%E5%A2%83%EF%BC%8C%E6%89%A7%E8%A1%8C%E5%AE%8C%E5%A4%87%E4%BB%BD%E4%BB%BB%E5%8A%A1%E5%90%8E%E5%8D%B3%E9%80%80%E5%87%BA%EF%BC%8C%E6%9C%AA%E5%AE%89%E8%A3%85%60cron%60%E7%AD%89%E8%B0%83%E5%BA%A6%E5%B7%A5%E5%85%B7%EF%BC%8C%E9%9C%80%E7%94%B1%E4%B8%BB%E6%9C%BA%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F%E8%B4%9F%E8%B4%A3%E4%BB%BB%E5%8A%A1%E7%9A%84%E8%B0%83%E5%BA%A6%E4%B8%8E%E7%8A%B6%E6%80%81%E7%9B%91%E6%8E%A7%E3%80%82

核心功能

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%E6%96%87%E6%A1%A3%E3%80%82