docker Dockerfile里使用的命令说明

一,dockerfile格式

  • 注释#
  • 指令 参数
  • 指令不区分大小写,但是推荐全部大写指令。
  • 指令从上到下顺序被执行
  • 第一个指令必须是【FROM】,指示出要使用的基础镜像。
  • 执行docker file时,如果使用到了别的配置文件,这些配置文件不能放到【执行docker file目录】的父目录,但可以放到子目录。
  • 在执行docker file目录下,可以放一个隐藏文件(.dockerignore),里面存放的是build时不需要的文件。可以使用通配符去指定。比如,某个子目录里10个文件,build时有3个文件不需要,你在docker file里引用的是目录名,所以这10个文件都被引入进来了。但如果把不需要的3个文件,加入到.dockerignore文件里,build时就它们3个排除了。
  • 文件名必须是:【Dockerfile】或者【dockerfile】

二,dockerfile 命令

  • FROM命令:repository为基础镜像(base image)的名称,tag为base image的标签,不指定就是latest。如果不指定registry,就从docker hub上拉取。

    • FROM <registry><repository>[:<tag>]

    • FROM <registry><repository>@<digest>

      当从外部registry拉image时,image有可能被别人替换了,但是repository名字相同,所以不安全。digest是image的hash值,所以指定了digest就不会被别人替换掉了。

  • MAINTAINER(不推荐使用,被LABLE替代了)命令:用于让dockerfile制作者提供本人的详细信息。

    MAINTAINER可以出现在任何位置,但推荐放到FROM后面。

  • LABEL命令:用于指定元数据,比如作者,文件大小等。

    • 用法:LABEL <key>=<value> <key>=<value> ...
  • COPY命令:复制宿主机里的文件或目录到:要build出的image的文件系统的某个目录里。

    • 语法:

      • COPY <src> ... <dest>
      • COPY ["<src>", ... "<dest>"]
        • src:源文件或目录,可以使用相对路径(相对dockerfile所在的路径),支持使用通配符
        • dest:目标路径,建议绝对路径,否则,COPY指定则以WORKDIR为起始路径。
      • 注意:在路径中有空白字符时,使用第二种格式,理由是空白字符是第一种格式的目录分隔符。
    • 文件复制准则:

      • src必须是dockerfile里面的文件或目录,不能是其父目录中的文件或路径。

      • 如果src是目录,则其内部文件或子目录都会被递归复制,但src目录自身不会被复制。

        相当于:cp src/* /dest。

      • 如果指定了多个src,或在src中使用了通配符,则dest必须是目录,且必须以/结尾。

      • 如果dest事先不存在,它将会被自动创建,其父目录也会被一并创建。

三,build特点:每执一行命令,都会新建一个层,层越多,性能越不好,所以能把命令放在一行,就尽量放在一行。

比如COPY命令,如果目标目录相同,则最好只使用一次COPY。虽然使用多次COPY也不出错误,但是会多出层,性能不好。

docker build命令

获取帮助信息:

  • PATH:【Dockerfile】或者【dockerfile】文件所在的目录。
  • -c:制作过程使用多少CPU
  • -m:制作过程使用多少内存。
  • -t:指定image的repository和tag。
# docker build --help

Usage:  docker build [OPTIONS] PATH | URL | -

Build an image from a Dockerfile

Options:
      --add-host list           Add a custom host-to-IP mapping (host:ip)
      --build-arg list          Set build-time variables
      --cache-from strings      Images to consider as cache sources
      --cgroup-parent string    Optional parent cgroup for the container
      --compress                Compress the build context using gzip
      --cpu-period int          Limit the CPU CFS (Completely Fair Scheduler) period
      --cpu-quota int           Limit the CPU CFS (Completely Fair Scheduler) quota
  -c, --cpu-shares int          CPU shares (relative weight)
      --cpuset-cpus string      CPUs in which to allow execution (0-3, 0,1)
      --cpuset-mems string      MEMs in which to allow execution (0-3, 0,1)
      --disable-content-trust   Skip image verification (default true)
  -f, --file string             Name of the Dockerfile (Default is 'PATH/Dockerfile')
      --force-rm                Always remove intermediate containers
      --iidfile string          Write the image ID to the file
      --isolation string        Container isolation technology
      --label list              Set metadata for an image
  -m, --memory bytes            Memory limit
      --memory-swap bytes       Swap limit equal to memory plus swap: '-1' to enable
                                unlimited swap
      --network string          Set the networking mode for the RUN instructions
                                during build (default "default")
      --no-cache                Do not use cache when building the image
      --pull                    Always attempt to pull a newer version of the image
  -q, --quiet                   Suppress the build output and print image ID on success
      --rm                      Remove intermediate containers after a successful
                                build (default true)
      --security-opt strings    Security options
      --shm-size bytes          Size of /dev/shm
  -t, --tag list                Name and optionally a tag in the 'name:tag' format
      --target string           Set the target build stage to build.
      --ulimit ulimit           Ulimit options (default [])

dockerfile 例子1:拷贝一个文件。

FROM busybox:latest
MAINTAINER  "magedu <[email protected]>"
LABEL maintainer="magedu <[email protected]>"
COPY index.html /data/html/

build一下上面的dockerfile 试试,使用-t,来指定image的名字和tag,发现build成功了。

# docker build -t tinyhttpd:v0.01 ./
Sending build context to Docker daemon  3.072kB
Step 1/4 : FROM busybox:latest
 ---> b534869c81f0
Step 2/4 : MAINTAINER  "magedu <[email protected]>"
 ---> Using cache
 ---> 5c5a1c47716c
Step 3/4 : LABEL maintainer="magedu <[email protected]>"
 ---> Using cache
 ---> 88b87ddfdb22
Step 4/4 : COPY index.html /data/html/
 ---> Using cache
 ---> 59b7dd6c3eb8
Successfully built 59b7dd6c3eb8
Successfully tagged tinyhttpd:v0.01

启动这个image,看看里面有没有/data/html/index.html

# sudo docker run --name b1 --rm tinyhttpd:v0.01 cat /data/html/index.html
<h1>http server</h1>

dockerfile 例子2:拷贝一个目录。

FROM busybox:latest
MAINTAINER  "magedu <[email protected]>"
LABEL maintainer="magedu <[email protected]>"
COPY index.html /data/html/
COPY yum.repos.d /etc/yum.repos.d/

执行build:

docker build -t tinyhttpd:v0.02 ./
Sending build context to Docker daemon  30.21kB
Step 1/5 : FROM busybox:latest
 ---> b534869c81f0
Step 2/5 : MAINTAINER  "magedu <[email protected]>"
 ---> Using cache
 ---> 5c5a1c47716c
Step 3/5 : LABEL maintainer="magedu <[email protected]>"
 ---> Using cache
 ---> 88b87ddfdb22
Step 4/5 : COPY index.html /data/html/
 ---> Using cache
 ---> 59b7dd6c3eb8
Step 5/5 : COPY yum.repos.d /etc/yum.repos.d/
 ---> 99d306a25cc7
Successfully built 99d306a25cc7
Successfully tagged tinyhttpd:v0.02

验证:

docker run --name b1 -it --rm tinyhttpd:v0.02 ls /etc/yum.repos.d/
CentOS-Base.repo           CentOS-Sources.repo
CentOS-Base.repo_20191129  CentOS-Vault.repo
CentOS-CR.repo             CentOS-fasttrack.repo
CentOS-Debuginfo.repo      docker-ce.repo
CentOS-Media.repo          

二,dockerfile 命令(续)

  • ADD命令:类似COPY,比COPY多了支持压缩类文件的自动解压和从URL下载

    • 语法:

      • ADD <src> ... <dest>
      • ADD ["<src>", ... "<dest>"]
    • ADD准则:

      • 同COPY指令
      • 如果src为URL且dest不以/结尾,则src指定的文件将被下载并直接被创建为dest;如果dest以/结尾,则src指定的文件将被下载并保存为dest/<filename>
      • 如果src是宿主机上的压缩文件,它将被自动展开,其行为类似tar -x;然而通过URL下载的压缩文件不会自动展开。
      • 如果src有多个,或使用了通配符,则dest必须是以/结尾的目录路径;如果dest不以/结尾,则其被视作一个普通文件,src的内容将被直接写入dest。
    • 例子1:使用URL

      FROM busybox:latest
      MAINTAINER  "magedu <[email protected]>"
      LABEL maintainer="magedu <[email protected]>"
      COPY index.html /data/html/
      COPY yum.repos.d /etc/yum.repos.d/
      ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src

      确认结果:

      # docker run --name b1 --rm tinyhttpd:v0.03 ls /usr/local/src/
      nginx-1.2.9.tar.gz
      
    • 例子2:使用本地压缩文件

      FROM busybox:latest
      MAINTAINER  "magedu <[email protected]>"
      LABEL maintainer="magedu <[email protected]>"
      COPY index.html /data/html/
      COPY yum.repos.d /etc/yum.repos.d/
      #ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
      ADD nginx-1.2.9.tar.gz /usr/local/src/

      确认结果:

      # docker run --name b1 --rm tinyhttpd:v0.03 ls /usr/local/src/nginx-1.2.9
      CHANGES
      CHANGES.ru
      LICENSE
      README
      auto
      conf
      configure
      contrib
      html
      man
      src
  • WORKDIR命令:用于dockerfile中所有RUN,CMD,ENTRYPOINT,COPY和ADD指定设定的工作目录。

    WORKDIR可以出现多次,这些命名去上面去找离它最近的WORKDIR作为相对路径的起始。

    • 语法:

      • WORKDIR <PATH>
      • WORKDIR 系统环境变量(比如:$MYENV)。
    • 例子:

      FROM busybox:latest
      MAINTAINER  "magedu <[email protected]>"
      LABEL maintainer="magedu <[email protected]>"
      COPY index.html /data/html/
      COPY yum.repos.d /etc/yum.repos.d/
      #ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
      WORKDIR /usr/local/
      ADD nginx-1.2.9.tar.gz ./src1/

      确认结果:

      sudo docker run --name b1 --rm tinyhttpd:v0.03 ls /usr/local/src1/nginx-1.2.9
      [sudo] password for ys:
      CHANGES
      CHANGES.ru
      LICENSE
      README
      auto
      conf
      configure
      contrib
      html
      man
      src
  • VOLUME:和run -v类似,但只能指定image里的某个目录,而不能指定宿主机的目录。

    • 语法:

      • VOLUME <mountpoint>
      • VOLUME ["mountpoint1", "mountpoint2"]
    • 注意:如果image挂载点目录下有文件,则启动容器后,会把挂载点下的文件拷贝到宿主机。

    • 例子:

      FROM busybox:latest
      MAINTAINER  "magedu <[email protected]>"
      LABEL maintainer="magedu <[email protected]>"
      COPY index.html /data/html/
      COPY yum.repos.d /etc/yum.repos.d/
      #ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
      WORKDIR /usr/local/
      ADD nginx-1.2.9.tar.gz ./src/
      VOLUME /usr/local/src

      确认结果:由于image的/usr/local/src目录下有nginx-1.2.9,所以nginx-1.2.9会被拷贝到宿主机。

      # docker run --name b1 -it --rm tinyhttpd:v0.03
      # ls /var/lib/docker/volumes/1240925e87efaa5d9ed375b268a6d804c29013c04792f9a0dde9e135aa7e9f9e/_data/
      nginx-1.2.9
  • EXPOSE:和-p选项类型,指定容器要暴漏给外部的端口,但不能指定宿主机的端口,因为在作dockerfile的时候,无法确定此image运行在什么宿主机上。也就无法知道宿主机上哪些端口可以使用。所以是随机去找宿主机里可以使用的端口。

    注意:即使使用了EXPOSE命令,但如果RUN时不加-P选项的话,端口也不会被暴露出去的。

    • 语法:EXPOSE <port>[/protocol] <port>[/protocol]

      • protocol是传输层协议,tcp或者udp,不知道就是tcp
      • 可以一次指定多个端口,比如:EXPOSE 5255 5254/udp
    • 例子:

      FROM busybox:latest
      MAINTAINER  "magedu <[email protected]>"
      LABEL maintainer="magedu <[email protected]>"
      COPY index.html /data/html/
      COPY yum.repos.d /etc/yum.repos.d/
      #ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
      WORKDIR /usr/local/
      ADD nginx-1.2.9.tar.gz ./src/
      VOLUME /usr/local/src
      EXPOSE 80

      确认结果:

      启动时先不指定-P,用docker port查看,发现没有端口。

      # docker run --name b1 --rm tinyhttpd:v0.03 /bin/httpd -f -h /data/html/
      # docker port b1

      启动时先指定-P,用docker port查看,发现有端口。

      # docker run --name b1 --rm -P tinyhttpd:v0.03 /bin/httpd -f -h /data/html/
      # docker port b1
      80/tcp -> 0.0.0.0:32768
    • EXPOSE的作用是:默认想暴露的端口,在启动的时候,可以使用-p去覆盖EXPOSE指定的端口。

  • ENV:在容器的系统了定义环境变量,ENV,ADD,COPY等指令可以使用。

    • 语法:

      • ENV <key> <value>
      • ENV <key>=<value> ...
      • 第一种格式,<key>之后所以内容都被视作为value,只能定义一个变量。
      • 第二种格式,定义多个变量,如果value中包含空格,使用\进行转义,也可以通过对value加引号进行标识;另外,\也用做换行。
      • 定义多个变量时,要使用第二种格式,以便不会增加额外的层,导致image过大。
    • 例子:${DOC_ROOT:-/data/html/}的用法是,if(DOC_ROOT 没有值) {DOC_ROOT=/data/html/}

      FROM busybox:latest
      MAINTAINER  "magedu <[email protected]>"
      LABEL maintainer="magedu <[email protected]>"
      ENV DOC_ROOT=/data/html/ \
          WEB_SERVER_PACKAGE="/nginx-1.2.9"
      COPY index.html ${DOC_ROOT:-/data/html/}
      COPY yum.repos.d /etc/yum.repos.d/
      #ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
      WORKDIR /usr/local/
      ADD ${WEB_SERVER_PACKAGE}.tar.gz ./src/
      VOLUME /usr/local/src
      EXPOSE 80
    • 延申,在docker run的时候也可以使用-e选项设置环境变量。

      在run的时候,通过-e,可以改变dockerfile里指定环境变量的值。

      dockerfile里定义的是nginx-1.2.9,但是-e指定的nginx-1.2.3,所以WEB_SERVER_PACKAGE=/nginx-1.2.3。

      # docker run --name b1 --rm -e WEB_SERVER_PACKAGE=/nginx-1.2.3 tinyhttpd:v0.03 printenv
      PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
      HOSTNAME=7a242517b02e
      WEB_SERVER_PACKAGE=/nginx-1.2.3

      但是,/usr/local/src里的目录还是nginx-1.2.9。因为在build的时点,image里放的就已经是nginx-1.2.9了,所以你在-e里,改变的只是环境变量的值而已。

      # docker run --name b1 --rm -e WEB_SERVER_PACKAGE=/nginx-1.2.3 tinyhttpd:v0.03 ls /usr/local/src
      nginx-1.2.9
      
  • RUN:在build执行过程中,执行基础镜像里可以执行的任何shell命令。如果是多个命令是有关联的话,最好写到一起。

    • 语法:

      • RUN <command>
      • RUN ["executable1","arg1","executable2","arg1"]
      • 例如:RUN ["/bin/bash","-c","ls","-ltr"]
    • 例子:我们指定ADD里的src如果是压缩文件的话,不会自动解压缩,所以我们RUN一个tar命令去解压缩它。

      FROM busybox:latest
      MAINTAINER  "magedu <[email protected]>"
      LABEL maintainer="magedu <[email protected]>"
      ENV DOC_ROOT=/data/html/ \
          WEB_SERVER_PACKAGE="nginx-1.2.9"
      COPY index.html ${DOC_ROOT:-/data/html/}
      COPY yum.repos.d /etc/yum.repos.d/
      ADD http://nginx.org/download/${WEB_SERVER_PACKAGE}.tar.gz /usr/local/src/
      RUN cd /usr/local/src && \
          tar xf ${WEB_SERVER_PACKAGE}.tar.gz
      
    • RUN用途举例:先找个基础的centos镜像,然后装一个nginx,一般都是下载源代码编译安装,不是使用yum install。理由是yum会产生多余的文件。

      FROM centos
      RUN yum -y install epel-release && \
          yum makecache && \
          yum install nginx
  • CMD:在docker build时不被运行,而是在docker run时运行。比如nginx镜像启动的时候,那么CMD肯定是启动nginx的命令。所以CMD即使给了多个,只有最后一个生效。

    • 语法:

      • CMD <command>

        command通常是shell命令,而且是以/bin/sh -c来运行此命令,因此,是通过shell启动的,所以可以使用shell的特性,而且启动结束后,shell进程会自动推出,让此进程代替shell进程。所以它pid是1。

      • CMD ["executable1","arg1","executable2","arg1"]

        executable是目录名加上可执行程序名,比如/bin/ls。它不是通过/bin/sh -c来运行,是由内核直接启动,由于不是由shell启动,所以shell里的通配符,管道,重定向等特性,全部不能用。如果想用shell特性,可以这么使用:CMD ["/bin/bash","-c","executable","arg"].

      • RUN的第一种和第二种用法和CMD的第一种和第二种用法一样。

      • CMD ["arg1","arg2"]

        配合ENTRYPOINT命令使用。

    • 例子:

      FROM busybox
      LABEL maintainer="mageedu <[email protected]>" app="httpd"
      
      ENV WEB_ROOT="/data/web/html/"
      
      RUN mkdir -p ${WEB_ROOT} && \
          echo '<h1>Busybox httpd.</h1>' > ${WEB_ROOT}/index.html
      
      CMD /bin/httpd -f -h ${WEB_ROOT}

      确认结果:用inspect确认,确实是用/bin/sh -c来启动的。

      "Cmd": [
                      "/bin/sh",
                      "-c",
                      "/bin/httpd -f -h ${WEB_ROOT}"
                  ],

      pid也是1

       docker exec -it b1 /bin/sh
      / # ps
      PID   USER     TIME  COMMAND
          1 root      0:00 /bin/httpd -f -h /data/web/html/
          6 root      0:00 /bin/sh
         11 root      0:00 ps
       # printenv
      HOSTNAME=e877c51f7dab
      WEB_ROOT=/data/web/html/
      
  • ENTRYPOINT:

    • 类似CMD指令,用于为容器指定默认运行程序。

    • 与CMD不同的是,不会被docker run指定的参数覆盖(也有覆盖的办法),而且docker run指定的参数,会自动加到ENTRYPOINT命令的后面,相当于ENTRYPOINT命令的参数了。

    • run时使用--entrypoint string选项,可以强制替换ENTRYPOINT命令。

    • 如果docker run时没有指定参数,则使用上面CMD的第三种格式定义的参数,作为ENTRYPOINT的参数。

    • 如果docker run时指定了参数,CMD的第三种格式也指定了参数,ENTRYPOINT使用的是docker run时指定的参数,忽略CMD的第三种格式指定的参数。

    • dockerfile文件种也可以出现多个ENTRYPOINT,但只有最后一个生效。

    • 语法:

      • ENTRYPOINT <command>
      • ENTRYPOINT ["executable", "param1", "param2"]
    • 例子:在build时创建nginx的配置文件,而且在run的时候,还可以通过-e参数传递环境变量,修改监听的端口号等信息。

      FROM nginx:alpine
      LABEL maintainer="MageEdu <[email protected]>"
      
      ENV NGX_DOC_ROOT="/data/web/html/"
      
      ADD entrypoint.sh /bin/
      ADD index.html ${NGX_DOC_ROOT}
      
      CMD ["/usr/sbin/nginx", "-g", "daemon off;"]
      ENTRYPOINT ["/bin/entrypoint.sh"]

      ENTRYPOINT命令执行的是一个自己定义的shell命令文件,内容如下。

      • 首先用cat命令创建了一个nginx的配置文件,还使用了环境变量。

      • 然后,调用exec系统函数,参数是CMD定义的命令:["/usr/sbin/nginx", "-g", "daemon off;"]。exec函数的作用是:启动ngxin进程,并终止当前进程(/bin/sh进程),让nginx进程取代当前的shell进程,所以nginx进程的pid是1。

        "$@":shell的全部参数,也就是/usr/sbin/nginx", "-g", "daemon off;

      entrypoint.sh:

      #!/bin/sh
      
      cat > /etc/nginx/conf.d/www.conf << EOF
      server {
        server_name $HOSTNAME;
        listen ${IP:-0.0.0.0}:${PORT:-80};
        root ${NGX_DOC_ROOT:-/usr/share/nginx/html};
      }
      EOF
      
      exec "$@"

      当run的时候,执行ENTRYPOINT命令,参数是CMD里定义的。

      确认结果:通过-e把监听端口设置成了8080;nginx的pid是1;www.conf也被创建了。在宿主机器上执行【curl -H "Host: a6b94dae9be4" 192.0.0.2:8080】,也输出了index.html的结果。

      # docker run --name b1 --rm -d -e "PORT=8080" mynignx:002
      # docker exec -it b1 /bin/sh
      / # netstat -tnl
      Active Internet connections (only servers)
      Proto Recv-Q Send-Q Local Address           Foreign Address         State
      tcp        0      0 0.0.0.0:8080            0.0.0.0:*               LISTEN
      tcp        0      0 0.0.0.0:80              0.0.0.0:*               LISTEN
      # cat /etc/nginx/conf.d/www.conf
      server {
        server_name a6b94dae9be4;
        listen 0.0.0.0:8080;
        root /data/web/html/;
      }
      / # ps
      PID   USER     TIME  COMMAND
          1 root      0:00 nginx: master process /usr/sbin/nginx -g daemon off;
          8 nginx     0:00 nginx: worker process
      # cat /data/web/html/index.html
      <h1>nginx hello</h1>
      $ curl -H "Host: a6b94dae9be4" 192.0.0.2:8080
      <h1>nginx hello</h1>
      

      试验一下,在run时,指定参数:/usr/sbin/nginx daemon off(故意不加-g),去覆盖CMD。因为缺少了-g,所以容器启动失败,说明了,确实覆盖CMD里定义的命令。

      # docker run --name b1 --rm -d -e "PORT=8080" mynignx:002 /usr/sbin/nginx daemon off
      4c88e021408c143ec45e70611c42bd715831cb9c75d6f4a00d307a7a6b53af5c
      [root@localhost ~]# docker ps
      CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
      
      

      试验一下,使用--entrypoint "/bin/sh",覆盖ENTRYPOINT。

      覆盖成功了,1号进程是/bin/sh进程;www.conf文件没有被创建;nginx进程没有被启动。

      # docker run --name b1 --rm -it -e "PORT=8080" --entrypoint "/bin/sh" mynignx:002
      / # ls
      bin    dev    home   media  opt    root   sbin   sys    usr
      data   etc    lib    mnt    proc   run    srv    tmp    var
      / # ps
      PID   USER     TIME  COMMAND
          1 root      0:00 /bin/sh
          7 root      0:00 ps
      / # ls /etc/nginx/conf.d/
      default.conf
    • ENTRYPOINT用法的最佳实践:build之前事先创建好配置文件,build时,注入到image了。就能达到动态创建各种服务的配置文件,从而解决了只是因为配置文件的不同,而不得不创建多个image的问题。

  • USER

    • 使用USER的背景,不指定USER的时候,进程的所有者都是root,比如下面的nginx。当不希望是root的时候,使用此命令。

      / # ps
      PID   USER     TIME  COMMAND
          1 root      0:00 nginx: master process nginx -g daemon off;
    • docker run,CMD,ENTRYPOINT执行的时候,所使用的用户名或者UID

    • 默认情况下是root

    • 语法:USER <UID> | <UserName>

      UID或者UserName必须是在image里存在的,必须存在于/etc/passwd中。

  • HEALTHCHECK:

    • 定期查看容器里运行的进程是否还在工作状态。docker自己会自动检查容器里的进程是否还活着,如果死了或者不在前台运行的时候,docker会自动杀死这个容器。但这是不够的,有的容器即使活着,但不能提供服务了,那也相当于死了,所以要自己定义一个命令去检查容器里运行的进程,是否还在工作。

    • 语法:

      • HEALTHCHECK [OPTION] CMD command
        • OPTION:
          • --interval=:检查的间隔(默认:30秒)
          • --timeout=:定义超时时长(默认:30秒)
          • --start-period=:等多久开始第一次健康检查(默认:0秒)
          • --retries=:发现不健康了,不是立即杀死容器,而要再试验几次。再试验的次数(默认:3次)。
        • 健康检查结果:
          • 0:success
          • 1:unhealthy
          • 2:reserved(保留,为使用)
      • HEALTHCHECK NONE
    • 例子:健康检查结果是正常的。

      FROM nginx:alpine
      LABEL maintainer="MageEdu <[email protected]>"
      
      ENV NGX_DOC_ROOT="/data/web/html/"
      
      ADD entrypoint.sh /bin/
      ADD index.html ${NGX_DOC_ROOT}
      
      HEALTHCHECK  --interval=3s --timeout=3s \
         CMD wget -O - -q http://${IP:-0.0.0.0}:${PORT:-80}/
      
      CMD ["/usr/sbin/nginx", "-g", "daemon off;"]
      ENTRYPOINT ["/bin/entrypoint.sh"]

      结果确认:

      # docker run --name b1 --rm  mynginx:v001
      127.0.0.1 - - [08/Dec/2019:13:54:18 +0000] "GET / HTTP/1.1" 200 612 "-" "Wget" "-"
      127.0.0.1 - - [08/Dec/2019:13:54:21 +0000] "GET / HTTP/1.1" 200 612 "-" "Wget" "-"
      127.0.0.1 - - [08/Dec/2019:13:54:25 +0000] "GET / HTTP/1.1" 200 612 "-" "Wget" "-"
    • 例子:健康检查结果是不正常的。发现不正常后,直接【kill 1】。容器启动后,马上就被杀死了。

      FROM nginx:alpine
      LABEL maintainer="MageEdu <[email protected]>"
      
      ENV NGX_DOC_ROOT="/data/web/html/"
      
      ADD entrypoint.sh /bin/
      ADD index.html ${NGX_DOC_ROOT}
      
      HEALTHCHECK  --interval=1s --timeout=1s  --retries=1 \
         CMD wget -O - -q http://${IP:-0.0.0.0}:10080/ || kill 1
      
      CMD ["/usr/sbin/nginx", "-g", "daemon off;"]
      ENTRYPOINT ["/bin/entrypoint.sh"]
      
  • SHELL:指定用哪个shell去运行RUN,CMD,ENTRYPOINT的命令,默认是/bin/sh -c。

    • 语法:SHELL ["executable", "parameters"]
    • 可以出现多次,每次都会覆盖上一次。
  • STOPSIGNAL:【docker stop 容器名】默认是个PID为1的进程发送15号信号。STOPSIGNAL可以指定别的信号。

    • 语法:STOPSIGNAL 信号。
  • ARG:

    • 在build时,通过【--build-arg】传入到dockerfile里面的变量

    • dockerfile里可以有多个ARG

    • 语法: ARG <name>[=<default value>]

    • 可以在dockerfile里定有ARG的默认值

      ARG version=1.14

    • 例子:

      FROM nginx:alpine
      ARG author="MageEdu <[email protected]>"
      LABEL maintainer=${author}
      
      
      

      确认结果:build时,没有使用--build-arg

      # docker build -t mynginx:v002 ./
      # docker image inspect mynginx:v002
      "Labels": {
                      "maintainer": "MageEdu <[email protected]>"
                  },

      确认结果:build时,使用--build-arg

      # docker build --build-arg author="abc <[email protected]>" -t mynginx:v002 ./
      # docker image inspect mynginx:v002
      "Labels": {
                      "maintainer": "abc <[email protected]>"
                  },
      
  • ONBUILD

    • build时不执行此命令。
    • 当别人拿你做成的image作为base image,执行build时,ONBUILD命令才会执行。
    • 语法:ONBUILD 任何dockerfile命令(除了FROM和MAINTAINER)
    • ONBUILD ADD或者ONBUILD COPY要格外小心,因为你不知道别人在拿你的image做base image时,文件都放在哪里,ADD如果是远程要下载的文件是没有问题的。

c/c++ 学习互助QQ群:877684253

本人微信:xiaoshitou5854

猜你喜欢

转载自www.cnblogs.com/xiaoshiwang/p/12008545.html