tutum/dockup

Dockup

用于备份Docker容器卷的Docker镜像

名称由来：Docker + Backup = Dockup

镜像概述和主要用途

Dockup是一个专门用于备份和恢复Docker容器卷的工具镜像。它能够将指定容器的卷内容打包压缩，并上传到AWS S3存储桶，同时支持从S3存储桶恢复卷数据。

使用场景和适用范围

适用于需要定期备份Docker容器数据卷的场景，尤其是运行数据库、文件存储等关键业务的容器，确保数据安全和可恢复性。

核心功能和特性

• 支持将容器多个卷路径打包为tar.gz格式
• 自动为备份文件添加时间戳
• 上传备份文件到AWS S3存储桶
• 支持从S3存储桶恢复卷数据
• 可通过环境变量灵活配置备份参数

使用方法和配置说明

前提条件

1. 已运行需要备份的容器（带有卷）
2. 拥有AWS账号及S3访问权限（Access Key和Secret Key）

备份操作步骤

1. 确认目标容器的卷路径

首先运行目标容器（以mysql为例）：

bash
docker run -d --name mysql tutum/mysql

通过docker inspect命令查看容器卷信息：

bash
docker inspect mysql

在输出中找到卷信息，例如：

json
"Volumes": {
    "/etc/mysql": {},
    "/var/lib/mysql": {}
}

2. 创建环境变量配置文件

创建env.txt文件，包含以下配置：

AWS_ACCESS_KEY_ID=<您的AWS访问密钥>
AWS_SECRET_ACCESS_KEY=<您的AWS密钥>
AWS_DEFAULT_REGION=us-east-1
BACKUP_NAME=mysql
PATHS_TO_BACKUP=/etc/mysql /var/lib/mysql
S3_BUCKET_NAME=docker-backups.example.com

3. 运行Dockup容器执行备份

bash
docker run --rm \
--env-file env.txt \
--volumes-from mysql \
--name dockup borja/dockup

恢复操作步骤

要从S3恢复卷数据，启动容器时设置RESTORE环境变量为true：

bash
docker run --rm \
--env-file env.txt \
--volumes-from mysql \
-e RESTORE=true \
--name dockup borja/dockup

环境变量说明

S3存储桶命名规则

• 名称必须唯一且符合DNS规范
• 可包含小写字母、数字、连字符和句点
• 只能以字母或数字开头和结尾
• 不能包含句点紧邻连字符或另一个句点的情况

AWS S3区域列表