Dockerfile 定制镜像

---

介绍

Dockerfile 是一个文本文件，其内包含了一条条的指令（Instruction），没一条指令构建一层，因此每一条指令的内容，就是描述该层应当如何构建
以此前定制 nginx 镜像为例，这次我们使用 Dockerfile 来定制。在一个空白目录中，建立一个文本文件，并命名为 Dockerfile

$ mkdir mynginx
$ cd mynginx
$ touch Dockerfile

其内容为

FROM nginx
RUN echo '<h1>Hello,Docker</h1>' > /usr/share/nginx/html/index.html

FROM 指定基础镜像

所谓定制镜像，那一定是以一个镜像为基础，在其上进行定制。就像我们之前运行了一个 nginx 镜像的容器，再进行修改一样，基础镜像是必须指定的。而 FROM 就是指定基础镜像，因此一个 Dockerfile 中 FROM 是必备的指令，并且必须是第一条指令
在 Docker Store 上有非常多的高质量的官方镜像，有可以直接拿来使用的服务类的镜像，如 nginx、redis、mongo、mysql、httpd、php、tomcat 等。也有一些方便开发、构建、运行各种语言应用的镜像，如 node、openjdk、python、ruby、golang 等。可以在其中寻找一个最符合我们最终目标的镜像为基础镜像进行定制
如果没有找到对应服务的镜像，官方镜像中还提供了一些更为基础的操作系统镜像，如 ubuntu、debian、contos、fedora、alpine 等，这些操作系统的软件库为我们提供了更广阔的扩展空间
除了选择现有镜像为基础镜像外，Docker 还存在一个特殊的镜像，名为 scratch。这个镜像是虚拟的概念，并不实际存在，它表示一个空白的镜像

FROM scratch
...

如果你以 scratch 为基础镜像的话，意味着你不以任何镜像为基础，接下来所写的指令将作为镜像第一层开始存在。有的同学可能感觉很奇怪，没有任何基础镜像，我怎么去执行我的程序呢，其实对于 Linux 下静态编译的程序来说，并不需要有操作系统提供运行时支持，所需的一切库都已经在可执行文件里了，因此直接 FROM scratch 会让镜像体积更加小巧。使用 Go 语言开发的应用很多会使用这种方式来制作镜像，这也是为什么有人认为 Go 是特别适合容器微服务架构的语言的原因之一

RUN 执行命令

RUN 指令是用来执行命令行命令的。由于命令行的强大能力，RUN 指令在定制镜像时是最长用的指令之一，其有两种格式如下

• shell 格式
  RUN <命令>，就像直接在命令行中输入的命令一样。刚才写的 Dockerfile 中的 RUN 指令就是这种格式

RUN echo '<h1>Hello,Docker</h1>' > /usr/share/nginx/html/index.html

• exec 格式
  RUN ["可执行文件","参数1","参数2"]，这更像是函数调用中的格式

FROM debian:jessie
RUN apt-get update
RUN apt-get install -u gcc libc6-dev make
RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-3.2.5.tar.gz"
RUN mkdir -p /usr/local/src/redis
RUN tar zxf redis.tar.gz -C /usr/src/redis --strip-componets=1
RUN make -C /usr/local/src/redis
RUN make -C /usr/local/src/redis install

Dockerfile 中每一个指令都会建立一层，RUN 也不例外。每一个 RUN 的行为，就和刚才我们手工建立镜像的过程一样，新建立一层，在其上执行这些命令，执行结束后，commit 这一层的修改，构成新的镜像
而上面这种写法，创建了 7 层镜像。这是完全没有意义的，而且很多运行时不需要的东西，都被装进了镜像里，比如编译环境、更新的软件包等等。结果就是产生非常臃肿、非常多层的镜像，不仅仅增加了构建部署的时间，也很容易出错
Union FS 是有最大层数限制的，比如 AUFS，曾经是最大不得超过 42 层，现在是不得超过 127 层
上面的 Dockerfile 优化后如下

