• Dockerfile 时一个文本文件，内部包含了一条条指令(instruction) 每条指令构建一层，因此每条指令内容就是描述该层应当如何构建

    FROM 指定基础镜像

    所谓定制镜像，都是以一个镜像位基础，在其上进行定制，基础镜像是必须指定的，FROM 就是指定基础镜像，因此一个Dockerfile 中From是必须的指令，而且必须位第一条指令。

SCRATCH

FROM scratch
scratch 是虚拟的概念，并不实际存在，表示一个空白的镜像。
如果像上例一样以scratch位基础镜像的话，意味着不以任何镜像作为基础，接下来缩写的指令将作为镜像第一层开始存在。
不以任何系统为基础，直接将可执行文件复制进镜像的做法并不罕见，比如 swarm、etcd。对于 Linux 下静态编译的程序来说，并不需要有操作系统提供运行时支持，所需的一切库都已经在可执行文件里了，因此直接 FROM scratch 会让镜像体积更加小巧。使用 Go 语言 开发的应用很多会使用这种方式来制作镜像，这也是为什么有人认为 Go 是特别适合容器微服务架构的语言的原因之一。

RUN 执行命令

run 指令是用来执行命令行命令的，由于命令行的强大能力，run指令在定制镜像时是最常用的指令之一，格式有两种

  • shell格式 RUN 命令，就像直接在命令行中署入命令一样。
  • exec 格式：RUN ["可执行文件", "参数1", "参数2"]，这更像是函数调用中的格式。

虽然run可以像shell脚本一样执行命令，但是不要把所有命令都对应一个RUN 

  1. FROM debian:stretch
  3. RUN apt-get update
  4. RUN apt-get install -y gcc libc6-dev make wget
  5. RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz"
  6. RUN mkdir -p /usr/src/redis
  7. RUN tar -xzf redis.tar.gz -C /usr/src/redis --strip-components=1
  8. RUN make -C /usr/src/redis
  9. RUN make -C /usr/src/redis install

因为dockerfile中每个指令都会建立一层，RUN也不例外，每一个RUN的行为，就可杠才手工建立镜像的过程一样，新建立一层，在其上执行这些命令，执行结束后，commit这一层的修改，构成新的镜像。
而上面的写法是没有意义的。

  1. FROM debian:stretch
  3. RUN buildDeps='gcc libc6-dev make wget' \
  4.     && apt-get update \
  5.     && apt-get install -y $buildDeps \
  6.     && wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz" \
  7.     && mkdir -p /usr/src/redis \
  8.     && tar -xzf redis.tar.gz -C /usr/src/redis --strip-components=1 \
  9.     && make -C /usr/src/redis \
  10.     && make -C /usr/src/redis install \
  11.     && rm -rf /var/lib/apt/lists/* \
  12.     && rm redis.tar.gz \
  13.     && rm -r /usr/src/redis \
  14.     && apt-get purge -y --auto-remove $buildDeps

union FS 是由最大层数限制的， 比如AUFS ，曾经最大不得超过42曾，现在不得超过127层。
上面给出正确写法。
写dockerfile的时候应该时刻提醒自己，不是在写shell脚本，二十载定义每一层应该如何构建。
换行使用 \ , 注释使用 # 。良好的习惯会使的维护更为容易。
另外，可以看到命令最后添加了清理工作的命令，删除了为编译构建所需要的软件，
清理了所有下载，展开的文件，把那个且还清理了 apt缓存文件，这里很重要。
镜像是多层存储，每一层的东西并不会在下一层被删除，会一直跟着镜像，因此镜像构建时，一定要确保每一层只添加真正需要添加的东西，无关东西清楚掉。

这有利于制作出来瘦身的镜像。

构建镜像

在dockerfile 文件所在目录执行
docker build -t nginx:v3 .

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

会自动在当前路径下寻找Dockerfile文件进行构建，注意大写
docker build [选项] <上下文路径/URL/->

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

镜像构建上下文(context)

理解上下文首先需要例姐 docker build 的工作原理。
首先我们要理解 docker build 的工作原理。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 中这么写：

  1. COPY ./package.json /app/

这并不是要复制执行 docker build 命令所在的目录下的 package.json，也不是复制 Dockerfile 所在目录下的 package.json，而是复制 上下文（context） 目录下的 package.json。

现在就可以理解刚才的命令 docker build -t nginx:v3 . 中的这个 .，实际上是在指定上下文的目录，docker build 命令会将该目录下的内容打包交给 Docker 引擎以帮助构建镜像。
如果观察 docker build 输出，我们其实已经看到了这个发送上下文的过程：

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

一般来说，应该会将dockerfile 置于一个空目录下，或者项目根目录下，如果该项目下没有所需文件，那么应该把所需文件复制一份过来。
如果目录下有些东西不希望构建时传给docker引擎，可以使用 .gitignore 一样的语法写一个 .dockerignore,用来提出不需要作为上下文传递给Docker引擎的文件。

那么为什么会有人误以为 . 是指定 Dockerfile 所在目录呢？这是因为在默认情况下，如果不额外指定 Dockerfile 的话，会将上下文目录下的名为 Dockerfile 的文件作为 Dockerfile。
这只是默认行为，实际上 Dockerfile 的文件名并不要求必须为 Dockerfile，而且并不要求必须位于上下文目录中，比如可以用 -f ../Dockerfile.php 参数指定某个文件作为 Dockerfile。
当然，一般大家习惯性的会使用默认的文件名 Dockerfile，以及会将其置于镜像构建上下文目录中。

其他 docker build 用法
直接使用git repo 进行构建
docker build 还支持从 url 构建，比如可以直接从git repo中构建

  1. $ docker build https://github.com/twang2218/gitlab-ce-zh.git#:11.1
  3. Sending build context to Docker daemon 2.048 kB
  4. Step 1 : FROM gitlab/gitlab-ce:11.1.0-ce.0
  5. 11.1.0-ce.0: Pulling from gitlab/gitlab-ce
  6. aed15891ba52: Already exists
  7. 773ae8583d14: Already exists
  8. ...

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

用给定的tar压缩包进行构建

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

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

  1. docker build - < Dockerfile
  2. 或者
  3. cat Dockerfile | docker build -

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

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

  1. $ docker build - < context.tar.gz