使用Dockerfile创建镜像

   定义创建镜像过程中使用的变量。

   格式为ARG<name>[=<default value>]

   在执行docker build时，可以通过-build-arg[=]来为变量赋值。当镜像编译成功后，ARG指定的变量将不再存在（ENV指定的变量将在镜像中保留）。

   指定所创建镜像的基础镜像。

   格式为FROM <images> [AS <name>]或FROM <image>:<tag> [AS <name]或FROM <image>@<digest> [AS <name>]

   任何Dockerfile中第一条指令必须为FROM指令。并且，如果在同一个Dockerfile中创建多个镜像时，可以使用多个FROM指令（每个镜像一次）

   例如：

    ARG VERSION=9.3

    FROM debian:${VERSION}

   LABEL指令可以为生成的镜像添加元数据标签信息。这些信息可以用来辅助过滤出特定镜像。格式为LABEL <key>=<value> <key>=<value> <key>=<value>...

   例如：

    LABEL version="1.0.0-rc3"

    LABEL author="yeasy@github" date="2020-01-01"

    LABEL description="This text illustrates that label-values can span multiple lines."

   声明镜像内服务监听的端口。

   格式为EXPOSE <port> [<port>/<protocol>...]

   例如：

    EXPOSE 22 808443

   注意该指令只是起到声明作用，并不会自动完成端口映射。

   如果要映射端口出来，在启动容器时可以使用-P参数（Dockr主机会自动分配一个宿主机的临时端口）或-p HOST_PORT参数（具体指定所映射的本地端口）

   指定环境变量，在镜像生成过程汇总会被后续RUN指令使用，在镜像启动的容器中也会存在。格式为ENV <key> <value> 或 ENV <key>=<value>...

   例如：

    ENV APP_VERSION=1.0.0

    ENV APP_HOME=/usr/local/app

    ENV PATH $PATH:/usr/local/bin

   如下面的指令，最终结果为key1=value1 key2=value2:

    ENV key1=value2

    ENV key1=value1 key2=${key1}

   指定镜像的默认入口命令，该入口命令会在启动容器时作为根命令执行，所有传入值作为命令的参数。

   支持两种格式：ENTRYPOINT ["executable","param1","param2"]:exec调用执行；

                           ENTRYPOINT command param1 param2:shell中执行。

   每个Dockerfile中只能有一个ENTRYPOINT，当指定多个时，只有最后一个起效。

   创建一个数据卷挂载点。

   指定运行容器时的用户名或UID，后续的RUN等指令也会使用指定的用户身份。

   格式为USER daemon

   当服务不需要管理员权限时，可以通过该命令指定运行用户，并且可以在Dockerfile中创建所需要的用户。

   例如：

    RUN groupadd -r postgres && useradd --no-log-init -r -g postgres postgres

    需要临时获取管理员权限可以使用gosu命令。

   为后续的RUN、CMD、ENTRYPOINT指令配置工作目录。

   格式为WORRDIR/path/to/workdir

   可以使用多个WORKDIR指令，后续命令如果参数是相对路径，则会基于之前命令指定的路径。

   例如：

    WORKDIR /a

    WORKDIR b

    WORKDIR c

    RUN pwd

    则最终路径为/a/b/c

    因此，为了避免出错，推荐WORKDIR指令中只是用绝对路径。

   指定当基于所生成镜像创建子镜像时，自动执行的操作命令。

   格式为ONBUILD [INSTRUCTION]

   例如：

    使用如下的Dockerfile创建父镜像ParentImage,指定ONBUILD指令：

    #Docker for ParentImage

    [...]

    ONBUILD ADD ./app/src

    ONBUILD RUN /usr/local/bin/python-build --dir /app/src

    [...]

    使用docker build命令创建子镜像ChildImage时（FROM ParentImage），会首先执行ParentImage中配置的ONBUILD指令：

    #Dockerfile for ChildImage

    FROM ParentImage

    等价于在ChildImage的Dockerfile中添加了如下指令：

    #Automatically run the following when building ChildImage

    ADD . /app/src

    RUN /usr/local/bin/python-build --dir /app/src

   由于ONBUILD指令是隐式执行的，推荐在使用他的镜像标签，例如ruby:2.1-on-build

   ONBUILD指令在创建专门用于自动编译、检查等操作的基础镜像时，十分有用。

   指定所创建镜像启动的容器接收退出的信号值：

    STOPSIGNAL signal

   配置所启动容器如何进行健康检查（如何判断健康与否），自Docker1.12开始支持。

   格式有两种：

    HEALTHCHECK [OPTONS] CMD command:根据所执行命令返回值是否为0来判断；

    HEALTHCHECK NONE:禁止基础镜像中的健康检查。

    OPTION支持如下参数：

    -interval=DURATION（default:30s）:

    过多久检查一次;

    -timeout=DURATION(default:30s):

    每次检查等待结果的超时;

    -retries=N(default:3):如果失败了，重试几次才最终确定失败。

   指定其他命令使用shell时的默认shell类型：

    SHELL ["executable", "parameters"]

    默认值为["/bin/sh","-c"]

如下：创建一个busybox镜像为基础镜像的nginx镜像