FROM debian:jessie
RUN buildDeps='gcc libc6-dev make' \
    && apt-get update \
    && apt-get install -y $buildDeps \
    && wget -O redis.tar.gz "http://download.redis.io/releases/redis-3.2.5.tar.gz" \
    && mkdir -p /usr/local/src/redis \
    && tar zxf redis.tar.gz -C /usr/local/src/redis --strip-components=1 \
    && make -C /usr/local/src/redis \
    && make -C /usr/local/src/redis install \
    && rm -rf /var/lib/apt/lists/* \
    && rm redis.tar.gz \
    && rm -r /usr/local/src/redis \
    && apt-get purge -y --auto-remove $buildDeps

首先，之前所有的命令只有一个目的，就是编译安装 redis ，因此没有必要建立很多层。因此，此例中使用一个 RUN，并利用 && 将各个命令串联起来。将此前 7 层，简化为 1 层。在撰写 Dockerfile 时，要经常提醒自己，这并不是在写 Shell 脚本，而是在定义每层如何构建
此外，还可以看到这一组命令的最后添加了清理命令，清除了编译时所需软件、下载及展开的文件和 apt 缓存文件。这一步很重要，在构建镜像时，一定要确保每一层只添加真正所需的东西，任何无关文件都应清理

构建镜像

现在查看此前 nginx 镜像，构建如下

$ docker build -t nginx:v3 .
Sending build context to Docker daemon  2.048kB
Step 1/2 : FROM nginx:latest
 ---> a1523e859360
Step 2/2 : RUN echo '<h1>Hello,Docker</h1>' > /usr/share/nginx/html/index.html
 ---> Running in 7f318c968548
Removing intermediate container 7f318c968548
 ---> 917f6f8fb014
Successfully built 917f6f8fb014
Successfully tagged nginx:v3

从命令的输出结果中，我们可以清晰的看到镜像的构建过程。在 Step 2 中，如同我们之前所说的那样，RUN 指令启动了一个容器 7f318c968548，执行了所要求的命令，并最后提交了这一层 917f6f8fb014，随后删除了所用到的这个容器 7f318c968548。这里使用 docker buile 命令进行镜像构建，格式如下

$ docker build [选项] <上下文路径/URL/->

在这里我们指定了最终镜像的名称 -t nginx:v3，构建成功后，我们可以像之前运行 nginx:v2 那样来运行这个镜像，其结果会和 nginx:v2 一样

镜像构建上下文（Context）

此前构建镜像时，可看到 docker build 命令最后有一个 .。. 表示当前目录，而 Dockerfile 就在当前目录，因此不少同学会认为这个路径是在指定 Dockerfile 所在路径，这么理解是不准确的，若对应上面的命令格式可发现，此为指定上下文
Docker 在运行时分为 Docker 引擎（即服务端守护进程）和客户端工具。Docker 的引擎提供了一组 REST API，被称为 Docker Remote API，而如 docker 命令这样的客户端工具，则是通过这组 API 与 Docker 引擎交互，从而完成各种功能。因此，虽然表面上我们好像是在本机执行各种 docker 功能，但实际上，一切都是使用的远程调用形式在服务端（Docker 引擎）完成。也因这种 C/S 设计，让我们操作远程服务器的 Docker 引擎变得轻而易举
当我们进行镜像构建时，并非所有定制都会通过 RUN 指令完成，经常会需要将一些本地文件复制进镜像，比如通过 COPY 指令、ADD 指令等。而 docker build 命令构建镜像，其实并非在本地构建，而是在服务端，也就是 Docker 引擎中构建的。
当构建时，用户指定构建镜像上下文的路径，docker build 命令得知这个路径后，会将路径下的所有内容打包，然后上传给 Docker 引擎。这样 Docker 引擎收到这个上下文包后，展开就会获得构建镜像所需的一切文件，若 Dockerfile 如下

COPY ./package.json /app/

这并不是要复制执行 docker build 命令所在目录下的 package.json，也不是复制 Dockerfile 所在目录下的 package.json，而是复制上下文（context）目录下的 package.json
因此，COPY 这类指令中的源文件的路径都是相对路径。这也是很多同学经常问的为什么 COPY ../package.json /app 或者 COPY /opt/xxx/app 无法工作的原因，因为这些路径已经超出了上下文的范围，Docker 引擎无法获得这些位置的文件，如果真的需要这些文件，应该将它们复制到上下文目录中
现在就可以理解刚才的命令 docker build -t nginx:v3 . 中的这个 .，实际上是在指定上下文的目录，docker build 命令会将该目录下的内容打包交给 Docker 引擎以帮助构建镜像
如果观察 docker build 输出，我们其实已经看到了这个发送上下文的过程

$ docker build -t nginx:v3 .
Sending build context to Docker daemon  2.048kB

理解构建上下文对于镜像构建是很重要的，可以避免犯一些不应该的错误。例如发现 COPY /opt/xxx/app 不工作，于是干脆将 Dockerfile 放到了硬盘目录去构建，结果发现 docker build 执行后，在发送数十 GB 的文件，极为缓慢且容易构建失败。那是因为这种做法是在让 docker build 打包整个硬盘，这显然是使用错误
一般来说，应该会将 Dockerfile 置于一个空目录下，或者项目根目录下。如果该目录下没有所需文件，那么应该把所需文件复制一份过来，如果目录下有些东西确实不希望构建时传递给 Docker 引擎，那么可以用 .gitignore 一样的语法写一个 .dockerignore，该文件是用于剔除不需要作为上下文传递给 Docker 引擎的
那么为什么会有人误认为 . 是指定 Dockerfile 所在目录？因为在默认情况下，如果不额外指定 Dockerfile 的话，会将上下文目录下名为 Dockerfile 的文件作为 Dockerfile
这只是默认行为，实际上 Dockerfile 的文件名并不要求必须为 Dockerfile，而且并不要求必须位于上下文目录中，比如可以用 -f ../Dockerfile.php 参数指定某个文件作为 Dockerfile
当然，一般大家习惯性的会使用默认的文件名 Dockerfile，以及会将其置于镜像构建上下文目录中

迁移镜像

Docker 还提供了 docker load 和 docker save 命令，用以将镜像保存为一个 tar 文件，然后传输到另一个位置上，再加载进来。这是在没有 Docker Registry 时的做法，现在已经不推荐，镜像迁移应该直接使用 Docker Registry，无论是直接使用 Docker Hub 还是使用内网私有 Registry 都可以
使用 docker save 命令可以将镜像保存为归档文件，比如我们希望保存这个 hello-world 镜像

$ docker image ls hello-world
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
hello-world         latest              fce289e99eb9        14 months ago       1.84kB

保存镜像的命令为

$ docker save hello-world | gzip > hello-world-latest.tgz

然后我们将 hello-world-latest.tgz 文件复制到了另一个机器上，可用如下命令加载镜像

$ docker load -i hello-world-latest.tgz
af0b15c8625b: Loading layer [==================================================>]  3.584kB/3.584kB
Loaded image: hello-world:latest

若我们结合这两个命令及 SSH 甚至 PV 的话，利用 Linux 强大的管道，我们可以写一个命令完成从一个机器将镜像迁移到另一个机器，并且带进度条的功能

$ docker save <镜像名> | bzip2 | pv | ssh <用户名>@<主机名> 'cat | docker load'