docker 第六篇 dockerfile

复习下镜像生成途径

   Dockerfile

   基于容器制作

什么是dockerfile:

  用来构建镜像的源码,在配置文件中调用命令,这些命令是用来生成docker镜像的。

dockerfile的语法格式:

  由两类组成:

    #Comment 注释信息

    INSTRUCTION arguments    指令和指令参数 (指令大写为了区分参数和别的符号)

    ps: 指令本身不区分大小写,然而约定俗成要大写

      按顺序依次执行

      第一行必须使用 FROM 指定基于哪个基础镜像来实现

      因此:可以推断 所有要构建的镜像都是建立在某个已存在的某个镜像基础之上

dockerfile工作逻辑

  找一个专用的目录放dockerfile文件,文件名首字母必须大写,执行的时候不能有当前文件父目录,必须基于当前目录往下走,

  工作目录下也可以 创建一个.dockerfile的文件,打包是不会包含此目录下的文件。 

执行方式:

  docker build 执行 

  例如:docker build -t tinyhttpd:v1 ./

  -t: 指构建后写的名字

  ./ : 当前的dockerfile

制作镜像时能使用的环境变量

  赋值:变量名=值

  引用:$变量名  或者 ${变量名}

  ${变量名:-word}  表示如果变量的值为空或未设置,引用后面传进来的值

  ${变量名:+word} 表示如果变量的值不为空,则显示后面的值

