Dockerfile指令详解

ADD 复制文件

ADD指令用于复制文件，格式为：

ADD <src>... <dest>
ADD ["<src>",... "<dest>"]

从src目录复制文件到容器的dest。其中src可以是Dockerfile所在目录的相对路径，也可以是一个URL，还可以是一个压缩包

注意：

① src必须在构建的上下文内，不能使用例如：ADD ../somethine /something 这样的命令，因为docker build 命令首先会将上下文路径和其子目录发送到docker daemon。

② 如果src是一个URL，同时dest不以斜杠结尾，dest将会被视为文件，src对应内容文件将会被下载到dest。

③ 如果src是一个URL，同时dest以斜杠结尾，dest将被视为目录，src对应内容将会被下载到dest目录。

④ 如果src是一个目录，那么整个目录下的内容将会被拷贝，包括文件系统元数据。

⑤ 如果文件是可识别的压缩包格式，则docker会自动解压。

示例：

java 复制代码

ADD target/admin.jar app.jar

ARG 设置构建参数

ARG指令用于设置构建参数，类似于ENV。和ARG不同的是，ARG设置的是构建时的环境变量，在容器运行时是不会存在这些变量的。

ARG <name>[=<default value>]

ini 复制代码

ARG user1=someuser

CMD 容器启动命令

CMD指令用于为执行容器提供默认值。每个Dockerfile只有一个CMD命令，如果指定了多个CMD命令，那么只有最后一条会被执行，如果启动容器的时候指定了运行的命令，则会覆盖掉CMD指定的命令。

支持三种格式：

CMD ["executable","param1","param2"] (推荐使用)

CMD ["param1","param2"] (为ENTRYPOINT指令提供预设参数)

CMD command param1 param2 (在shell中执行)

示例：CMD echo "This is a test."

COPY 复制文件

复制文件，格式为：

COPY <src>... <dest>
COPY ["<src>",... "<dest>"]

复制本地端的src到容器的dest。COPY指令和ADD指令类似，COPY不支持URL和压缩包。

ENTRYPOINT 入口点

格式为：

ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2

ENTRYPOINT和CMD指令的目的一样，都是指定Docker容器启动时执行的命令，可多次设置，但只有最后一个有效。ENTRYPOINT不可被重写覆盖。

ENTRYPOINT、CMD区别

ENTRYPOINT，表示镜像在初始化时需要执行的命令，不可被重写覆盖，需谨记
CMD，表示镜像运行默认参数，可被重写覆盖
ENTRYPOINT/CMD都只能在文件中存在一次，并且最后一个生效多个存在，只有最后一个生效，其它无效！
需要初始化运行多个命令，彼此之间可以使用 && 隔开，但最后一个须要为无限运行的命令，需切记！

ENV 设置环境变量

ENV指令用于设置环境变量，格式为：

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

示例：ENV JAVA_HOME /path/to/java

EXPOSE 声明暴露的端口

EXPOSE指令用于声明在运行时容器提供服务的端口，格式为：

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

需要注意的是，这只是一个声明，运行时并不会因为该声明就打开相应端口。该指令的作用主要是帮助镜像使用者理解该镜像服务的守护端口；其次是当运行时使用随机映射时，会自动映射EXPOSE的端口。示例：

java 复制代码

# 声明暴露一个端口示例
EXPOSE port1
# 相应的运行容器使用的命令
docker run -p port1 image
# 也可使用-P选项启动
docker run -P 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

FROM 指定基础镜像

使用FROM指令指定基础镜像，FROM指令有点像Java里面的"extends"关键字。需要注意的是，FROM指令必须指定且需要写在其他指令之前。FROM指令后的所有指令都依赖于该指令所指定的镜像。

支持三种格式：

FROM <image>
FROM <image>:<tag>
FROM <image>@<digest>

LABEL 为镜像添加元数据

LABEL指令用于为镜像添加元数据。

格式为：

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

使用 """和"\"转换命令行，示例：

java 复制代码

LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo"
LABEL version="1.0"
LABEL description="This text illustrates \
that label-values can span multiple lines."

MAINTAINER 指定维护者的信息（已过时）

MAINTAINER指令用于指定维护者的信息，用于为Dockerfile署名。

格式为：

MAINTAINER <name>

示例：

MAINTAINER woniu

注：该指令已过时，建议使用如下形式：

ini 复制代码

LABEL maintainer="woniu@home.org.au"

RUN 执行命令

该指令支持两种格式：

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

RUN <command> 在shell终端中运行，在Linux中默认是/bin/sh -c ，在Windows中是 cmd /s /c ，使用这种格式，就像直接在命令行中输入命令一样。 RUN ["executable", "param1", "param2"] 使用exec执行，这种方式类似于函数调用。指定其他终端可以通过该方式操作，例如：RUN ["/bin/bash", "-c", "echo hello"] ，该方式必须使用双引号["]而不能使用单引号[']，因为该方式会被转换成一个JSON 数组。

USER 设置用户

该指令用于设置启动镜像时的用户或者UID，写在该指令后的RUN、CMD以及ENTRYPOINT指令都将使用该用户执行命令。

格式为：

USER 用户名

示例：

sql 复制代码

USER daemon

VOLUME 指定挂载点

该指令使容器中的一个目录具有持久化存储的功能，该目录可被容器本身使用，也可共享给其他容器。当容器中的应用有持久化数据的需求时可以在Dockerfile中使用该指令。格式为：

VOLUME ["/data"]

示例：

bash 复制代码

VOLUME /data

使用示例：

bash 复制代码

FROM nginx
VOLUME /tmp

当该Dockerfile被构建成镜像后，/tmp目录中的数据即使容器关闭也依然存在。如果另一个容器也有持久化的需求，并且想使用以上容器/tmp目录中的内容，则可使用如下命令启动容器：

csharp 复制代码

docker run -volume-from 容器ID 镜像名称  # 容器ID是di一个容器的ID，镜像是第二个容器所使用的镜像。

WORKDIR 指定工作目录

格式为：

WORKDIR /path/to/workdir

切换目录指令，类似于cd命令，写在该指令后的RUN，CMD以及ENTRYPOINT指令都将该目录作为当前目录，并执行相应的命令。

一Dockerfile指令详解

Dockerfile指令详解

ADD 复制文件

ARG 设置构建参数

CMD 容器启动命令

COPY 复制文件

ENTRYPOINT 入口点

ENTRYPOINT、CMD区别

ENV 设置环境变量

EXPOSE 声明暴露的端口

FROM 指定基础镜像

LABEL 为镜像添加元数据

MAINTAINER 指定维护者的信息（已过时）

RUN 执行命令

USER 设置用户

VOLUME 指定挂载点

WORKDIR 指定工作目录