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
FROM
MAINTAINER用来指定镜像创建者信息
构建指令,用于将p_w_picpath的制作者相关的信息写入到p_w_picpath中,我们对p_w_picpath执行dockerinspect命令是,输出中有相应的字段记录该信息
格式:
MAINTAINER
RUN安装软件用
构建指令,RUN可以允许任何被基础p_w_picpath支持的命令,基础p_w_picpath选择了ubuntu,那么软件管理部分只能使用ubuntu的命令。
格式:
RUN
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
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会帮忙解压缩
如果
如果
格式:
ADD
该命令将复制指定的
其中
COPY复制本地主机的
格式:
COPY
VOLUME指定挂载点
设置指令,使容器中的一个目录具有持久化存储数据的功能,该目录可以被容器本身使用,也可以共享给其他容器使用,我们指定容器使用的是AUFS,这种文件系统不能持久化数据,当容器关闭后,所有更改都会丢失。当容器中的应用有持久化数据的需求时可以在dockerifle中使用该指令
格式:
VOLUME ["
例如
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指令的镜像,推荐在标签中注明