Dockfile是一种被Docker程序解释的脚本，Dockerfile由一条一条的指令组成，每条指令对应Linux下面的一条命令。Docker程序将这些Dockerfile指令翻译真正的Linux命令。Dockerfile有自己书写格式和支持的命令，Docker程序解决这些命令间的依赖关系，类似于Makefile。Docker程序将读取Dockerfile，根据指令生成定制的image。相比image这种黑盒子，Dockerfile这种显而易见的脚本更容易被使用者接受，它明确的表明image是怎么产生的。有了Dockerfile，当我们需要定制额外的需求时，只需Dockerfile上添加或者修改指令，重新生成image即可，省去了敲命令的麻烦。
Dockerfile的书写规则和指令的使用方法
# 注释
INSTRUCTION argument - 1
- 2
指令忽略大小写，建议使用大写；每一行只支持一条指令，每条指令可以携带多个参数。Dockerfile的指令根据作用可以分为两种：构建指令和设置指令。
构建指令（用于构建镜像，其指定的操作不会在由镜像运行的容器上执行）
（1） FROM（指定基础镜像）
FROM必须是第一条非注释指令，它指定基础镜像且指定的镜像是已存在的。
格式：
FROM <image> # 指定基础镜像
FROM <image>:<tag> # 指定一个tag版本的基础镜像- 1
- 2
- 3
例子：
FROM ubuntu:14.04- 1
（2）MAINTAINER（指定镜像创建者信息）
指定镜像的作者和联系方式信息。
格式：
MAINTAINER <author> "e-mail" # 指定作者名和E-mail- 1
例子：
MAINTAINER locutus "[email protected]"
# 执行 #docker inspect image，输出中有相应的字段记录该信息- 1
- 2
- 3
（3）RUN（安装软件用）
RUN可以运行任何被基础镜像支持的命令。如基础镜像选择了ubuntu，那么软件管理部分只能使用ubuntu的命令。
格式：
RUN <command>
# shell模式，以#/bin/sh -c command 形式执行, 如RUN echo hello
RUN ["executable", "param1", "param2" ... ]
# exec模式，指定其他形式的shell来运行指令 ,如RUN ["/bin/bash" ,“-c”,“echo hello" ]- 1
- 2
- 3
- 4
- 5
- 6
- 7
例子：
RUN apt-get update && apt-get install -y nginx # 合并执行命令- 1
（4）ENV（用于设置环境变量）
在镜像中设置一个环境变量。
格式:
ENV <key> <value>
# 设置后，后续RUN命令都可使用环境变量所输出的指令，容器启动ENV <key>=<value>后，通过#docker inspect查看环境变量，也可以通过 # docker run --env key=value设置或修改环境变量。 - 1
- 2
- 3
例子：
ENV JAVA_HOME /path/to/java/dirent
# 在容器中安装JAVA程序，设置JAVA_HOME- 1
- 2
- 3
（5）ADD COPY（将本地文件或目录复制到由dockerfile构建的镜像中）
所有拷贝到container中的文件和文件夹权限为0755，uid和gid为0；如果是一个目录，那么会将该目录下的所 有文件拷贝到目录下，不包括目录；如果是文件且中不使用斜杠结束，则会将视为文件，的内容会写入；如果是文件且中使用斜杠结束，则会文件拷贝到目录下。
格式:
ADD <src> <dest>
# <src>可以是文件或目录的本地地址（即Dockerfile所在目录的相对路径），也可以是一个远程的url（docker不推荐，更建议使用wget或curl获取文件）; <dest>是镜像中的绝对路径
ADD ["<src>" "<dest>"]
# 适用于文件路径中有空格的情况，同理有COPY的情况
COPY <src> <dest>
COPY ["<src>" "<dest>"] - 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
ADD与COPY的区别：ADD指令包含类似tar的解压功能，而COPY只单纯复制文件。
例子 ：
# vim index.html # 编辑一个index.html文件
<html>
<head>
<title>Page Added in Dockerfile</title>
</head>
<body>
<h1>I'm page in nginx_test1</h1>
</body>
</html>
# 在Dockfile中写下
COPY index.html /usr/share/nginx/html/
# copy Dockerfile所在目录的文件到容器的绝对路径下，使用docker build 指令后，运行容器，查看端口映射，并# curl http：//127.0.0.1：host_port 可以看到index.html的内容 - 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
设置指令（用于设置image的属性，其指定的操作将在由image运行的容器中执行）
（6）CMD（提供容器运行的默认命令）
提供容器运行的默认命令。与RUN类似，但RUN指定的命令是在容器构建过程中运行，而CMD指定的命令是在容器运行过程中运行。该指令只能在文件中存在一次，如果有多个，则只执行最后一条。
格式：
CMD ["executable","param1","param2"] # exec模式
CMD command param1 param2 # shell模式
CMD ["param1","param2"]
# 当Dockerfile指定了ENTRYPOINT时使用，其作为ENTRYPOINT指令的默认参数 - 1
- 2
- 3
- 4
- 5
- 6
- 7
例子：
# docker run --name test -d repository cmd //构建容器中的CMD指令被run的cmd覆盖，不会执行
# docker run --name test -d repository //执行构建容器中的CMD指令- 1
- 2
- 3
（7）ENTRYPOINT（提供容器运行的默认命令）
指定容器运行时执行的命令，可以多次设置，但是只有最后一个有效。
格式:
ENTRYPOINT ["executable", "param1", "param2"]
# exec模式
ENTRYPOINT command param1 param2
# shell模式 - 1
- 2
- 3
- 4
- 5
- 6
- 7
例子：
该指令的使用分为两种情况，一种是独自使用，另一种和CMD指令配合使用。
a. 当独自使用时，如果你还使用了CMD命令且CMD是一个完整的可执行的命令，那CMD指令和ENTRYPOINT会互相覆盖，只有最后一个CMD或者ENTRYPOINT有效。构建容器中的ENTRYPOINT指令不会被run的cmd覆盖，ENTRYPOINT指令仍会执行。
CMD echo “Hello, World!”
ENTRYPOINT ls -l
# CMD指令将不会被执行，只有ENTRYPOINT指令被执行- 1
- 2
- 3
- 4
- 5
b. 与CMD指令配合使用来指定ENTRYPOINT的默认参数。ENTRYPOINT指令只能使用exec模式，指定执行命令，而不能指定参数；CMD指令不是一个完整的可执行命令，仅仅是参数部分。
在Dockerfile中，写如下内容：
FROM ubuntu
ENTRYPOINT ["/usr/bin/nginx"]
CMD ["-h"] - 1
- 2
- 3
- 4
- 5
在命令行中，执行以下命令
# docker build -t="locutus1/nginx" . # 构建docker镜像
# docker run -p 80 --name nginx_test2 -d locutus1/nginx -g "daemon off;"
# docker ps -l - 1
- 2
- 3
- 4
- 5
命令# docker run 的-g “daemon off;” 指令将CMD中的-h指令覆盖。
（8）USER（设置container容器的用户）
设置启动容器的用户，默认是root用户。
格式：
USER user
USER uid
USER user：group
USER uid：gid
USER user：gid
USER uid：group - 1
- 2
- 3
- 4
- 5
- 6
例子：
ENTRYPOINT ["memcached"] # 指定指令memcached的运行用户为daemon
USER daemon
或
ENTRYPOINT ["memcached", "-u", "daemon"] - 1
- 2
- 3
- 4
- 5
- 6
（9）EXPOSE（指定容器需要映射到宿主机的端口）
该指令会将容器中的端口映射成宿主机中的某个端口。当你需要访问容器的时候，可以不使用容器的IP地址而是使用宿主机的IP地址和映射后的宿主机端口。要完成整个操作需要两个步骤：
1. 在Dockerfile使用EXPOSE设置需要映射的容器端口
2. 在运行容器的时候指定-p选项和EXPOSE设置的端口，这样EXPOSE设置的端口号会被随机映射成宿主机器中的一个端口号。
格式:
EXPOSE <port> [<port>...] - 1
例子：
EXPOSE port1 // 映射一个端口
# docker run -p port1 image // 运行容器使用的相应命令 - 1
- 2
- 3
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 port port1 containerID
//对于一个运行的容器，可以使用docker port加上容器中需要映射的端口和容器的ID来查看该端口号在宿主机器上的映射端口- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
端口映射是docker比较重要的一个功能，原因在于我们每次运行容器时容器IP地址不能指定而是在桥接网卡的地址范围内随机生成的。宿主机器的IP地址是固定的，我们可以将容器的端口的映射到宿主机的一个端口，免去每次访问容器中的某个服务时都要查看容器的IP的地址。
（10）VOLUME（指定挂载点）
使容器中的一个目录具有持久化存储数据的功能，该目录可以被容器本身使用，也可以共享给其他容器使用。我们知道容器使用的是AUFS，这种文件系统不能持久化数据，当容器关闭后，所有的更改都会丢失。当容器中的应用有持久化数据的需求时，可以在Dockerfile中使用该指令。
格式:
VOLUME ["<mountpoint>"] - 1
例子：
VOLUME ["/tmp/data"] - 1
运行通过该Dockerfile构建镜像的容器，/tmp/data目录中的数据在容器关闭后，里面的数据还存在。
如果另一个容器也有持久化数据的需求，且想使用上述容器共享的/tmp/data目录，那么可以运行下面的命令启动一个容器。
# docker run -it -rm -volumes-from container1 image2 /bin/bash
//container1为第一个容器的ID，image2为第二个容器运行image的名字。 - 1
- 2
- 3
（11）WORKDIR（切换目录）
可以多次切换(相当于cd命令)，对RUN，CMD，ENTRYPOINT生效。
格式:
WORKDIR /path/to/workdir
// 一定要使用绝对路径，如果使用相对路径，那么路径会传递下去
WORKDIR a
WORKDIR b
WORKDIR c
// 相当于#cd /a/b/c - 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
例子：在Dockerfile中写入以下
WORKDIR /path/to/p1
WORKDIR p2
RUN vim a.txt
// 在/p1/p2下，执行# vim a.txt - 1
- 2
- 3
- 4
- 5
（12）ONBUILD（镜像触发器）
当一个镜像被其他镜像作为基础镜像执行时，新的镜像会在构建过程中插入ONBUILD触发器中的指令
格式：
ONBUILD <Dockerfile关键字>
// ONBUILD指定的命令在由Dockerfile构建原镜像时并不执行，而是在由原镜像被其他镜像作为基础镜像构建时执行 - 1
- 2
- 3
例子：
# vim Dockerfile
...
ONBUILD COPY index.html /usr/share/nginx/html/
...
# docker build -t="locutus1/nginx4" . //构建原镜像locutus1/nginx4
# docker run -p 81 --name nginx4 locutus1/nginx4
# curl http://127.0.0.1:host_port
// 依旧是原来nginx的内容，说明在构建时虽然显示，但没有 执行 ONBUILD COPY index.html /usr/share/nginx/html/
# vim Dockerfile
FROM locutus1/nginx4
// 原镜像locutus1/nginx4作为locutus1/nginx5的基础镜像
...
# docker build -t="locutus1/nginx5" .
//在step0后，执行了触发器的指令COPY
# docker run -p 82 --name nginx4 locutus1/nginx5
# curl http://127.0.0.1:host_port
//是COPY指令所复制的index.html的内容了