容器与云原生 / 系统课时
备份与恢复数据卷
备份与恢复数据卷
本课通过临时 Alpine 容器把命名数据卷打包到宿主机,再恢复到一个新数据卷,并用文件内容和 SHA-256 校验值确认迁移结果。完成后,你将掌握不依赖业务镜像的数据卷备份流程。
学习目标
- 使用临时容器将命名数据卷归档为
tar.gz文件 - 将归档恢复到新的 Docker 数据卷
- 通过内容检查和校验值验证数据完整性
备份前先保证数据一致
数据卷可以被临时容器直接挂载,因此不需要进入原业务容器执行备份。但备份期间若仍有程序持续写入,归档中的多个文件可能来自不同时间点。
普通静态文件可以直接归档。数据库、消息队列等有状态服务应先停止写入,或先执行数据库自身的导出、快照命令,再备份生成的文件。下面示例使用静态文本文件,便于完整验证流程。
创建测试数据并记录校验值
下面的命令创建 demo-volume,写入测试文件,并输出原始文件的 SHA-256 值。示例需要本机已安装并启动 Docker。
bash
docker volume create demo-volume
docker run --rm -v demo-volume:/data alpine:3.20 sh -c 'printf "alice,100\nbob,200\n" > /data/users.txt && sha256sum /data/users.txt'预期输出
text
demo-volume
18c5a20957d5eef34bfaf5221973721406a7d42959cc6841a1538ad8b7ed74e8 /data/users.txt镜像首次下载时会额外显示拉取日志,这不影响结果。
将数据卷归档到宿主机
先在当前目录创建 backup 文件夹,再启动临时容器。源数据卷以只读方式挂载到 /data,宿主机目录挂载到 /backup,归档文件最终保存在宿主机。
bash
mkdir -p backup
docker run --rm -v demo-volume:/data:ro -v "$PWD/backup":/backup alpine:3.20 sh -c 'cd /data && tar czf /backup/demo-volume.tar.gz .'
ls -lh backup/demo-volume.tar.gz预期结果
text
backup/demo-volume.tar.gz 存在且文件大小大于 0。ls -lh 显示的时间和大小会因环境不同而变化。
cd /data 后归档当前目录,可以避免把宿主机相关的绝对路径写入压缩包。源卷使用 :ro,也能降低备份过程中被临时容器误修改的风险。
恢复到新的数据卷
不要直接覆盖原卷,先恢复到新卷并验证。这样即使归档损坏或操作错误,原数据仍然保留。
bash
docker volume create demo-volume-restored
docker run --rm -v demo-volume-restored:/data -v "$PWD/backup":/backup:ro alpine:3.20 sh -c 'cd /data && tar xzf /backup/demo-volume.tar.gz'预期输出
text
demo-volume-restored解压命令成功时通常没有额外输出。退出码 0 表示恢复命令执行成功。
验证恢复结果
最后读取新数据卷中的文件,并重新计算 SHA-256。恢复后的校验值应与备份前完全一致。
bash
docker run --rm -v demo-volume-restored:/data:ro alpine:3.20 sh -c 'cat /data/users.txt && sha256sum /data/users.txt'预期输出
text
alice,100
bob,200
18c5a20957d5eef34bfaf5221973721406a7d42959cc6841a1538ad8b7ed74e8 /data/users.txt文件内容正确且校验值一致,说明本次归档、迁移和恢复未改变数据。验证通过后,再让业务容器挂载新数据卷。
常见错误
- 报错
archive not found:确认命令在创建backup的同一目录执行,并检查backup/demo-volume.tar.gz是否存在。 - 恢复后文件层级多一层:归档和解压前都应先执行
cd /data,并使用.作为归档目标。 - 数据库恢复后无法启动:不要只复制正在写入的数据目录,应采用数据库官方备份工具或停机快照。
按自己的节奏,确认真正理解。