dockerfile的指令

        dockerifle简介

                dockerfile是一种被docker程序解释的脚本,dockerfile里面的文件是由一条一条指令组成的,每条指令对应linux下面的一条命令。docker程序将这些dockerfile指令翻译真正的linux命令。dockerifle有自己书写格式和支持的命令,docker程序解决这些命令间的依赖关系,类似makefile。docker程序将读取dockerfile,根据指令生成定制的p_w_picpath,相比p_w_picpath这个“盒子”,dockerfile这种显而易见的脚本更容易被使用者接受,明确的表明p_w_picpath是怎么产生的。有了dockerfile,当我们需要定制主机额外的需求时,只需在dockerfile上添加或修改指令,重新生成p_w_picpath即可,省去命令的麻烦。

                dockerfile由一条一条命令语句组成,并且支持一#开头的注释行。

                dockerfile的指令忽略大小写,不够建议使用大写,每一行只支持一条指令,每条指令可以携带多个参数。

                dockerfile的指令根据作用可以分为两种,构建指令和设置指令。构建指令用于构建p_w_picpath,其指定的操作不会在运行p_w_picpath的容器上执行;设置指令用于设置p_w_picpath的属性,其指定的操作将在运行p_w_picpath的容器中执行。

    一般dockerifle分为四部分:基础镜像信息,维护者信息,镜像操作指令,容器启动时执行指令。

    dockerifle文件中开始必须指明所基于的镜像名称,接下来推荐说明维护者信息,接下来则是镜像操作指令如RUN指令将对镜像执行跟随的命令。每运行一条RUN指令,镜像添加新的一层,并提交,最后是CMD指令,指定允许容器时的操作命令。

        dockerfile指令

            指令一般格式为INSTRUCTION arguments,指令包括FROM,MAINTAINER,RUN

                FROM指定基础p_w_picpath

                    构建指令,必须指定且需要在dockerifle其他指令的前面,后续的指令都依赖与该指令指定的p_w_picpath。指定的基础p_w_picpath可以是官方远程仓库也可以是本地仓库。

                    格式:

                        FROM <p_w_picpath>指定基础p_w_picpath为该p_w_picpath的最后修改的版本

                        FROM <p_w_picpath>:<tag>指定基础p_w_picpath为该p_w_picpath的一个tag版本

                MAINTAINER用来指定镜像创建者信息

                    构建指令,用于将p_w_picpath的制作者相关的信息写入到p_w_picpath中,我们对p_w_picpath执行dockerinspect命令是,输出中有相应的字段记录该信息

                    格式:

                        MAINTAINER <name>

                RUN安装软件用

                    构建指令,RUN可以允许任何被基础p_w_picpath支持的命令,基础p_w_picpath选择了ubuntu,那么软件管理部分只能使用ubuntu的命令。

                    格式:

                        RUN <command> (the command is run in a shell - `/bin/sh -c`)

                        RUN ["executable","parma1","param2"...] (exec form)

                        前者将在shell终端中运行命令,即/bin/sh -c ;后者则使用exec执行。

                        指定使用其它终端可以通过第二种方式实现,例如RUN ["/bin/bash","-c","echo hello"]

                        每条RUN指令将在当前镜像基础上执行指定命令,并提交为新搭建镜像。当命令较长时可以使用\来换行。

                CMD设置container启动执行的操作

                        设置指令。该操作可以是执行自定义脚本,也可以是执行系统命令。

                        CMD ["executable","param1","param2"]使用exec执行,推荐方式。

                        CMD command param1 param2在/bin/sh中执行,提供给需要交互的应用

                        当dockerfile指定了ENTRYPOINT,就使用CMD ["param1","param2"]提供给ENTRYPOINT的默认参数。

                        ENTRYPOINT指定的是一个可执行的脚本或者程序的路径,该指定的脚本或者程序将会以param1和param2作为参数执行。所以如果CMD指令使用上面的形式,那么dockerifle中必须要有配套的ENTRPOINT

                        每个dockerfile只能有一条CMD命令指定启动容器是执行的命令。如果指定多条,只有最后一条会被执行。

                        如果用户启动容器是指定了运行的命令,则会覆盖掉CMD指定的命令。

                ENTRYPOINT设置container启动时执行的操作

                    设置指令,容器启动时执行的命令,可以多次设置,只有最后一个有效。    

                    格式:

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

                        ENTRYPOINT command param1 param2 shell中执行

                        配置容器启动后执行的命令,并且不可被docker run提供的参数覆盖

                        每个dockerifle中只能有一个ENTRYPOINT,当指定多个是,只有最后一个起效

                        该指令的使用分为两种情况,一种是独自使用,另一种和CMD指令配合使用。

                        当独自使用时,如果你还使用了CMD命令且CMD是一个完整的可执行的命令,那么CMD指令和NETRYPOINT会互相覆盖只有最后一个CMD或者ENTRYPOINT有效  

                        例如:

                            CMD指令将不会被执行,只有ENTRYPOINT指令被执行

                                CMD ecoh "hello,world"

                                ENTRYPOINT ls -l

                        另一种用法和CMD指令配合使用来指定ENTRYPOINT的默认参数,这时CMD指令表示一个完整的可执行命令,仅仅是参数部分;ENTRYPOINT指令只能使用JSON方式指定执行命令,而不能指定参数

                        例如:

                            FROM ubuntu

                            CMD ["-l"]

                            ENTRYPOINT ["/usr/bin/ls"]

                USER设置container容器的用户,默认是root用户

                    指定运行容器时的用户名或UID,后续的RUN也会使用指定用户

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

                    例如:

                        指定memcached的运行用户

                        ENTRYPOINT ["memcached"]

                        USER daemon

                        ENTRYPOINT ["memcached","-u","daemon"]

                EXPOSE指定容器需要映射到宿主机的端口

                    设置指令,会将容器中的端口映射成宿主机中的某个端口,当你需要访问容器的适合,可以不是用容器的ip地址而是使用宿主机的ip地址和映射后的端口

                    如果想要完成整个操作需要两个步骤,首先在dockerfile使用EXPOSE设置映射的容器端口,然后在运行容器的适合指定-p选项加上EXPOSE设置的端口,EXPOSE设置的端口号会被随机映射成宿主机中的一个端口号,也可以指定需要映射到宿主机的那个端口,这时要确保宿主机的端口号没有被占用,EXPOSE指令可以一次设置多个端口号,相应的允许容器的适合,可以配套的多次使用-p选项

                    例如:

                        映射一个端口

                            EXPOSE port1

                        相应的运行容器使用的命令

                            docker run -p poart1 p_w_picpath

                        映射多个端口

                            EXPOSE port1 port2 port3

                        相应的运行容器使用的命令

                            docker run -p port1 -p port2 -p port3 p_w_picpath‘

                        还可以指定需要映射到宿主机上的某个端口号

                            docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 p_w_picpath

                        端口映射是docker比较重要的一个功能,原因在于我们每次允许容器的适合容器的ip地址不能指定而是在桥接网卡的地址范围内随机生成的,宿主机的ip地址是固定的,我们可以将容器的端口映射到宿主机上的一个端口,免去每次访问容器中的某个服务时都要查看容器的ip地址

                        对于一个允许的容器,可以使用docker port加上容器中需要映射的端口和容器ID来查看该端口号在宿主机上的映射端口。

                ENV用于设置环境变量

                    构建指令,指定一个环境变量,会被后续RUN指令使用,并在容器运行是保持

                    格式:    

                        ENV <key> <value>

                        container启动后,可以通过docker inspect查看这个环境变量或者也可以通过docker run --env key=value时设置或修改环境变量

                    例如:

                        安装了JAVA程序,需要设置JAVA_HOME,那么可以在dockerifle中这样写:ENV JAVA_HOME /path/to/java/dirent

                        ENV PG_MAJOR 9.3

                        ENV PG_VERSION 9.3.4

                        RUN curl http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress

                        ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH

                ADD从src复制文件到container的dest路径

                    构建指令,所有拷贝到container中的文件和文件夹权限为0755,uid和gid为0;

                    如果是一个目录,那么会将该目录下的所有文件添加到container中,不包括目录;

                    如果文件是可识别的压缩格式,则docker会帮忙解压缩

                    如果<src>是文件且<dest>中不使用斜杠结束,则会将<dest>视为文件,<src>的内容会写入<dest>

                    如果<src>是文件且<dest>中使用斜杠结束,则会<src>文件拷贝到<dest>目录下

                    格式:

                        ADD <src> <dest>

                        该命令将复制指定的<src>到容器中的<dest>

                        其中<src>可以是dockerfile所在目录的一个相对路径,也可以是一个URL,还可以是一个tar文件

                        <dest>是container中的绝对路径

                COPY复制本地主机的<src>到容器中的<dest>

                    格式:

                        COPY <src> <dest>

                VOLUME指定挂载点

                    设置指令,使容器中的一个目录具有持久化存储数据的功能,该目录可以被容器本身使用,也可以共享给其他容器使用,我们指定容器使用的是AUFS,这种文件系统不能持久化数据,当容器关闭后,所有更改都会丢失。当容器中的应用有持久化数据的需求时可以在dockerifle中使用该指令

                    格式:

                        VOLUME ["<mountpoint>"]

                    例如

                        VOLUME ["/tmp/data"]

                        运行通过该dockerifle生存p_w_picpath的容器,/tmp/data目录中的数据在容器关闭后,里面的数据还存在,例如另一个容器也有持久化数据的需求,且想使用上面容器共享的/tmp/data目录,那么可以运行docker run -t -i -rm -volumes -from container1 p_w_picpath2 bash。container1为第一个容器的ID,p_w_picpath2为第二个容器允许p_w_picpath的名字

                WORKDIR切换目录

                    设置指令,可以多次切换,对RUN,CMD,ENTRYPOINT生效,为后续的RUN,CMD,ENTRYPOINT指令配置工作目录

                    格式:

                        WORKDIR /path/to/workdir

                    例如:

                        在/p1/p2下执行vim a.txt

                        WORKDIR /p1

                        WORKDIR /p2

                        RUN vim a.txt

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

                        WORKDIR /a

                        WORKDIR b

                        WORKDIT c

                        RUN pwd

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

                ONBUILD在子镜像中执行

                    格式:

                        ONBUILD [INSTRUCTION]

                    配置当所创建的镜像作为其它新创建镜像的基础镜像时,所执行的操作指令。

                    例如:

                        dockerfile使用如下的内容创建了镜像p_w_picpath-A

                        ONBUILD ADD ./app/src

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

                        如果基于p_w_picpath-A创建新的镜像是,新的dockerifle中使用FROM p_w_picpath-A指定基础镜像时,会自动执行ONBUILD指令内容。

                        等价于在后面添加了两条指令

                            FROM p_w_picpath-A    

                            #Automatically run the following

                            ADD ./app/src

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

                        使用ONBUILD指令的镜像,推荐在标签中注明

                     

                        

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章