Dockerfile指令介绍

FROM:指定基础镜像

在Dockerfile中FROM是必备的指令，用于指定基础的镜像。

FROM centos:latest

LABEL:指定镜像标签

LABEL指令用来指定镜像的标签。

格式：

 LABEL <key>=<value> <key>=<value>...

例子：

LABEL author="jiajiezhao"

RUN: 执行命令

RUN指令是用于来执行命令行命令的。

格式：

shell格式： RUN <命令>

RUN echo '<h1>hello,world!<h1>' >/usr/share/nginx/html/index.html

exec格式： RUN ["可执行文件","参数1","参数2"]

COPY：复制指令

COPY指令将从构建上下文目录中<源路径>的文件/目录复制到新的一层镜像内<目标路径>位置。

源路径可以是多个，也可以是通配符。目标路径可以是绝对路径，当然也可以是相对于WORKDIR指定的目录的相对路径。目标路径不需要事先创建，如何目录不存在会在复制文件前自动创建。

格式：

COPY <源路径> ... <目标路径>

COPY ["<源路径",..."<目标路径>"]

注意：使用COPY 指令，源文件的各种元数据都会保留，如读写执行权限等。

COPY home*  /mydir/

COPY  index.html /mydir/

ADD:高级复制文件

ADD和COPY的格式一样，但是在COPY上增加了一些高级功能，如源路径可以是一个URL，下载后的文件权限自动设置为600，源路径也可以是一个压缩包，docker会自动帮你解压。但是其行为并不清晰，还不如使用COPY命令。

注意：此功能并不实用，不推荐实用。ADD指令会使得镜像构建的缓存失效，从而使镜像构建变得比较缓慢。

CMD：容器启动命令

CMD指令格式和RUN指令相似

shell格式：CMD <cmd>

exec格式：CMD ["可执行文件","参数1","参数2",...]

参数列表格式：CMD ["参数1","参数2"...]，在指定了`ENTRYPOINT`指令后，用CMD指定具体的参数。

docker不是虚拟机，容器就是进程，既然是进程，在启动容器的时候，就需要指定所运行的程序及其参数，CMD指令就是用于指定默认的容器主进程的启动命令的。

在运行时可以指定新的命令来替代镜像中设置的这个默认命令。如：

docker run -it ubuntu cat /etc/os-release

此时就是使用cat命令替换了默认的/bin/bash命令，输出了系统版本信息。

一般推荐使用exec格式命令，这类格式在解析时会被解析成JSON数组，一定要使用双引号，而不要使用单引号。

如何使用shell格式的话，实际命令会被包装成sh -c参数的形式进行执行。如

CMD echo $HOME

实际为：

CMD [ "sh","-c","echo $HOME"]

使用环境变量会被shell进行解析出来。

ENTRYPOINT：入口点

ENTRYPOINT格式和RUN指令格式一样，分为exec格式和shell格式，该指令的目的和CMD一样，都是指定容器启动程序及其参数。ENTRYPOINT在运行时也可以被替代，但是需要通过docker run参数 --entrypoint来指定。

当指定了ENTRYPOINT后，CMD的含义就发生了改变，不再是直接运行的命令，而是将CMD的内容作为参数传给ENTRYPOINT指令。如变为：

<ENTRYPOINT> "<CMD>"

这样就可以直接在docker run 后面指定参数传给ENTERYPOINT。

ENV：设置环境变量

格式：

ENV <key> <value>

ENV <key1>=<value1> <key2>=<value2> ...

该指令用来设置环境变量，为其后面运行的指令直接指定环境变量。如：

ENV NODE_VERSION 7.2.0

RUN curl -SLO "https://nodejs.org/dist/$NODE_VERSION-linux-x64.tar.gz"

支持环境变量的指令：

ADD COPY ENV EXPOSE LABEL USER WORKDIR VOLUME STOPSIGNAL ONBUILD

ARG：构建参数

格式： ARG <参数名>[=<默认值>]

构建参数和ENV的效果一样，都是设置环境变量。不同的是，ARG所设置的环境变量，在将来容器运行时是不会存在这些环境变量的。

