很久沒有寫博客了，墳頭草都長了老高了。寫博客要靠慣性，一旦停下來時間長了，就很難再堅持下去。今天艱難地撿起來，以后每周至少寫一篇。

這篇文章講一講docker save和docker export的區別。

緣起

docker save和docker export都能導出鏡像包，咋看起來區別似乎不大。本文就針對這個問題，試圖搞清楚docker save和docker export的功能是什么？適用於什么應用場景？

本文的測試的Docker版本如下，不保證所有版本的docker都能重現本文的結果。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
>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的命令行接口設計得很優雅，很多命令的幫助直接在后面加--help就可以查看。

docker save的幫助如下：

1
2
3
4
5
6
7
8
9
 
>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打包，那么可以執行：

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

打包之后的images.tar包含postgres:9.6和mongo:3.4這兩個鏡像。

雖然命令行參數要求指定image，實際上也可以對container進行打包，例如：

1
2
3
4
5
6
7
8
9
 
>docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
3623943d369f postgres:9.6 "docker-entrypoint..." 3 hours ago Up 3 hours 5432/tcp postgres

>docker save -o b.tar postgres
>docker save -o c.tar postgres:9.6
>ls -al
-rwxrwxrwx 1 root root 277886464 8月 26 14:40 b.tar
-rwxrwxrwx 1 root root 277886464 8月 26 14:41 c.tar

通過以上命令可以看到，b.tar和c.tar是完全一模一樣的。這說明，docker save如果指定的是container，docker save將保存的是容器背后的image。

將打包后的鏡像載入進來使用docker load，例如：

1
 
docker load -i images.tar

上述命令將會把postgres:9.6和mongo:3.4載入進來，如果本地鏡像庫已經存在這兩個鏡像，將會被覆蓋。

docker save的應用場景是，如果你的應用是使用docker-compose.yml編排的多個鏡像組合，但你要部署的客戶服務器並不能連外網。這時，你可以使用docker save將用到的鏡像打個包，然后拷貝到客戶服務器上使用docker load載入。

docker export

照例查看下docker export的幫助：

1
2
3
4
5
6
7
8
9
 
>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的文件系統進行打包的。例如：

1
 
docker export -o postgres-export.tar postgres

docker export需要指定container，不能像docker save那樣指定image或container都可以。

將打包的container載入進來使用docker import，例如：

1
 
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的區別：

  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的鏡像包呢？

以下開始試驗，准備以下兩個文件：

1
2
3
 
>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：

1
2
 
>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載入鏡像包可不可以呢？

1
2
3
4
5
 
>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容器：

1
2
3
 
>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'.

雖然能夠成功地導入為一個鏡像，然而這個鏡像並不能使用。

要搞清楚到底是怎么回事，我們先看看鏡像包和容器包由什么區別：

從上面可以看出右邊的postgres-export.tar的內容是一個linux系統的文件目錄，猜測就是一個linux鏡像。而postgres-save.tar里面到底是什么內容呢？點開一個文件夾看看：

其實就是一個分層的文件系統。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的幫助：

1
2
3
4
5
6
7
8
 
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很像：

1
2
3
4
5
6
7
8
9
10
11
 
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幫助文檔
  2. docker load幫助文檔
  3. docker export幫助文檔
  4. docker import幫助文檔
  5. docker commit幫助文檔