carinamarina/backup

备份容器数据

本镜像用于对数据卷中的单个目录创建归档文件，并可将归档上传至Rackspace Cloud Files容器，或输出至标准输出（stdout）；同时支持从Rackspace Cloud Files或标准输入（stdin）恢复归档文件。

核心功能

• 支持backup（备份）和restore（恢复）两种核心命令
• 备份目标可选：Rackspace Cloud Files容器或标准输出
• 恢复来源可选：Rackspace Cloud Files容器或标准输入
• 支持gzip压缩（备份）与解压（恢复）操作

使用场景

1. 将数据卷容器备份至Rackspace Cloud Files云端存储
2. 将数据卷容器备份至本地文件系统
3. 从Rackspace Cloud Files恢复历史备份
4. 从本地归档文件恢复数据

配置说明

环境变量（针对Rackspace Cloud Files操作）

• RS_USERNAME：Rackspace平台用户名
• RS_API_KEY：Rackspace平台API密钥
• RS_REGION_NAME：Rackspace服务区域名称（如用户偏好的区域）

命令参数

backup命令参数

• -c, --container：Cloud Files容器名称（使用--stdout时自动忽略）
• -h, --help：显示帮助信息
• -s, --source：备份源目录（该目录下所有文件将被归档）
• --stdout：将归档内容输出至标准输出，而非上传至Cloud Files
• -z, --zip：使用gzip压缩归档文件

restore命令参数

• -c, --container <name>：Cloud Files容器名称
• -d, --destination <path>：归档内容恢复的目标路径
• -h, --help：显示帮助信息
• -o, --object <name>：Cloud Files容器中的归档对象名称
• --stdin：从标准输入读取归档内容，而非从Cloud Files获取
• -z, --zip：使用gzip解压归档文件

操作示例

1. 备份数据卷容器至Rackspace Cloud Files

假设已创建数据卷容器mysql-data（数据卷路径为/data），且已配置Rackspace相关环境变量。执行以下命令上传备份：

bash
docker run \
  --rm \
  --env RS_USERNAME=${RS_USERNAME} \
  --env RS_API_KEY=${RS_API_KEY} \
  --env RS_REGION_NAME=${RS_REGION_NAME} \
  --volumes-from mysql-data \
  carinamarina/backup \
  backup \
  --source /data/ \
  --container mysql-backups \
  --zip

上传的归档对象名称格式为：{{ year }}/{{ month }}/{{ day }}/{{ hour }}-{{ minute }}-{{ pathToSource }}.tar.gz

2. 备份数据卷容器至本地

无需上传至云端时，可将归档输出至本地文件：

bash
docker run \
  --rm \
  --volumes-from mysql-data \
  carinamarina/backup \
  backup \
  --source /data/ \
  --stdout \
  --zip \
  > mysql-backup.tar.gz

此命令会在当前目录生成mysql-backup.tar.gz归档文件。

3. 从Rackspace Cloud Files恢复备份

配置好Rackspace环境变量后，执行以下命令恢复数据：

bash
docker run \
  --rm \
  --env RS_USERNAME=${RS_USERNAME} \
  --env RS_API_KEY=${RS_API_KEY} \
  --env RS_REGION_NAME=${RS_REGION_NAME} \
  --volumes-from mysql-data \
  carinamarina/backup \
  restore \
  --container mysql-backups \
  --object 2016/03/10/01-30-data.tar.gz \
  --destination /data/ \
  --zip

4. 从本地归档文件恢复备份

通过标准输入从本地文件恢复数据：

bash
docker run \
  --rm \
  --interactive \
  --volumes-from mysql-data \
  carinamarina/backup \
  restore \
  --destination /data/ \
  --stdin \
  --zip \
  < mysql-backup.tar.gz