Docker - Dockerfile之ENV、ENTRYPOINT、VOLUME、ONBUILD、STOPSIGNAL指令详解

谁践踏了优雅 2022-12-29 00:07 250阅读 0赞

## Docker - Dockerfile之ENV、ENTRYPOINT、VOLUME、ONBUILD、STOPSIGNAL指令详解 ##

## ENV ##

ENV指令用以定义镜像的环境变量。

**格式**

*  `ENV <key>=<value> ...`。
 *  `ENV <key> <value>`。

该ENV指令将环境变量`<key>`设置为值`<value>`。此值可以在构建阶段的所有后续指令中使用。

例如：

FROM ubuntu
    ENV INDEX=index
    RUN apt-get update && apt-get install -y curl && curl http://127.0.0.1:8080/$MODE && rm -rf /var/lib/apt/lists/*

如果你要设置多个环境变量，为了美观，你可以使用`\`来进行换行。多个环境变量也可以使用空格进行隔开，如果某个环境变量的值是由一组英文单词构成，那么你可以使用`""`将其圈起来。

例如：

ENV INDEX=index USER=root \
        TITLE="this is kaven's blog"

ARG指令和ENV指令的作用很相似，但是每个指令存在就肯定有它的原因。这两个指令都是设置环境变量。与ENV指令不同的是，ARG指令设置的环境变量只是在镜像构建时使用，在将来容器运行时是不会存在这些环境变量的。由最终镜像创建并且运行容器时，使用ENV指令设置的环境变量将被保留，可以使用`docker inspect`命令查看它们的值，或者使用`docker run --env <key> = <value>`命令更改它们的值。

如果仅在镜像构建过程中需要使用该环境变量，而在最终镜像中或者说由该镜像（最终镜像）创建的容器中已经不再需要该环境变量，就可以使用ARG指令，否则使用ENV指令，这样可以使得最终镜像足够**干净**。

**作用的时机**

*  ARG指令设置的环境变量是在构建镜像的时候使用（它不会保留在最终镜像中）。
 *  ENV指令设置的环境变量一般是容器运行的时候使用（它会保留在最终镜像中）。

## ENTRYPOINT ##

**格式**

1.  `ENTRYPOINT ["executable", "param1", "param2"]`。
2.  `ENTRYPOINT command param1 param2`。

ENTRYPOINT指令与CMD指令非常类似，`Dockerfile`中也只允许有一个ENTRYPOINT指令，有多个ENTRYPOINT指令时，只会执行最后的ENTRYPOINT指令。在`docker run`命令中使用了`--entrypoint`选项时，会覆盖`Dockerfile`中的ENTRYPOINT指令设置的内容。

当使用了ENTRYPOINT指令时，CMD指令的性质将会发生改变：CMD指令中的内容将会以参数形式传递给ENTRYPOINT指令，如下：

FROM ubuntu
    ENTRYPOINT ["rm", "docker"]
    CMD ["-rf"]

其实，它真正执行的命令将会是：

rm docker -rf

## VOLUME ##

VOLUME指令用于构建镜像时指定挂载点。

**格式**

*  `VOLUME ["/data"]`。

容器是基于镜像创建的，容器的文件系统包括镜像的只读层+镜像上面的可写层，容器中新产生的数据都是保存在镜像上面的可写层。一旦容器删除后，这些数据就没了，除非我们人工备份下来（或者基于当前容器创建新的镜像）。能否让容器新产生的数据保存在主机上呢？这样即使容器删除了，数据在主机上还有备份，这就需要在容器中指定挂载点了 ：[Docker - Docker数据持久化][Docker - Docker]。

通过`Dockerfile`的VOLUME指令可以在镜像中定义挂载点，这样只要通过该镜像创建的容器都有了挂载点。

通过VOLUME指令定义的挂载点，无法指定主机上对应的目录，当有新容器基于该镜像被创建时，新容器中的挂载点对应的主机目录，其实就是由Docker自动生成的数据卷的`_data`目录，由Docker自动生成的数据卷的名称一般如下图红框中的数据卷名称类似。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM3OTYwNjAz_size_16_color_FFFFFF_t_70]

定义一个挂载点：

FROM java:8
    VOLUME /java

定义多个挂载点：

FROM java:8
    VOLUME ["/java", "/classpath"]

这里的`/java`和`/classpath`目录在容器运行时会自动生成并且挂载到主机上的某个目录（Docker维护的数据卷）。给容器挂载数据卷可以在`docker run`命令中使用`-v`选项来实现。

[root@izoq008ryseuupz ~]# docker run -v /data --name java_8 java:8
    [root@izoq008ryseuupz ~]# docker inspect java_8

"Mounts": [
                { 
                    "Type": "volume",
                    "Name": "cb954c7b65c7b249ef81154622bb7ebc41c07d508b139d0ab231be4500a4dcbb",
                    "Source": "/var/lib/docker/volumes/cb954c7b65c7b249ef81154622bb7ebc41c07d508b139d0ab231be4500a4dcbb/_data",
                    "Destination": "/data",
                    "Driver": "local",
                    "Mode": "",
                    "RW": true,
                    "Propagation": ""
                }
            ],

## ONBUILD ##

**格式**

*  `ONBUILD <INSTRUCTION>`。

指定当该镜像作为其它新镜像的基础镜像时，所需要执行的命令。

例如，生成`image1`镜像的`Dockerfile`如下。

[...]
    ONBUILD ADD . /app/src
    ONBUILD RUN /usr/local/bin/python-build --dir /app/src
    [...]

当基于`image1`镜像创建新镜像时（通过`FROM image1`指令指定基础镜像），新镜像的`Dockerfile`会自动执行`image1`镜像的`Dockerfile`中ONBUILD指令指定的内容，等价于在新镜像的`Dockerfile`后面添加了两条指令：

FROM image1
    
    #Automatically run the following
    ADD . /app/src
    RUN /usr/local/bin/python-build --dir /app/src

在生成`java:8`镜像的`Dockerfile`中，ONBUILD指令可以用来指定设置Java环境变量的命令，之后以`java:8`镜像为基础镜像的新镜像，就会自动设置Java环境变量，这样在由新镜像创建的容器中就可以直接使用`java -jar`这种命令。

## STOPSIGNAL ##

**格式**

*  `STOPSIGNAL signal`。

STOPSIGNAL指令用于设置停止信号，来指定容器的停止方式。容器默认的停止信号是SIGTERM，在容器停止的时候会给容器发送这个`signal`，通过`--stop-signal`选项可以设置自己需要的`signal`，停止信号主要的目的是为了让容器内的应用程序在接收到`signal`之后可以先做一些事情，实现容器的平滑退出，如果不做任何处理，容器将在一段时间之后强制退出，会造成业务的强制中断，这个时间默认是`10s`。

`Dockerfile`中ENV、ENTRYPOINT、VOLUME、ONBUILD、STOPSIGNAL指令的介绍就到这里。

写博客是博主记录自己的学习过程，如果有错误，请指正，谢谢！

[Docker - Docker]: https://kaven.blog.csdn.net/article/details/110227343
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM3OTYwNjAz_size_16_color_FFFFFF_t_70]: /images/20221120/2141369c76a8419b9f9052c1e4b163c6.png