#使用Dockerfile定制镜像

从刚才的docker commit的学习中，我们可以了解到，镜像的定制实际上就是定制每一层所添加的配置、文件。如果我们可以把每一层修改、安装、构建、操作的命令都写入一个脚本，用这个脚本来构建、定制镜像，那么之前提及的无法重复的问题、镜像构建透明性的问题、体积的问题都会解决。这个脚本就是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

这个Dockerfile很简单，一共就两行。涉及到了两条指令，FROM和RUN

#FROM指定基础镜像

所谓定制镜像，那一定是以一个镜像为基础，在其上进行定制，就像我们之前运行了一个nginx镜像的容器，在进行修改一样，基础镜像是必须指定的。而FROM就是指定基础镜像，因此一个Dockerfile中FROM是必备的指令，并且必须是第一条指令。

在Docker Hub上有非常多的高质量的官方镜像，有可以直接拿来使用的服务类的镜像，如nginx、redis、mongo、mysql、HTTP的、PHP、tomcat等；也有一些方便开发、构建、运行各种语言应用的镜像，比如node、openjdk、python、ruby、golang等。可以在其中寻找一个最符合我们最终目标的镜像为基础镜像镜像定制。

如果没有找到对应服务的镜像，官方镜像中还提供了一些更为基础的操作系统镜像，如ubuntu、debian、centos、fedora、alpine等这些操作系统的软件库为我们提供了更广阔的扩展空间。

处理选择现有镜像为基础镜像外，Docker还存在一个特殊的镜像，名为scratch。这个镜像是虚拟的概念，并不实际存在，它表示一个空白镜像。

FROM scratch
...

如果你以scratch为基础镜像的化，意味着你不以任何镜像为基础，接下来所写的指令将作为镜像第一层开始存在。

不以任何系统为基础，直接将可执行文件复制进镜像的做法并不罕见，比如swarm、etcd。对于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”]，这更像是函数调用中的格式。

既然RUN就像shell脚本一样可以执行命令，那么我们是否就可以像shell脚本一样把每个命令对应一个RUN呢？

FROM debian:stretch

RUN apt-get update
RUN apt-get install -y gcc libc6-dev make wget
RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz"
RUN mkdir -p /usr/src/redis
RUN tar -xzf redis.tar.gz -C /usr/src/redis --strip-components=1
RUN make -C /usr/src/redis
RUN make -C /usr/src/redis install

之前说过，Dockerfile中每一个指令都会建立一层，run也不例外。每一个run的行为，就和刚才我们手工建立镜像的过程一样：新建立一层，在其上执行这些命令，commit这一层的修改，构成新的镜像。

而上面的这样写法，创建了7层镜像。这是完全没有意义的，而且很多运行时不需要的东西，都被装进了镜像里，比如编译环境、更新的软件包等等。结果就是产生非常臃肿、非常多层的镜像，不仅仅增加了构建部署的时间，也很容易出错。

Union FS是有最大层数限制的，比如AUFS，曾经是最大层不得超过42层，现在是不得超过127层。

上面的Dockerfile正确写法应该是这样的:

FROM debian:stretch

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

首先，之前所有的命令只有一个目的，就是编译、安装redis可执行文件。因此没有必要建立很多层，这只是一层的事前。因此，这里没有使用很多个Run对一一对应不同的命令，而是仅仅使用一个run指令，并使用&&将之前的7层，简化为了1层。在撰写Dockerfile的时候，要经常提醒自己，这并不是在写shell脚本，而是在定义每一层该如何构建。

并且，这里为了格式化还进行了换行。Dockerfile支持shell类的行尾添加\的命令换行方式，以及行首#进行注释的格式。良好的格式比如换行、缩进、注释等，会让维护、排障更为容易，这是一个比较好的习惯。

