Docker之Dockerfile详解

Dockerfile的指令是忽略大小写的，建议使用大写，使用#作为注释，每一行只支持一条指令，每条指令可以携带多个参数。

Dockerfile的指令根据作用可以分为两种：构建指令和设置指令。构建指令用于构建image，其指定的操作不会在运行image的容器上执行；设置指令用于设置image的属性，其指定的操作将在运行image的容器中执行。

1）FROM

说明：指定基础image

构建指令，必须指定且需要在Dockerfile其他指令的前面。后续的指令都依赖于该指令指定的image。FROM指令指定的基础image可以是官方远程仓库中的，也可以位于本地仓库。

FROM <image>[:<tag>]

说明：无 [:<tag>] 表示指定基础image为该image的最后修改的版本。

2）MAINTAINER

说明：用来指定镜像创建者信息

构建指令，用于将image的制作者相关的信息写入到image中。当我们对该image执行docker inspect命令时，输出中有相应的字段记录该信息。格式：

MAINTAINER <name>

3）RUN

说明：容器中执行命令，然后把执行后的改变提交到当前镜像，提交后的镜像（作为一层文件）会被用于Dockerfile中定义的下一步操作，RUN中定义的命令会按顺序执行并提交，这正是Docker廉价的提交和可以基于镜像的任何一个历史点创建容器的好处，就像版本控制工具一样。

构建指令，RUN可以运行任何被基础image支持的命令。如基础image选择了centos，那么软件管理部分只能使用centos的命令。该指令有两种格式：

# the command is run in a shell - `/bin/sh -c`
RUN <command>

# 调用exec执行，以避免有些时候shell方式执行时的传递参数问题，而且有些基础镜像可能不包含/bin/sh
RUN ["executable", "param1", "param2" ... ]

尽量使用

&&

和

\

将所有的指令都压缩为了一行，这里有两个原因：

RUN

指令不会保存上一条指令的工作路径，每条

RUN

指令都只会将工作目录指定为

/

目录

一条 Dockerfile 中的指令就会产生一次镜像的提交，换言之，减少 Dockerfile 中的指令就可以提高镜像的复用水平

4）CMD

说明：设置容器启动时执行的操作。

设置指令，用于container启动时指定的操作。该操作可以是执行自定义脚本，也可以是执行系统命令。该指令只能在文件中存在一次，如果有多个，则只执行最后一条。该指令有三种格式：

# like an exec, this is the preferred form. 命令必须为绝对路径
CMD ["executable","param1","param2"]

# 将会调用 /bin/sh -c command
CMD command [param1,param2]

当Dockerfile指定了ENTRYPOINT，CMD中定义的内容会作为ENTRYPOINT指令的默认参数，也就是说可以使用CMD指令给ENTRYPOINT传递参数。当Docker run command的命令匹配到CMD command时，会替换CMD执行的命令。

# as default parameters to ENTRYPOINT
CMD ["param1","param2"]

例如：

FROM ubuntu:14.10

# 把可能需要变动的参数写到CMD里面。
# 然后你可以在docker run image command params，这样CMD里的参数(这里是-c)就会被 params 覆盖掉而ENTRYPOINT里的参数 -a 不被覆盖。
# 比如：docker run image ls -a -l

ENTRYPOINT ["ls", "-a"]
CMD ["-c"]

5）ENTRYPOINT

说明：设置容器启动时执行的操作

ENTRYPOINT指定的是一个可执行的脚本或者程序的路径，该指定的脚本或者程序将会以param1和param2作为参数执行。所以如果CMD指令使用上面的形式（作为参数），那么Dockerfile中必须要有配套的ENTRYPOINT。

container启动时执行的命令，但是一个Dockerfile中只能有一条ENTRYPOINT命令，如果多条，则只执行最后一条。ENTRYPOINT没有CMD的可替换特性。该指令的使用分为两种情况，一种是独自使用，另一种和CMD指令配合使用。

# as a shell
ENTRYPOINT command param1 param2

# like an exec, the preferred form
ENTRYPOINT ["executable", "param1", "param2"]

1) 当独自使用时，如果你还使用了CMD命令且CMD是一个完整的可执行的命令，那么CMD指令和ENTRYPOINT会互相覆盖只有最后一个CMD或者ENTRYPOINT有效。

# CMD指令将不会被执行,只有ENTRYPOINT指令被执行;
...
CMD echo "Hello, World!"
​​​​​​​ENTRYPOINT ls -l

2) 和CMD指令配合使用来指定ENTRYPOINT的默认参数，这时CMD指令不是一个完整的可执行命令，仅仅是参数部分；ENTRYPOINT指令只能使用JSON方式指定执行命令，而不能指定参数。

FROM ubuntu
CMD ["-l"]
ENTRYPOINT ["/usr/bin/ls"]

6）USER

说明：设置容器的用户，默认是root用户。​​​​​​​​​​​​​​

# 指定memcached的运行用户;

ENTRYPOINT ["memcached"]

USER daemon

或

ENTRYPOINT ["memcached", "-u", "daemon"]

7）EXPOSE

说明：指定容器需要映射到宿主机器的端口
该指令会将容器中的端口映射成宿主机器中的某个端口。当你需要访问容器的时候，可以不是用容器的IP地址而是使用宿主机器的IP地址和映射后的端口。要完成整个操作需要两个步骤，首先在Dockerfile使用EXPOSE设置需要映射的容器端口，然后在运行容器的时候指定-p选项加上EXPOSE设置的端口，这样EXPOSE设置的端口号会被随机映射成宿主机器中的一个端口号。也可以指定需要映射到宿主机器的那个端口，这时要确保宿主机器上的端口号没有被使用。EXPOSE指令可以一次设置多个端口号，相应的运行容器的时候，可以配套的多次使用-p选项。格式:

