Dockerfile常用指令

在编写Dockerfile脚本文件时，开发者根据实际需要会使用到各种指令，如FROM、CMD、ADD等，这些常用指令及其说明如表1所示。

表1 Dockerfile常用指令

在表1中，列举了Dockerfile文件中的一些常用指令，并分别对其作用进行了简要说明。为了帮助读者更好的掌握这些指令的使用，接下来将对这些常用指令的使用进行详细讲解。

1．FROM

FROM指令用于初始化一个新的镜像构建阶段，同时为之后的指令设置一个基础镜像。设定的基础镜像可以从DockerHub镜像注册中心或者本地镜像列表选取，当本地镜像列表中存在设定的镜像就会直接使用本地镜像，否则会先从远程镜像注册中心拉取到本地再使用。

FROM指令使用的语法格式如下。

FROM <image>
FROM <image>:<tag>

具体示例如下。

FROM ubuntu
FROM ubuntu：16.04

在使用FROM指令时，需要注意以下几点。

● 一个有效的Dockerfile文件必须以FROM指令开头（除了ARG指令）；

● 为了创建多重镜像或者互相依赖的镜像，在同一个Dockerfile文件中可能会出现多个FROM指令；

● <tag>参数是可选的，其作用主要是进一步对镜像区分，例如版本、型号等（如上述示例中的ubuntu：16.04就表示版本号为16.04的ubuntu）。如果没有使用该参数，则默认是latest；如果设置的<tag>参数不存在，则构建镜像也会失败。

2．MAINTAINER

MAINTAINER指令用于指定当前构建的镜像维护者信息，该指令没有具体的格式要求，通常建议使用用户名和邮箱进行标识，具体示例如下。

MAINTAINER "shitou"<shitou@163.com>

3．RUN

RUN指令用于执行指定的脚本命令，有两种格式，其语法格式如下。

RUN <command>  
RUN ["executable", "param1", "param2"]

前者将在 shell 终端中运行命令，即 /bin/sh -c；后者则使用 exec 执行。指定使用其他终端可以通过第二种方式实现，例如 RUN ["/bin/bash", "-c", "echo hello"]。

其中每条 RUN 指令将在当前镜像基础上执行指定命令，并提交为新的镜像。如果要执行多条RUN指令，通常会将多条RUN指令合成一条，并使用斜杠“\” 来换行，这样将减小所构建的镜像的体积。

4．CMD

CMD指令用于指定启动容器时执行的命令，该指令有三种格式，其语法格式如下。

CMD ["executable","param1","param2"]  #使用 exec 执行，也是推荐方式；
CMD command param1 param2    #在 /bin/sh 中执行，提供给需要交互的应用；
CMD ["param1","param2"]   #提供给 ENTRYPOINT 的默认参数；

需要注意的是，在使用CMD指令时，每个 Dockerfile 只能有一条 CMD 指令，如果有多条CMD指令，则只有最后一条生效。如果用户启动容器时指定了运行的指令，则会覆盖掉CMD指定的指令。

5．EXPOSE

EXPOSE指令用于声明容器内部暴露的端口号，供容器访问连接使用，其语法格式如下。

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

6．ENV

ENV指令用于为下文设定一个环境变量，该变量值在后续指令或内联文件中都可以使用。ENV指令有两种语法格式，具体如下。

ENV <key> <value>
ENV <key>=<value> <key>=<value> ...

在上述两种语法格式中，第一种格式为一个属性设置唯一的属性值，<key>属性第一个空格之后的所有字符串（包括空格、引号）都将被视为该属性的值；第二种格式允许同时为多个属性赋值，而这种方式里面的引号、反斜杠等将被解析掉。

7．ADD

ADD指令用于复制指定的 src资源文件到容器中的 dest目录下，复制的资源可以是文件、目录以及远程URLs资源。其语法格式如下。

ADD <src>... <dest>

在使用ADD指令时，复制的src资源文件必须是当前上下文目录或其子目录，而复制的内容实际上是该目录下的所有内容，其中包括文件系统元数据，而目录本身不会被复制。当dest目录不存在时，会在复制文件时自动创建。需要注意的是，当使用ADD指令复制的文件是一个压缩包时，ADD指令会在复制好该文件后，自动进行解压。

在使用ADD指令时，复制的src资源文件路径允许使用通配符，而dest目标目录可以使用绝对路径，也可以使用预先用WORKDIR指令定义的相对路径。

8．COPY

COPY指令的作用与ADD指令类似，都是复制指定的src资源文件到容器中的 dest目录下。区别在于，COPY指令不能复制远程URL路径文件，也不能解压文件，而ADD指令则可以。其语法格式如下。

COPY <src>... <dest>

9．ENTRYPOINT

ENTRYPOINT指令是配置容器启动后执行的命令，每个Dockerfile中只能有一个ENTRYPOINT，当指定多个ENTRYPOINT指令时，只有最后一个生效。该指令有两种语法格式，其语法格式如下。

ENTRYPOINT ["executable", "param1", "param2"] (exec 格式, 推荐的)
ENTRYPOINT command param1 param2 (shell 格式)

10．WORKDIR

WORKDIR指令用于为后续的指令（如RUN、CMD、ENTRYPOINT、COPY、ADD）指定工作目录，在同一个Dockerfile文件中可以多次使用WORKDIR指令，其语法格式如下。

WORKDIR /path/to/workdir

至此，关于Dockerfile文件中的常用指令已介绍完毕，读者可以根据自身实际情况选取使用。Dockerfile的更多指令可以参考Dockerfile官网学习，具体地址为https://docs.docker.com/engine/reference/builder/#arg。