Dockerfile 指令详解

GitHub Page：https://blog.cloudli.top/posts/Dockerfile-指令详解/

FROM

FROM 命令指定基础镜像。在构建镜像时，基础镜像必须指定，所以在 Dockerfile 中 FROM 是必备指令且必须是第一条指令。

在 Docker Hub 上有不少经常使用的高质量官方镜像，有一些是应用和服务类的镜像，如 nginx、mysql、redis 等；也有一些是用于运行各类语言应用的镜像，如 openjdk、python、node 等。

若是找不到应用的官方镜像，能够基于操做系统镜像构建一个。Docker Hub 上提供了不少操做系统镜像。

FROM ubuntu
...

RUN

RUN 指令是用来执行命令行命令的。RUN 指令的格式有两种：

• shell 格式：RUN <命令>，就像直接在命令行中输入命令同样。

  RUN java -jar app.jar

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

  RUN ["java", "-jar", "app.jar"]

在 Dockerfile 中，每个指令都会在镜像上创建一层，因此对于多个命令行，不要写多个 RUN 指令。

对于多个命令，可使用这样的写法：

FROM ubuntu

RUN apt-get update \
    && apt-get install -y redis

对于多个命令，使用 && 链接起来，只用一个 RUN 指令执行，这样就只会构建一层。

COPY

COPY 指令用来将宿主的文件目录复制到镜像中。有两种格式：

• COPY [--chown=<user>:<group>] <源路径>... <目标路径>

  COPY app.jar /usr/src/

• COPY [--chown=<user>:<group>] ["源路径1", ... "目标路径"]

  COPY ["app.jar", "config.yml", "/usr/src"]

对于多个路径参数，最后一个为目标路径，其余都是源路径。目标路径 能够是绝对路径，也能够是相对于工做目录的路径（工做目录能够用 WORKDIR 来指定）。目标路径若是不存在，在复制文件前会先建立。

CMD

CMD 是容器启动命令，它指定了容器启动后要执行的程序。与 RUN 指令类似有两种形式：

• shell 格式：CMD <命令>

  CMD echo 'Hello, world!''

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

  CMD [ "sh", "-c", "echo 'Hello, world!'" ]

还有一种参数列表格式：CMD ["参数1", "参数2", ...]。在指定了 ENTRYPOINT 指令后，能够用 CMD 指定参数。

在使用 CMD 时，程序必须之前台运行，Docker 不是虚拟机，容器没有后台服务的概念。若是使用 CMD 运行一个后台程序，那么容器在命令执行完就会退出。

CMD java -jar app.jar &

以上命令让 app.jar 在后台运行，容器启动后就会马上退出。Docker 容器与守护线程很类似，当全部前台程序退出后，容器就会退出。

CMD 指定的命令能够在运行时替换，跟在镜像名称后面的参数将替换镜像中的 CMD。

docker run app echo $HOME

以上命令运行容器时使用 echo $HOME 替换掉镜像中的启动命令。

ENTRYPOINT

ENTRYPOINT 的格式与 CMD 同样有两种格式。

它和 CMD 同样都是指定容器启动的程序和参数，但稍有区别。当指定了 ENTRYPOINT 后，CMD 的内容将做为参数加到 ENTRYPOINT 后面。

也就是变成了：

<ENTRYPOINT> "<CMD>"

ENTRYPOINT 可让镜像像命令同样使用，当仅仅使用 CMD 时，run 命令中镜像名后面的参数会替换 CMD 的内容。使用 ENTRYPOINT 后，这些参数将附加到原来命令的后面。

FROM alpine
ENTRYPOINT [ "ls" ]

使用以上 Dockerfile 构建的镜像运行容器：

docker run app -al

-al 参数将附加到 ENTRYPOINT 指定的命令后面，当容器启动时执行的是 ls -al。

ENV

ENV 指令用来设置环境变量，格式有两种：

• ENV <key> <value
• ENV <key1>=<value1> <key2>=<value2>

环境变量在后面的其它指令中能够经过 $key 来使用：

FROM ubuntu
ENV VERSION="8-jre"

RUN apt-get update \
    && apt-get install -y openjdk-$VERSION
...

ARG

ARG 指令指定构建参数，与 ENV 效果同样，都是设置环境变量。不一样的是，ARG 设置的构建参数，在容器运行时不存在。

格式：ARG <key>[=<默认值>]，能够指定默认值，也能够不指定。

FROM alpine
ARG NAME="Hello, Docker!"

RUN echo $NAME
CMD echo $NAME

对于以上 Dockerfile，在构建时能够看到输出，可是在运行容器时没有输出。

ARG 设置的参数能够在构建命令中指定：docker build --build-arg <key>=<value>。

VOLUME

VOLUME 指令用来定义匿名卷。

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

对于数据库类须要保持数据的应用，其文件应该保存于卷（volume）中，在 Dockerfile 中，能够事先将指定的目录挂载为匿名卷。

VOLUME /data

这里 /data 目录在容器运行时自动挂载为匿名卷，任何写入 /data 中的数据都不会记录到容器的存储层。在运行时能够覆盖这个挂载设置：

docker run -v dbdir:/data

以上命令将 dbdir 目录挂载到了 /data，替换了 Dockerfile 中的挂载配置。

EXPOSE

EXPOSE 指令指定容器运行时暴露的端口。格式：EXPOSE <端口1> [<端口2> ...]。

FROM ubuntu
EXPOSE 8080

RUN apt-get update \
    && apt-get install -y tomcat8
...

以上 Dockerfile 安装了 tomcat 应用，在运行容器时会暴露 8080 端口。

EXPOSE 只是指定了容器暴露的端口，并不会在宿主机进行端口映射。在使用 docker run -P 时，会自动随机映射 EXPOSE 指定的端口，也可使用 -p 指定端口：docker run -p <宿主端口>:<容器端口>。

WORKDIR

WORKDIR 指令指定工做目录，即指定当前目录，相似于 cd 命令，之后各层的当前目录都是 WORKDIR 指定的目录。若是目录不存在，会自动建立。格式：WORKDIR <目录路径>。

不能把 Dockerfile 当成 Shell 脚原本写：

RUN cd /src/app
RUN java -jar app.jar

以上操做中第二行的工做目录并非 /src/app，两个指令不在同一层，第一个 RUN 指令的 cd 操做和第二个没有任何关系。所以要切换目录，应该使用 WORKDIR 来指定。

USER

USER 指令指定当前用户。与 WORKDIR 类似，会影响之后的层。USER 改变执行 RUN、CMD 和 ENTRYPOINT 的用户。格式：USER <用户名>[:<用户组>]。

USER 指定的用户和组必须是事先建立好的，不然没法切换。

# 添加用户
RUN groupadd -r redis \
    && useradd -r -g redis redis
USER redis
ENTRYPOINT ["reids-server"]

ONBUILD

ONBUILD 指令后面跟的是其它指令，它在当前镜像构建时不会被执行，只有以当前镜像为基础镜像去构建下一级镜像时才会被执行。格式：ONBUILD <其它指令>。

FROM openjdk:8-jre-alpine
WORKDIR /app
ONBUILD COPY ./app.jar /app
...

这个 Dockerfile 在构建时不会执行 ONBUILD。

FROM my-jre
...

假设以前构建的镜像名是 my-jre，以上 Dockerfile 构建镜像时，原来的 ONBUILD 将执行。