容器与云原生 / 系统课时

导出与导入镜像

导出与导入镜像

当目标服务器无法访问镜像仓库时,可以先把镜像及其标签保存为归档文件,再复制到离线环境中加载。本课将完成多镜像导出、离线导入和运行验证,并区分镜像归档与容器文件系统导出。

学习目标

  • 使用 docker image save 将一个或多个镜像写入归档
  • 使用 docker image load 恢复镜像、标签和镜像层
  • 区分 save/load 与 export/import 的适用场景

适合使用镜像归档的场景

镜像归档适用于离线部署、跨网络隔离区迁移、构建产物备份,以及无法直接连接私有仓库的临时交付。归档文件可以同时包含多个镜像,重复使用的镜像层只需保存一次,因此比逐个传输更便于管理。

归档不是运行中容器的数据备份。数据库文件、挂载卷和容器运行后产生的数据不会自动进入镜像归档;这些内容需要按卷或业务数据的备份方式单独处理。

导出一个或多个镜像

下面拉取两个小型镜像,为它们添加便于识别的离线标签,然后写入同一个 offline-images.tar 文件。命令成功后通过文件非空检查给出确定结果。

bash
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"

预期输出:

text
archive ready

归档中包含镜像配置、层数据、清单以及被保存的标签。文件大小取决于镜像层内容,实际值可能不同。传输前应确认目标主机有足够磁盘空间,并使用校验和或受控传输方式避免文件损坏。

在离线环境导入并验证

把 offline-images.tar 复制到目标主机后,在已安装并启动 Docker 的环境中执行加载。下面的运行验证会分别启动两个临时容器,输出成功标记后自动删除容器。

bash
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

预期输出:

text
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

下一课预告

下一课将继续管理本地镜像,学习如何安全删除无用标签、悬空镜像和未被使用的镜像数据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

导出与导入镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通