Docker之Dockerfile(二)

Dockfile是一种被Docker程序解释的文本格式的配置文件，Dockerfile由一条一条的指令组成， 每条指令对应Linux下面的一条命令。docker程序将这些Dockerfile指令翻译真正的linux命令。 Dockerfile有自己书写格式和支持的命令，Docker程序解决这些命令间的依赖关系，类似于Makefile。 Docker程序将读取Dockerfile，根据指令生成定制的image。相比image这种黑盒子， Dockerfile这种显而易见的脚本更容易被使用者接受，它明确的表明image是怎么产生的。 有了Dockerfile，当我们需要定制自己额外的需求时，只需在Dockerfile上添加或者修改指令，重新生成image即可，省去了敲命令的麻烦。 Dockerfile可分为四部分：基础镜像，维护者，镜像操作指令，容器启动时执行指令。 FROM FROM指令是最重要的，且必须为第一个非注释行，用于为构建映像文件的基准镜像，后续指令基于此基准镜像执行。 基准镜像可以是任何可用的镜像文件，默认在docker build时会在docker主机上查找知道镜像文件， 其不在时则会从docker hub registry上查找下载使用。 语法： FROM <image>[:tag] FROM <image>@<digest> <image>:指定基准镜像文件或及标签 <tag>:基准镜像的标签，可选，缺省默认为latest Exp： FROM docker.io/centos:latest #以顶层仓库的centos:latest为基准镜像 MAINTANIER 提供制作此镜像的作者信息，不限位置，推荐在FROM指令之后 语法： MAINTANIER <author’s detail>#可是任意文本，推荐作者名及邮件地址 Exp： MAINTANIER wangye 120649294@qq.com COPY 用于从docker主机复制文件到新镜像文件内 语法： COPY <src>...<dest> COPY [“<src>”...”<dest>”] <src>:docker主机上的源文件或目录，支持通配符 <dest>:新镜像的路径，建议使用绝对路径，否则以WORKDIR为其起始路径 文件复制准则： <src>必须是build上下文中的路径，不能是其父目录中文件 如果<src>是目录，会被递归复制，但<src>目录自身不会被复制 如指定多个<src>，或使用通配符，则<dest>必须是一个目录，且必须以/结尾 如果指定的<dest>不存在，会自动创建，也包含其父目录路径 Exp: COPY /data/python.sh /scripts/ #将docker主机的/data/python.sh脚本复制到新镜像的/scripts/目录下 ADD 类似COPY指令，ADD支持使用TAR文件和URL路径 语法： ADD <src>...<dest> ADD [“<src>”,...”[dest]” 操作准则： 同COPY指令 如果<src>为URL且不以/结尾，则<src>指定的文件将被下载并直接被创建为<dest>，如果<dest>以/结尾，则文件名URL指定的文件将被直接下载并保存为<dest>/<filename> 如果<src>是一个本地系统上的压缩格式的tar文件，它将被展开一个目录，其效果类似“tar -x”命令，然而，通过URL获取到的tar文件将被不会自动展开。 如果<src>有多个，或其间接或直接使用了通配符，则<dest>必须是一个以/结尾的目录路径，如果<dest>不以/结尾，则其被视作一个普通文件，<src>的内容将被直接写入<dest> Exp： ADD /data/test* /file/ #将/data目录下所有以test开头的文件复制到新镜像系统的/file目录下， ADD /data/filename.tar.xz /file/ #将/data/filename.tar.xz文件解压到新镜像的/file目录下 WORKDIR 用于为Dockerfile中所有的RUN,CMD,ENTRYPOINT,COPY,ADD指定设定工作目录，可以使用多个WORKDIR指令，后续命令如果参数是相对路径，则会基于之前命令指定的路径做为工作目录。 语法： WORKDIR <dirpath> Exp： WORKDIR /smartwy/file/ #后续命令为相对路径时，以此做为工作目录 VOLUME 在新image中创建一个挂载点目录，以挂载docker主机上的卷或其它容器的卷，一般用于存放数据库和需要保持的数据等。 语法： VOLUME <mountpoint> VOLUME [“<mountpoint>”] 如果挂载点目录下存有文件，docker run 命令会在卷挂载完成后将此前的所有文件复制到新挂载的卷中。 EXPOSE 用于为容器打开指定要监听的端口以实现与外部通讯，在启动容器时需要通过-P，Docker主机会自动分配一个端口映射到image指定的端口，使用-p，则是可以指定本地端口映射到image指定的端口 语法： EXPOSE <pointnumber> Exp： EXPOSE 22 23 80 ENV 用于为镜像定义所需要的环境变量，并可被Dockerfile文件中位于其后的其它指令调用。 语法： ENV <key> <value> ENV <key>=<value> 调用格式：$variable_name或${variable_name} 第一种格式，<key>之后的所有内容均会被视作其<value>的组成部分，因此一次只能设置一个变量 第二种格式可用一次设置多个变量，每个变量为一个“<key>=<value>”的键值对，如果<value>中包含空格，可以使用\反斜线进行转义，也可通过对<value>加引号进行标识，另外，反斜线也可用于续行 Exp： ENV BASE_DIR /data/file/ ADD /root/file $BASE_DIR RUN 用于指定Docker build过程中运行的程序，其可以是任何命令 语法： RUN <command> RUN [“<executable>”,”<param1>”,”<param2>”] 第一种格式，<command>通常是一个shell命令，且以“/bin/sh –c”来运行它，这意味着此进程在容器中的PID不为1，不能接收unix信号，因此，当使用docker stop <container>命令停止容器时，此进程接受不到SIGTERM信号。 第二种格式中的参数是一个JSON格式的属组，其中<executable>为要运行的命令，后面的<paramN>为传递给命令的选项或参数，然而，此种格式指定的命令不会以“/bin/sh –c ”来发起，因此常见的shell操作如变量替换以及通配符(？，*等)替换将不会被进行，如果需要依赖shell此特性，可以将其替换为类似下面格式 RUN [“/bin/bash”,”-c”,”<executable>”,”<param1>”] Exp: RUN yum –y install nginx php-fpm CMD 类似RUN指令，CMD也可用于运行任何命令或应用程序，但二者的运行时间点不同，RUN指令运行与映像文件构建过程中，而CMD指令运行与基于Dockerfile构建出的新映像文件启动一个容器时。 CMD指令的首要目的在于为启动的容器指定默认要运行的程序，且其运行结束后，容器也将终止，不过，CMD指令可以被docker run 的命令行选项所覆盖，在dockerfile中可以存在多个CMD指令，但仅最后一个会生效。 语法： CMD <command> CMD [“<executable>”,”<param1>”,”<param2>”] CMD [“<param1>”,”<param2>”] 前两种语法格式同RUN 第三种则用于ENTRYPOINT指令提供默认参数 Exp： CMD [“nginx”] ENTRYPOINT 类似CMD指令。用于容器指定默认程序，从而使得容器像一个单独的可执行程序，与CMD不同的是，有ENTRYPOINT启动的程序不会被Dokcer run命令行指定的参数覆盖，而且，这些命令行参数会被当作参数传递给ENTRYPOINT指定的程序。 不过，docker run命令的—entrypoint选项的参数可覆盖ENTRYPOINT指令的程序 语法： ENTRYPOINT <command> ENTRYPOINT [“<executable>”,”<param1>”,”<param2>”] USER 用于指定运行image时或运行dockerfile中任何RUN,CMD或ENTRYPOINT指令指定的程序时的用户名或UID 语法： USER <UID>|<USERNAME> 注意：UID可以为有效任意数字，但其必须为/etc/passwd中有效UID，否则，docker run 将运行失败。 ONBUILD 用于在Dockerfile中定义一个触发器。Dockerfile用于build映像文件，此映像文件亦可作为BASE image被另一个Dockerfile用作FROM指令参数，并以此构建出新的映像文件，在后面的这个dockerfile文件中的FROM指令在build过程中被执行时，将会“触发”创建其BASE image的dockerfile文件中的ONBUILD指令定义的触发器。 语法： ONBUILD <INSTRUCTION> 尽管任何指令或可被注册称为触发器指令，但ONBUILD不能自我嵌套，且不会触发FROM和MAINTAINER指令。 在ONBUILD指令使用ADD或COPY指令时，应注意源文件一定要存在，否则会构建失败。 如使用ONBUILD指令，建议在标签中注明。 Exp： ONBUILD RUN /usr/sbin/echo “from smartwy” >> /etc/issue Dockerfile文件编写完成后，在其工作目录下执行： docker build –t smartwy/centos/testbuild:v0.1 ./ #基于当前目录下的dockerfile文件创建名为smartwy/centos/testbuild的镜像， 如想上传到自己的映像仓库上须事先登录： Docker login 上传映像： Docker push smartwy/centos/testbuild:v0.1 下载映像： Docker pull smartwy/centos/testbuild:v0.1

各种示例请参考官方文档： http://dockerfile.github.io/