此外，还可以看到这一组命令的最后添加了清理工作的命令，删除了为了编译构建所需要的软件，清理了所有下载、展开的文件，并且清理了apt缓存文件。这是很重要的一步，我们之前说过，镜像是多层存储，每一层的东西并不会在下一层被删除，会跟随着镜像。因此构建镜像时，一定要确保每一层只添加真正需要添加的东西，任何无关的东西都应该被清理掉。

#构建镜像

好了，让我们在回到之前定制的nginx镜像的Dockerfile来。现在我们明白了这个docker的内容，那么让我们老构建这个镜像。

在dockerfile文件所在的目录执行：

$ docker build -t nginx:v3 .
Sending build context to Docker daemon 2.048 kB
Step 1 : FROM nginx
 ---> e43d811ce2f4
Step 2 : RUN echo '<h1>Hello, Docker!</h1>' > /usr/share/nginx/html/index.html
 ---> Running in 9cdc27646c7b
 ---> 44aa4490ce2c
Removing intermediate container 9cdc27646c7b
Successfully built 44aa4490ce2c

从命令的输出结果中，我们可以清晰的看到镜像的构建过程。在step 2中，如同我们这前所说的那样1，run指令启动了一个容器9cdc27646c7b，执行了所要求的命令，并且最后提交了这一层44aa4490ce2c，随后删除了所用到的这个容器9cdc27646c7b。

这里我们使用了docker build命令进行镜像构建。其格式为：

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

在这里我们指定了最终镜像的名称-t nginx：v3，构建成功后，我们可以像这前运行nginx：v2那样来运行这个镜像。

#镜像构建上下文(context)

如果注意，会看到docker build命令最后还有一个 .。.表示当前目录，而dockerfile就在当前目录，因此不少初学者以为这个路径是在指定dockefile所在路径，这么理解其实不是准确的。如果对应上面的格式命令，你可能会发现，这是在指定上下文路径。那么什么是上下文呢？

首先我们要理解docker build 的工作原理。Docker 在运行时分为Docker引擎(也就是服务端守护进程)和客户端工具。Docker的引擎提供了一组REST API，被称为Docker Remoto API，而如docker命令这样的客户端工具，则是通过这组API与Docker引擎交互，从而完成各种功能。因此，虽然表面上我们好像是在本机执行各种docke功能，在实际上，一切都是使用的远程调研形式在服务端(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输出，我们其实已经看到了这个发送上下文的进程:

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

理解构建上下文对于镜像构建是很重要的，避免犯一些不应该的错误。比如初学者在发现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 bulid 的用法
##直接用Git repo进行构建

或许你已经注意到了，docker build不支持从URL构建，比如可以直接从GIt repo中构建:

$ docker build https://github.com/twang2218/gitlab-ce-zh.git#:11.1

Sending build context to Docker daemon 2.048 kB
Step 1 : FROM gitlab/gitlab-ce:11.1.0-ce.0
11.1.0-ce.0: Pulling from gitlab/gitlab-ce
aed15891ba52: Already exists
773ae8583d14: Already exists
...

这行命令指定了构建所需的Git repo，并且指定默认的master分支，构建目录为/11.1/，然后docker就会自己去git clone这个项目、切换到指定分支、并进入到指定目录后开始构建。

##用给定的tar压缩包构建

$ docker build http://server/context.tar.gz

如果所给出的URL不是个git repo，而是个压缩包，那么docker引擎会下载这个包，并自动压缩，以其作为上下文，开始构建。

##从标准输入中读取Dockerfile进行构建

docker build - < Dockerfile
或
cat Dockerfile | docker build -

如果标准输入传入的是文本文件，则将其视为Dockerfile，并开始构建。这种形式由于直接从标准输入中读取Dockerfile的内容，它没有上下文，因此不可以像其它方法那样可以将本地文件copy进镜像之类的事情。

##从标准输入中读取上下文压缩包进行构建

$ docker build - < context.tar.gz

如果发现标准输入文件的格式是gzip、bzip2以及xz的话，将会使其Wie上下文压缩包，直接将其展开，将里面视为上下文，并开始构建。