EXPOSE <port> [<port>...]

# 映射一个端口;
EXPOSE port1

# 相应的运行容器使用的命令;
docker run -p port1 image

# 映射多个端口;
EXPOSE port1 port2 port3

# 相应的运行容器使用的命令;
docker run -p port1 -p port2 -p port3 image

# 还可以指定需要映射到宿主机器上的某个端口号;
docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image

端口映射是docker比较重要的一个功能，原因在于我们每次运行容器的时候容器的IP地址不能指定而是在桥接网卡的地址范围内随机生成的。宿主机器的IP地址是固定的，我们可以将容器的端口的映射到宿主机器上的一个端口，免去每次访问容器中的某个服务时都要查看容器的IP的地址。对于一个运行的容器，可以使用docker port加上容器中需要映射的端口和容器的ID来查看该端口号在宿主机器上的映射端口。

8）ENV

说明：用于设置环境变量

构建指令，在image中设置一个环境变量。格式:

ENV <key> <value>

假如你安装了JAVA程序，需要设置JAVA_HOME，那么可以在Dockerfile中这样写：设置了后，后续的RUN命令都可以使用，container启动后，可以通过docker inspect查看这个环境变量，也可以通过在docker run –env key=value时设置或修改环境变量。

ENV JAVA_HOME /path/to/java/dirent

9）ADD

说明：从src复制文件到container的dest路径

构建指令，所有拷贝到container中的文件和文件夹权限为0755，uid和gid为0；

如果是一个目录，那么会将该目录下的所有文件添加到container中，不包括目录；
如果文件是可识别的压缩格式，则docker会帮忙解压缩（注意压缩格式）；
如果<src>是文件且<dest>中不使用斜杠结束，则会将<dest>视为文件，<src>的内容会写入<dest>；
如果<src>是文件且<dest>中使用斜杠结束，则会<src>文件拷贝到<dest>目录下。

格式:

ADD <src> <dest>

<dest>：是container中的绝对路径。<src>：是相对被构建的源目录的相对路径，可以是文件或目录的路径，也可以是一个远程的文件url。

10）VOLUME

说明：指定挂载点

设置指令，使容器中的一个目录具有持久化存储数据的功能，该目录可以被容器本身使用，也可以共享给其他容器使用。我们知道容器使用的是AUFS，这种文件系统不能持久化数据，当容器关闭后，所有的更改都会丢失。当容器中的应用有持久化数据的需求时可以在Dockerfile中使用该指令。

格式:

VOLUME ["mountpoint"]

样例：

FROM base

VOLUME ["/tmp/data"]

运行通过该Dockerfile生成image的容器，/tmp/data目录中的数据在容器关闭后，里面的数据还存在。例如第二个容器也有持久化数据的需求，且想使用上面容器共享的/tmp/data目录，那么可以运行下面的命令启动一个容器：

# container1为第一个容器的ID，image2为第二个容器运行image的名字。
# 实现目标：image2 生成的 container2 将共享 container1 的 /tmp/data 目录
$ docker run -t -i -rm --volumes-from container1 image2 bash

11）WORKDIR

说明：切换目录（cd）

用于设置Dockerfile中的RUN、CMD和ENTRYPOINT指令执行命令的工作目录(默认为/目录)，该指令在Dockerfile文件中可以出现多次，如果使用相对路径则为相对于WORKDIR上一次的值，例如WORKDIR /data，WORKDIR logs，RUN pwd最终输出的当前目录是/data/logs。

格式:

WORKDIR /path/to/workdir

样例：

# 在/p1/p2下执行vim a.txt;

WORKDIR /p1
WORKDIR p2
RUN vim a.txt

12）ONBUILD

说明：在子镜像中执行

ONBUILD <Dockerfile关键字>

ONBUILD指令用来设置一些触发的指令，用于在当该镜像被作为基础镜像来创建其他镜像时(也就是Dockerfile中的FROM为当前镜像时)执行一些操作，ONBUILD中定义的指令会在用于生成其他镜像的Dockerfile文件的FROM指令之后被执行，上述介绍的任何一个指令都可以用于ONBUILD指令，可以用来执行一些因为环境而变化的操作，使镜像更加通用。

注意：
①ONBUILD中定义的指令在当前镜像的build中不会被执行。
②可以通过查看docker inspeat <image>命令执行结果的OnBuild键来查看某个镜像ONBUILD指令定义的内容。
③ONBUILD中定义的指令会当做引用该镜像的Dockerfile文件的FROM指令的一部分来执行，执行顺序会按ONBUILD定义的先后顺序执行，如果ONBUILD中定义的任何一个指令运行失败，则会使FROM指令中断并导致整个build失败，当所有的ONBUILD中定义的指令成功完成后，会按正常顺序继续执行build。
④ONBUILD中定义的指令不会继承到当前引用的镜像中，也就是当引用ONBUILD的镜像创建完成后将会清除所有引用的ONBUILD指令。
⑤ONBUILD指令不允许嵌套，例如ONBUILD ONBUILD ADD . /data是不允许的。
⑥ONBUILD指令不会执行其定义的FROM或MAINTAINER指令。