Dockerfile中的ARG指令用来定义参数名称，以及定义默认值，该默认值可以在构建命令docker build中的--build-arg <参数名>=<值>来覆盖。

VOLUME:定义匿名卷

格式：

VOLUME ["<路径1>","<路径2>"...]

VOLUME <路径>

容器在运行时应该尽量保持容器存储层不发生写操作，对于数据库等应用的数据文件应保持于卷中。在Dockerfile中，可以事先指定某些目录挂载为匿名卷，这样在运行时如果用户不指定挂载，其运用也可以正常运行，不会向容器存储层中写入大量数据。如：

VOLUME /data

这里的/data目录就会在容器运行时自动挂载为匿名卷，任何向/data中写入的信息都不会记录进容器存储层里，从而保证容器的存储层无状态化。

当然在运行时，也可以覆盖这个挂载设置如：

docker run -d -v mydata:/data xxx

此命令使用mydata这个命名卷挂载到了/data这个位置，替换了Dockerfile中定义的匿名卷的挂载配置。

EXPOSE：声明端口

格式：

EXPOSE <端口1>  [<端口2>...]

EXPOSE指令是声明容器运行时提供的端口，这只是一个声明，在运行时并不会因为这个声明应用就会开启这个端口的服务。

声明端口的好处：

帮助镜像使用者理解这个镜像服务的守护端口，以方便映射
在运行时使用随机端口映射，即docker run -P时，会自动映射EXPOSE的端口

WORKDIR：指定工作目录

格式为：

WORKDIR <工作目录路径>

使用此指令来指定工作目录，以后在各层的当前目录就会被改为指定的目录。该目录必须是已经存在的目录，WORKDIR并不会帮你建立该目录。

USER:指定当前用户

格式：

USER <用户名>

USER指令和WORKDIR相似，都是改变环境状态并影响以后的层。WORKDIR是改变工作目录，USER则是改变以后各层执行命令的身份。

该用户必须是事先建立好的，否则无法切换。如：

RUN  groupadd -r www && useradd -r -g www www

USER www

RUN ["XXX"]

HEALTHCHECK：健康检查

格式：

HEALTHCHECK [选项] CMD <命令> :设置检查容器健康状况的命令

HEALTHCHECK NONE:如何基础镜像有健康检查指令，使用这行可以屏蔽掉这个健康检查指令。

该指令是告诉Docker应该如何进行判断容器的状态是否正常。

当一个镜像指定了HEALTHCHECK指令后，其启动容器，初始状态变为starting,在HEALTHCHECK指令检查成功后变为healthy，如何连续一定的次数失败，就会变成unhealthy。

HEALTHCHECK选项：

--interval=<间隔>:两次健康检查的间隔，默认是30秒
--timeouot=<时长>:健康检查命令运行的超时时间，如何超过这个时间就会认为失败。默认30s
--retries=<次数>:当连续失败指定的次数后，容器状态视为unhealthy。默认3次

HEALTHCHECK exit code:

0 成功

1 失败

2 保留

例子：

HEALTHCHECK --interval=5s --timeout=3m \

        CMD curl -fs http://localhost/ || exit 1

这里使用3分钟检查一次，如何健康检查命令超过3秒没有反应就会视为失败。

ONBUILD: 触发器

格式：

ONBUILD <其他指令>

ONBUILD是一个特殊的指令，其后面接的是其他指令，如RUN,COPY等。这些指令在构建当前镜像是不会执行，只有以当前镜像为基础镜像，去构建下一级镜像的时候才会被执行。

容器中的应用在前台和后台执行的问题：

Docker不是虚拟机，容器中的应用都应该以前台执行，而不是像虚拟机和物理机一样，可以使用systemd去启动后台服务，容器内没有后台服务的概念。对于容器而言，其启动的程序就是容器应用进程，容器是为了主进程而存在的，主进程退出，容器就失去了存在的意义，从而退出，其他辅助进程不是它需要关心的。正确做法是直接执行可执行文件，并且要求以前台形式存在。如

CMD ["nginx","-g","daemon off"]