futurice/docker-volume-backup

docker-volume-backup

Docker镜像，用于执行Docker卷的简单备份。主要功能包括：

• 将卷挂载到容器中即可进行备份
• 使用完整的cron表达式调度备份
• 支持备份到本地磁盘、AWS S3或两者同时备份
• 可手动触发备份
• 可选在备份期间停止容器并在完成后重启，确保备份一致性
• 可选在备份容器前后执行命令，便于集成数据库备份工具等
• 可选将备份指标发送到InfluxDB用于监控

示例

本地备份

以Grafana数据备份为例：

yml
version: "3"

services:

  dashboard:
    image: grafana/grafana:5.3.4
    volumes:
      - grafana-data:/var/lib/grafana  # Grafana数据存储路径

  backup:
    image: futurice/docker-volume-backup:2.0.0
    volumes:
      - grafana-data:/backup/grafana-data:ro  # 只读挂载Grafana数据卷
      - ./backups:/archive  # 挂载本地文件夹作为备份存档

volumes:
  grafana-data:

此配置会每日备份Grafana数据卷，备份文件写入./backups，文件名格式如backup-2018-11-27T16-51-56.tar.gz。

S3备份

配置备份到AWS S3：

yml
version: "3"

services:

  dashboard:
    image: grafana/grafana:5.3.4
    volumes:
      - grafana-data:/var/lib/grafana  # Grafana数据存储路径

  backup:
    image: futurice/docker-volume-backup:2.0.0
    environment:
      AWS_S3_BUCKET_NAME: my-backup-bucket  # 已存在的S3桶名称
      AWS_ACCESS_KEY_ID: ${AWS_ACCESS_KEY_ID}  # 从环境变量读取AWS密钥
      AWS_SECRET_ACCESS_KEY: ${AWS_SECRET_ACCESS_KEY}
    volumes:
      - grafana-data:/backup/grafana-data:ro  # 只读挂载Grafana数据卷

volumes:
  grafana-data:

手动触发备份

手动触发备份命令：

bash
docker-compose exec backup ./backup.sh

若仅需手动备份，可设置BACKUP_CRON_EXPRESSION="#"禁用定时备份，然后执行上述命令。

备份时停止容器

为确保数据一致性，可让备份容器访问Docker socket并标记需停止的容器：

yml
version: "3"

services:

  dashboard:
    image: grafana/grafana:5.3.4
    volumes:
      - grafana-data:/var/lib/grafana
    labels:
      - "docker-volume-backup.stop-during-backup=true"  # 标记备份时需停止的容器

  backup:
    image: futurice/docker-volume-backup:2.0.0
    environment:
      AWS_S3_BUCKET_NAME: my-backup-bucket
      AWS_ACCESS_KEY_ID: ${AWS_ACCESS_KEY_ID}
      AWS_SECRET_ACCESS_KEY: ${AWS_SECRET_ACCESS_KEY}
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 允许访问Docker socket
      - grafana-data:/backup/grafana-data:ro

volumes:
  grafana-data:

备份前后执行命令

针对数据库等需特殊处理的场景，可在备份前后执行命令：

yml
version: "3"

services:

  database:
    image: influxdb:1.5.4
    volumes:
      - influxdb-data:/var/lib/influxdb
      - influxdb-temp:/tmp/influxdb  # 临时备份空间
    labels:
      - docker-volume-backup.exec-pre-backup=influxd backup -portable /tmp/influxdb  # 备份前执行
      - docker-volume-backup.exec-post-backup=rm -rfv /tmp/influxdb  # 备份后执行

  backup:
    image: futurice/docker-volume-backup:2.0.0
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - influxdb-temp:/backup/influxdb:ro  # 挂载临时空间进行备份
      - ./backups:/archive

volumes:
  influxdb-data:
  influxdb-temp:

配置说明

指标

备份后会生成指标（如压缩大小、容器数量、耗时等），可发送到InfluxDB用于监控。

自动备份轮换

本地备份可使用工具如rotate-backups；S3备份可利用S3版本控制和生命周期管理实现轮换。