如何迁移含所有父层的Docker镜像至其他机器？解决层缺失问题

这种情况我之前排查过好几次，多半是docker save的用法细节没注意到，或者加载后的标签配置有问题，咱们一步步来解决：

1. 先确认你用对了docker save命令 #

很多人踩坑是因为只保存了镜像ID，没指定完整的镜像标签，或者没正确打包所有关联层。正确的命令应该是：

# 一定要指定镜像名+标签，而不是只给ID
docker save -o myimage_full.tar myimage:latest

如果你的镜像有多个标签，或者是基于其他本地镜像构建的，这个命令会自动把所有依赖的父层都打包进去——Docker官方文档说的没错，docker save确实会包含完整的层链，只要源机器上的镜像本身是完整可运行的。

2. 检查打包的tar包是否完整 #

把生成的tar包解压看看结构，确认所有层都在里面：

tar -xvf myimage_full.tar

解压后你会看到多个以层ID命名的文件夹，还有一个manifest.json文件。打开manifest.json，里面会列出这个镜像包含的所有层的digest和顺序，如果某个层的条目缺失，说明打包过程出了问题，需要重新执行docker save。

3. 加载镜像时的正确操作 #

把tar包传到目标机器后，用以下命令加载：

docker load -i myimage_full.tar

加载完成后，一定要确认镜像的标签是否正确——有时候如果save时没指定标签，加载后的镜像会显示为<none>:<none>，这时候你需要手动打标签：

# 替换成你加载后的镜像ID和想要的标签
docker tag abc123 myimage:latest

打完标签再执行docker history myimage:latest，应该就能看到完整的层历史了。

4. 极端情况排查：源镜像本身是否完整？ #

如果上面的步骤都试过还是不行，那得检查源机器上的镜像是不是真的完整。在源机器上执行：

docker inspect myimage:latest

查看RootFS.Layers字段，里面列出了镜像的所有层。然后去源机器的Docker存储目录（通常是/var/lib/docker/overlay2，具体取决于你的存储驱动）看看这些层的文件夹是否存在。如果源机器上就有缺失的层，那说明你的源镜像本身就有问题，需要重新构建镜像。

内容的提问来源于stack exchange，提问作者emmerich