Dockerfile的指令:

  FROM指定是最重要的一个且必须为Dockerfile文件开篇的第一个非注释行,用于为映像文件构建过程指定基准镜像,后续的指定运行于次准镜像所提供的运行环境

  实践中,基准镜像可以是任何可用镜像文件,默认情况下,docker build会在docker主机上查找指定的镜像文件,在其不存在时,则会从Docker hub registry上拉取所需的镜像文件

  如果找不到指定的镜像文件,docker build会返回一个错误信息

  语法:

    FROM <repository>[:<tag>] 或 FROM <repository>@<digest>

      <repository>:指定作为base image的名称

      <tag>:base image的标签,为可选项,省略表示latest

  

  MAINAINER (这是一个可选项)

    用于让Dockerfile制作人提供本人的详细信息

    不限制此指令出现的位置,推荐位于FROM之后

    语法:

      MAINTAINER <author's detail>

        <author's detail>可是任何文本信息,但约定俗成使用作者名称或邮箱

        MAINTAINER "ivy" <ivy@163.com>

    ps: 较新版本中已经把maintainer换成lable了,但依旧兼容

  LABLE 让用户为镜像指定各种各样的元数据

    语法:

      LABLE <key>=<value>  <key>=<value> ...

  COPY

    用于从Docker主机复制文件到创建的映像文件系统中

    语法:

      COPY <src>...<dest> 或

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

         <src>: 要复制的源文件目录,支持使用通配符

        <dest>:目标路径,即正在创建的image的文件系统路径,此处建议为绝对路径

        ps:如果路径中有空白字符时,通常使用第二种格式

    文件复制准则:

      <src>必须是build上下文中的路径,不能是其父目录中的文件

      如果<src>是目录,不用加=r选项则其内部文件或子目录会被递归复制,但自身不会被复制

      如之多多个<src>,或者<src>中使用通配符,则dest必须是一个目录以/结尾

      如果dest事先不存在,它将会被自动创建,包括其父目录的路径

      总结:src必须使用相对路径,dest使用绝对路径

  ADD

    ADD指令类似于COPY指令,ADD支持使用TAR文件和URL路径

    语法:

      ADD <src>...<dest> 或

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

    操作准则:

      同COPY指令

      如果<src>为url且<dest>不以/结尾,则<src>指定的文件讲被下载并直接被创建为<dest>,如<dest>以/结尾,则文件名url指定的文件将被直接下载并保存为<dest>/<filename>

          如果<src>是一个本地系统上的压缩格式的tar文件,它将被展开为一个目录,类似于"tar -x"命令,而通过url获取的tar文件讲不会自动展开

      如果<src> 有多个,或去简介或直接使用通配符,则<dest> 必须以/结尾

  WORKDIR

    用于为Dockerfile中所有的RUN、CMD、ENTRYPOINT、COPY和ADD指定设定工作目录

    语法:

      WORKDIR <dirpath>

        在dockerfille文件中,WORKDIR指定可以出现多次,其路径也可以为相对路径,不过,其实对象此前一个WORKDIR指定的路径。

        另外,WORKDIR也可调用由ENV指定定义的变量

    例如:

      WORKDIR /var/log

      WORKDIR $STAATEPATH

  VOLUME

    用于在image中创建以一个挂载点目录,以挂载Docker host 上的卷或其他容器上的卷

    语法:

      VOLUME  <mountpoint> 或 VOLUME ["mountpoint"]

    r如果挂载点目录路径下此前在文件中存在, docker run命令会在卷挂载完成后将此前所有文件复制到新挂载的卷中

    

  EXPOSE

    用于为容器打开指定要监听的端口以实现外部通信

    语法:

      EXPOSE <port>[/<protocol>] [<port>[/<protocol>]...]

      <protocol>用于指定传输层协议,tcp或udp 默认是tcp

    EXPOAE指令可一次执行多个端口,例如:

      EXPOSE 11211/udp 11211/tcp

  ENV 

    用于为镜像定义所需的环境变量,并可被Dockerfile文件中位于其后的其它指定

      (如ENV、ADD、COPY)锁调用

    调用格式为$variable_name或${variable_name}

    语法:

      ENV <key><value>或ENV<value>=<value>

    第一种格式中<key> 之后的所有内容均会视其为<value>的租车鞥部分,因此一次只能设置一个值

    第二个格式可用一次设置多个变量,如果value中包含空格可用转义,或双引号

  RUN 

    用于指定docker build过程中运行的程序,其可以是任何命令

    语法:

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

    第一种格式中<command>通常是一个shell命令,且以"/bin/sh -c" 来运行,意味着此进程在容器中的PID不为1,不能接收Unix信号 使用docker <container> stop 来停止容器时 此进程收不到sigterm信号

    第二种语法格式中的参数是一个JSON格式的数组,其中"<executable>"为要运行的命令,后面的为要传递给命令的选项值,而这种格式指定的命令不会以"/bin/sh -c" 来运行

  CMD

    定义一个镜像文件启动为容器时默认要运行的一个程序,可以给多个,但是只有最后一个生效

  语法:

    CMD <command>

    CMD ["<executable>","<param1>","<pa>"]

    CMD ["<param1>","<param2>"]

  前两种语法格式意义同RUN

  第三种则用于ENTERPOINT指令提供默认参数

  ENTRYPOINT

    类似CMD指令的功能,用于为容器指定默认运行程序,从而使得容器像是一个单独的可执行程序

    与CMD不同的是,由ENTRYPOINT启动的程序不会被docker run 命令行指定的参数覆盖,而且这些命令行参数会被当作参数传递给ENTRYPOINT指定的程序

      但是docker run命令的--entrpoint选项的参数可覆盖entrypoint指令指定的程序

    语法:

      ENTRYPOINT <COMMAND>

      ENTRYPOINT ["<executable>","<param1>","<param2>"]

    docker run 命令传入的命令参数会覆盖CMD指令的内容并且附加到ENTRYPOINT命令最后作为其参数使用

    Dockerfile文件中也可以存在多个ENTRYPOINT指令,但仅最后一个生效

  USER

    用于指定运行image时或运行dockerfile中任何RUN、CMD或entrypoint指令指定的程序时的用户UID

    默认情况下container的运行身份为root用户

    语法:

      USER <UID> | <UserName>

      <UID>可以是任意数字,但实践中其必须为/etc/paword中某个用户的有效UID,否则docker run命令将运行失败

  HEALTHCHECH

    详情待补充

  SHELL

  STOPSIGNAL

  ARG

  ONBUILD:

    用于在Dockerfile中定义一个触发器,

    执行时间:

      做成镜像以后别人用此镜像作为基础镜像的时候才会执行

原文地址:https://www.cnblogs.com/guniang/p/11613875.html