docker save 与 docker export 的区别 - jingsam

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [jingsam.github.io](https://jingsam.github.io/2017/08/26/docker-save-and-docker-export.html)

很久没有写博客了，坟头草都长了老高了。写博客要靠惯性，一旦停下来时间长了，就很难再坚持下去。今天艰难地捡起来，以后每周至少写一篇。

这篇文章讲一讲 docker save 和 docker export 的区别。

[](#缘起 "缘起")缘起
--------------

docker save 和 docker export 都能导出镜像包，咋看起来区别似乎不大。本文就针对这个问题，试图搞清楚 docker save 和 docker export 的功能是什么？适用于什么应用场景？

本文的测试的 Docker 版本如下，不保证所有版本的 docker 都能重现本文的结果。

```
>docker version

Client:
 Version:      17.07.0-ce-rc1
 API version:  1.31
 Go version:   go1.8.3
 Git commit:   8c4be39
 Built:        Wed Jul 26 05:19:44 2017
 OS/Arch:      windows/amd64

Server:
 Version:      17.07.0-ce-rc1
 API version:  1.31 (minimum version 1.12)
 Go version:   go1.8.3
 Git commit:   8c4be39
 Built:        Wed Jul 26 05:25:01 2017
 OS/Arch:      linux/amd64
 Experimental: true
```

另外我是在 Windows on bash 里面操作 docker，有些命令如`ls`并不是 windows 命令，如果想要复现我的试验，请换成相应的 windows 命令。

[](#docker-save "docker save")docker save
-----------------------------------------

docker 的命令行接口设计得很优雅，很多命令的帮助直接在后面加`--help`就可以查看。

docker save 的帮助如下：

```
>docker save --help

Usage:  docker save [OPTIONS] IMAGE [IMAGE...]

Save one or more images to a tar archive (streamed to STDOUT by default)

Options:
      --help            Print usage
  -o, --output string   Write to a file, instead of STDOUT
```

从命令行帮助可以看出，docker save 是用来将一个或多个 image 打包保存的工具。

例如我们想将镜像库中的 postgres 和 mongo 打包，那么可以执行：

```
docker save -o images.tar postgres:9.6 mongo:3.4
```

打包之后的`images.tar`包含`postgres:9.6`和`mongo:3.4`这两个镜像。

将打包后的镜像载入进来使用 docker load，例如：

```
docker load -i images.tar
```

上述命令将会把`postgres:9.6`和`mongo:3.4`载入进来，如果本地镜像库已经存在这两个镜像，将会被覆盖。

docker save 的应用场景是，如果你的应用是使用 docker-compose.yml 编排的多个镜像组合，但你要部署的客户服务器并不能连外网。这时，你可以使用 docker save 将用到的镜像打个包，然后拷贝到客户服务器上使用 docker load 载入。

[](#docker-export "docker export")docker export
-----------------------------------------------

照例查看下 docker export 的帮助：

```
>docker export --help

Usage:  docker export [OPTIONS] CONTAINER

Export a container's filesystem as a tar archive

Options:
      --help            Print usage
  -o, --output string   Write to a file, instead of STDOUT
```

从帮助可以看出，docker export 是用来将 container 的文件系统进行打包的。例如：

```
docker export -o postgres-export.tar postgres
```

docker export 需要指定 container，不能像 docker save 那样指定 image。

将打包的 container 载入进来使用 docker import，例如：

```
docker import postgres-export.tar postgres:latest
```

从上面的命令可以看出，docker import 将 container 导入后会成为一个 image，而不是恢复为一个 container。

另外一点是，docker import 可以指定 IMAGE[:TAG]，说明我们可以为镜像指定新名称。如果本地镜像库中已经存在同名的镜像，则原有镜像的名称将会被剥夺，赋给新的镜像。原有镜像将成为孤魂野鬼，只能通过 IMAGE ID 进行操作。

docker export 的应用场景主要用来制作基础镜像，比如你从一个 ubuntu 镜像启动一个容器，然后安装一些软件和进行一些设置后，使用 docker export 保存为一个基础镜像。然后，把这个镜像分发给其他人使用，比如作为基础的开发环境。

[](#docker-save和docker-export的区别 "docker save和docker export的区别")docker save 和 docker export 的区别
-----------------------------------------------------------------------------------------------

总结一下 docker save 和 docker export 的区别：

1.  docker save 保存的是镜像（image），docker export 保存的是容器（container）；
2.  docker load 用来载入镜像包，docker import 用来载入容器包，但两者都会恢复为镜像；
3.  docker load 不能对载入的镜像重命名，而 docker import 可以为镜像指定新名称。

[](#脑洞 "脑洞")脑洞
--------------

前面所讲的内容都是些基础知识，相信各位读者只要仔细看下官方文档就能知晓。这一节我来讲讲文档上没有的东西。

docker load 和 docker import 都可以将 tar 包导入为镜像，我不禁脑洞一下，docker load 能不能导入 docker export 的容器包，docker import 能不能导入 docker save 的镜像包呢？

以下开始试验，准备以下两个文件：

```
>ls -al
-rwxrwxrwx 1 root root 271760384 8月  26 12:15 postgres-export.tar
-rwxrwxrwx 1 root root 398292480 8月  26 12:13 postgres-save.tar
```

其中`postgres-export.tar`是通过 docker export 导出的容器包，`postgres-save.tar`是通过 docker save 保存的镜像包，两者都是基于`postgres:9.6`镜像。从文件大小可以直观的发现，`postgres-export.tar`显然要比`postgres-save.tar`小 100 多 M。

现在试试 docker load 容器包`postgres-export.tar`：

```
>docker load -i postgres-export.tar
open /var/lib/docker/tmp/docker-import-082344818/bin/json: no such file or directory
```

显然，docker load 不能载入容器包。

那么，反过来，docker import 载入镜像包可不可以呢？

```
>docker import postgres-save.tar postgres
sha256:8910feec1ee2fac8c152dbdd0aaab360ba0b833af5c3ad59fcd648b9a24d4838
>docker image ls
REPOSITORY                                      TAG                 IMAGE ID            CREATED             SIZE
postgres                                        latest              8910feec1ee2        2 minutes ago       398MB
```

WTF，竟然成功了！！！

莫慌，再试试启动一个 postgres 容器：

```
>docker run postgres
C:\Program Files\Docker\Docker\resources\bin\docker.exe: Error response from daemon: No command specified.
See 'C:\Program Files\Docker\Docker\resources\bin\docker.exe run --help'.
```

虽然能够成功地导入为一个镜像，然而这个镜像并不能使用。

要搞清楚到底是怎么回事，我们先看看镜像包和容器包由什么区别：

[![](https://jingsam.github.io/2017/08/26/docker-save-and-docker-export/docker-save-vs-docker-export.png)](https://jingsam.github.io/2017/08/26/docker-save-and-docker-export/docker-save-vs-docker-export.png)

从上面可以看出右边的`postgres-export.tar`的内容是一个 linux 系统的文件目录，猜测就是一个 linux 镜像。而`postgres-save.tar`里面到底是什么内容呢？点开一个文件夹看看：

[![](https://jingsam.github.io/2017/08/26/docker-save-and-docker-export/postgres-save.png)](https://jingsam.github.io/2017/08/26/docker-save-and-docker-export/postgres-save.png)

其实就是一个分层的文件系统。Docker 镜像实际上就是由这样的一层层文件进行叠加起来的，上层的文件会覆盖下层的同名文件。如果将`postgres-save.tar`中的各层文件合并到一起，基本就是`postgres-export.tar`的内容。由于`postgres-save.tar`里面的各层文件会存在很多重复的文件，这也解释了为什么`postgres-save.tar`会比`postgres-export.tar`大 100 多 M。

docker load 必须要载入的是一个分层文件系统，而`postgres-export.tar`并不具有这样的结构，因此无法载入。

而 docker import 仅仅是将 tar 包里面的文件复制进来，所以不管 tar 包里面的文件结构是怎样的，都可以载入进来，所以能够载入`postgres-save.tar`。但`postgres-save.tar`并不是一个有效的操作系统镜像，因此当我试图以改镜像启动容器时，容器并不能启动。

我们再来看看 docker import 的帮助：

```
Usage:  docker import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]

Import the contents from a tarball to create a filesystem image

Options:
  -c, --change list      Apply Dockerfile instruction to the created image
      --help             Print usage
  -m, --message string   Set commit message for imported image
```

似乎和 docker commit 很像：

```
Usage:  docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]

Create a new image from a container's changes

Options:
  -a, --author string    Author (e.g., "John Hannibal Smith
                         <hannibal@a-team.com>")
  -c, --change list      Apply Dockerfile instruction to the created image
      --help             Print usage
  -m, --message string   Commit message
  -p, --pause            Pause container during commit (default true)
```

发现 docker import 和 docker commit 都有`--change`和`--message`选项。我们可以将 docker import 理解为将外部文件复制进来形成只有一层文件系统的镜像，而 docker commit 则是将当前的改动提交为一层文件系统，然后叠加到原有镜像之上。

关于 docker save 和 docker export 的区别讲得差不多，拜了个拜。

[](#参考文献 "参考文献")参考文献
--------------------

1.  [docker save 帮助文档](https://docs.docker.com/engine/reference/commandline/save/)
2.  [docker load 帮助文档](https://docs.docker.com/engine/reference/commandline/load/)
3.  [docker export 帮助文档](https://docs.docker.com/engine/reference/commandline/export/)
4.  [docker import 帮助文档](https://docs.docker.com/engine/reference/commandline/import/)
5.  [docker commit 帮助文档](https://docs.docker.com/engine/reference/commandline/commit/)