容器与云原生 / 系统课时
导出与导入镜像
导出与导入镜像
当目标服务器无法访问镜像仓库时,可以先把镜像及其标签保存为归档文件,再复制到离线环境中加载。本课将完成多镜像导出、离线导入和运行验证,并区分镜像归档与容器文件系统导出。
学习目标
- 使用
docker image save将一个或多个镜像写入归档 - 使用
docker image load恢复镜像、标签和镜像层 - 区分
save/load与export/import的适用场景
适合使用镜像归档的场景
镜像归档适用于离线部署、跨网络隔离区迁移、构建产物备份,以及无法直接连接私有仓库的临时交付。归档文件可以同时包含多个镜像,重复使用的镜像层只需保存一次,因此比逐个传输更便于管理。
归档不是运行中容器的数据备份。数据库文件、挂载卷和容器运行后产生的数据不会自动进入镜像归档;这些内容需要按卷或业务数据的备份方式单独处理。
导出一个或多个镜像
下面拉取两个小型镜像,为它们添加便于识别的离线标签,然后写入同一个 offline-images.tar 文件。命令成功后通过文件非空检查给出确定结果。
docker pull --quiet alpine:3.20 >/dev/null
docker pull --quiet busybox:1.36.1 >/dev/null
docker image tag alpine:3.20 offline/alpine:3.20
docker image tag busybox:1.36.1 offline/busybox:1.36.1
docker image save --output offline-images.tar offline/alpine:3.20 offline/busybox:1.36.1
test -s offline-images.tar && echo "archive ready"预期输出:
archive ready归档中包含镜像配置、层数据、清单以及被保存的标签。文件大小取决于镜像层内容,实际值可能不同。传输前应确认目标主机有足够磁盘空间,并使用校验和或受控传输方式避免文件损坏。
在离线环境导入并验证
把 offline-images.tar 复制到目标主机后,在已安装并启动 Docker 的环境中执行加载。下面的运行验证会分别启动两个临时容器,输出成功标记后自动删除容器。
docker image load --quiet --input offline-images.tar >/dev/null
docker image inspect offline/alpine:3.20 >/dev/null && echo alpine-loaded
docker image inspect offline/busybox:1.36.1 >/dev/null && echo busybox-loaded
docker run --rm offline/alpine:3.20 echo alpine-ok
docker run --rm offline/busybox:1.36.1 echo busybox-ok预期输出:
alpine-loaded
busybox-loaded
alpine-ok
busybox-ok如果目标主机已经存在相同内容,加载过程可能复用本地镜像层,但标签仍会按归档内容恢复。验收重点是两个标签都能被检查并成功运行。
save/load 与 export/import 的区别
| 命令组合 | 处理对象 | 保留内容 | 典型用途 |
|---|---|---|---|
docker image save / docker image load |
镜像 | 镜像层、配置、历史和标签 | 离线迁移、备份、交付 |
docker container export / docker image import |
容器文件系统 | 合并后的文件内容,通常不保留原镜像历史和完整配置 | 制作简化文件系统快照 |
需要原样恢复镜像及标签时应选择 save/load。只有明确需要把某个容器当前文件系统压平成新镜像时,才考虑 export/import;它不能替代标准镜像构建流程,也不包含挂载卷中的数据。
常见失败与处理顺序
导入时报空间不足,应先检查 Docker 数据目录所在磁盘,而不只是归档文件所在目录。出现归档损坏或意外结束时,应重新传输文件并核对校验值;不要继续使用来源不明或校验不一致的归档。
加载成功但运行失败时,先确认主机 CPU 架构是否与镜像平台匹配,再检查镜像入口命令和运行参数。镜像能被 load 接受,只能说明归档结构可读,并不保证它适合当前主机或业务运行条件。
本课总结
docker image save可以把多个镜像及其标签保存到同一个归档文件docker image load会恢复镜像层和标签,适合离线部署与镜像备份- 容器数据卷不属于镜像归档,
export/import也不能等价替代save/load
下一课预告
下一课将继续管理本地镜像,学习如何安全删除无用标签、悬空镜像和未被使用的镜像数据。