webcenter/rancher-backup

rancher-backup镜像说明

镜像概述

本镜像旨在解决Rancher平台的备份需求，通过Rancher API自动发现需要备份的服务，执行数据库转储操作，并使用Duplicity工具将数据备份到远程后端。支持多种数据库类型，同时允许用户扩展以支持更多服务。

核心功能

1. 自动服务发现：通过backup.type标签或镜像名称正则匹配识别需备份的服务
2. 多数据库支持：兼容MySQL、MariaDB、PostgreSQL、MongoDB、Elasticsearch等标准数据库
3. 分布式数据库备份：支持Cassandra等分布式NoSQL数据库，需配合共享存储使用
4. 灵活配置：通过环境变量设置备份策略、Duplicity参数及Rancher API连接信息
5. 可扩展性：允许用户通过添加配置文件扩展支持的服务类型

使用场景

1. Rancher环境下的常规服务备份（数据库、应用数据）
2. 分布式NoSQL数据库的跨节点备份
3. Rancher平台自身数据库的定期备份
4. 需要将数据备份到远程存储（FTP、S3等）的场景

配置说明

基础配置

• CONFD_PREFIX_KEY：Confd使用的前缀键，默认/backup
• BACKUP_CRON_schedule：备份执行时间，默认每天0点（0 0 0 * * *）
• BACKUP_DUPLICITY_source-path：备份源路径，默认/backup
• BACKUP_DUPLICITY_url：远程备份目标URL（如ftp://user@host或s3://bucket）

Rancher API配置

可通过添加标签自动获取API权限：

io.rancher.container.create_agent=true
io.rancher.container.agent.role=environment

或手动设置：

• BACKUP_RANCHER_api_url：Rancher API地址
• BACKUP_RANCHER_api_key：API密钥
• BACKUP_RANCHER_api_secret：API密钥 secret

部署示例

bash
docker run -d \
  --name rancher-backup \
  -v /opt/backup/config:/opt/backup/config \
  -v /path/to/data:/backup \
  -e BACKUP_DUPLICITY_url="s3://my-bucket/rancher-backup" \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -e BACKUP_RANCHER_api_url="https://rancher.example.com/v3" \
  -e BACKUP_RANCHER_api_key="xxx" \
  -e BACKUP_RANCHER_api_secret="xxx" \
  webcenter/rancher-backup

扩展支持

如需添加新服务备份，需在backup/index和backup/template目录下分别添加配置文件：

1. backup/index/new-service.yml：定义服务识别正则
2. backup/template/new-service.yml：定义转储命令模板（使用Jinja2语法）

示例可参考镜像文档中的MySQL配置方式。