首页 » DevOps » Docker » Dockerfile文件指令介绍

Dockerfile文件指令介绍

 
文章目录

Dockerfile其实就是一个文本文件,这个文本文件名称叫Dockerfile,里面包含了一些指令(可以理解成多个指令集合成了一个脚本来构建docker镜像),然后通过docker build来构建这个Dockerfile(docker build可以理解成一个打包的命令)。

Dockerfile用法

docker build命令根据Dockerfile上下文来构建新的docker镜像,构建上下文指当前Dockerfile所在路径或URL(URL是GIT仓库位置),构建的上下文会被递归处理,所以构建指定的目录还包括子目录,URL还包括了子模块。

$ docker build .
Sending build context to Docker daemon 6.51 MB
...

构建是通过守护进程执行而不是CLI运行的,构建过程第一件事就是将整个上下文(递归)发送到守护进程,大多数情况下,最好以一个空目录作为上下文,然后将Dockerfile文件放在该目录下,仅添加构建Dockerfile所需的文件。

注意:不要使用/根目录,会导致硬盘所有内容发送到守护进程。

为了提高性能,可以通过.dockerignore文件来排除不需要的文件和目录。

Dockerfile一般位于构建上下文的根目录下,也可以使用-f指定该文件的位置

通过docker build构建时,也可以用-t指定镜像的仓库和标签

如果在多个仓库,或使用多个标签时,可以使用多个-t

在Docker守护进程执行Dockerfile中的指令前,会对Dockerfile进行初步验证,如果语法不正确,则返回错误

Docker守护进程会逐行的执行Dockerfile中的指令,并且会在每一步提交生成一个新镜像,最终输出新镜像的ID,生成完毕后,Docker守护进程将自动清理发送的上下文。

注意Dockerfile每条指令都是独立运行的,并会创建一个新镜像,因此RUN cd /tmp不会对下一条指令产生任何影响。

Docker会重用已生成的中间镜像(缓存),以加速docker build的构建过程

构建缓存仅用于本地缓存的镜像,如果不想使用本地缓存的镜像来构建,则可以使用--cache-from选项指定它,指定后不再,使用本地的缓存镜像链,而是从其他镜像仓库中下载。

Dockerfile文件格式

#注释信息
指令+参数

Dockerfile指令不区分大小写,但是为了更易区分,约定建议使用大写

Docker会依次执行Dockefile中的指令,第一条指令必须以“FROM”开始,FROM指令用于指定一个基础镜像。

行首以#号开头的作为注释,在其他地方使用#号都会被视为参数,例:

Dockerfile中的指令

FROM

FROM指令初始化一个新的构建,并为后面的指令提供基础镜像,编写一个有效的Dockerfile文件,开篇的第一个非注释行必须从FROM指令开始。

FROM可以在Dockerfile中出现多次,即创建多个镜像。如果忽略tag标签,默认使用latest

例:FROM busybox:latest

LABEL

指定元数据,一条LABEL可以指定一条或多条元数据指定多条元数据时通过空格分隔

例:指定镜像版本和作者
LABEL version="1.0" maintainer="whsir <wh@whsir.com>"

COPY

宿主机工作目录中的文件复制到目标镜像中,在路径中有空白字符时,通常使用第二种格式。

--chown仅在linux用于构建Linux容器的Dockerfiles上受支持,而在Windows容器上不起作用。

<src>表示要复制的源文件或目录,必须是上下文根目录的相对路径,支持通配符。如果<src>是目录,则其内部的子目录会被递归一并复制,但<src>目录本身不会被复制

<dest>表示目标路径,必须是目标镜像中的绝对路径或相对于WORKDIR的相对路径,如果指定了多个<src>或使用了通配符,则<dest>必须是一个目录,且必须需要以/结尾。如果<dest>不存在,则路径中不存在的目录会被创建。

COPY指令类似于ADD,区别在于它不支持自动解压,也不能使用URL路径

ADD

ADD指令类似于COPY,都支持复制本地文件到镜像的功能,但是ADD支持自动解压,可以使用URL路径

--chown仅在linux用于构建Linux容器的Dockerfiles上受支持,而在Windows容器上不起作用。

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

如果<src>指向本地压缩格式的tar文件,该文件在复制到容器中时会被自动解压,但是通过URL获取的tar文件将不会被自动解压。

WORKDIR

用于Dockerfile中所有RUN、CMD、ENTRYPOINT、COPY、ADD指定工作目录。

WORKDIR指令可以在Dockerfile中多次使用,也可以解析先前设定的环境变量ENV。

例:
ENV DIRPATH /path
WORKDIR /usr/local/$DIRPATH/
COPY index.html ./
等同于
ENV DIRPATH /path
COPY index.html /usr/local/$DIRPATH/

VOLUME

在镜像中创建一个新的挂载点目录,用于挂载docker主机上的卷或其它容器上的卷

EXPOSE

容器运行时监听的网络端口(容器中暴露的端口),可以指定监听TCP还是UDP,如果未指定,默认监听TCP

无论EXPOSE设置的端口是什么,都可以在容器运行时,使用-p选项覆盖。

例:指定多个端口
EXPOSE 80/tcp 80/udp

ENV

用于为镜像所创建的容器定义环境变量,ENV声明的环境变量会被后续ADD、COPY等指令调用。

Dockerfile中通过ENV定义的环境变量,也会在启动容器后,直接在容器中使用,但是在容器启动时,使用-e选项会覆盖此环境变量

如果<value>中包含空格,可以使用\反斜线进行转义,也可以对<value>加引号。

因为每多写一行,在构建Dockerfile时就会增加一层,所以定义多个变量时,建议使用第二种方式。

例:定义多个变量

RUN

指定docker build时运行的命令。

第一种shell方式,linux使用“/bin/sh -c”来运行,Windows使用cmd /S /C

第二种exec方式,不会调用命令shell,不会使用变量替换,如果要运行的命令依赖此shell特性的话,可以使用下面这种方式
RUN ["/bin/bash", "-c", "echo hello"]

例:

CMD

CMD指令为启动的容器指定默认要运行的命令,但是CMD指定的命令可以被docker run命令行选项所覆盖,在Dockerfile中可以存在多个CMD指令,但只有最后一条CMD指令有效

在第三种格式中,command通常是一个shell命令,且以"/bin/sh -c"来运行它,此进程在容器中的PID不为1,不能接收Unix信号
在第一种格式中的参数是一个JSON数组,其中executable要运行的命令,paramN为传递给命令的选项或参数,但是此格式指定的命令不会以"/bin/sh -c"发起,所以shell操作(变量替换、通配符等)将不会进行。第二种CMD所指定的内容,会被当成参数传递给ENTRYPOINT。

例:

ENTRYPOINT

类似CMD指令,用于为容器提供默认运行程序,每次使用镜像创建容器时,通过ENTRYPOINT指定的程序都会被设置为默认程序,由ENTRYPOINT启动的程序不会被docker run命令行指定的参数所覆盖,而且,这些命令行参数会被当做参数传递给ENTRYPOINT指定的程序。

一个Dockerfile中可以有多条ENTRYPOINT指令,但只有最后一条ENTRYPOINT指令有效。

USER

指定运行镜像及Dockerfile中任何RUN、CMD、ENTRYPOINT指令使用的用户名或UID和用户组或GID,默认容器中运行的身份为root。

在Windows下内置帐户,则必须创建用户,可以通过net user作为Dockerfile的一部分调用的命令来完成。

HEALTHCHECK

在CMD前的选项:

--interval=DURATION每隔30s检测一次,默认30s
--timeout=DURATION超时时长,默认30s
--start-period=DURATION等主进程初始化完成后进行检测,默认等待时间0s
--retries=N连续检查N次,默认3次,如果3次都是失败,则认为这个容器是不健康的

CMD后可以跟shell脚本或数组。命令退出状态值可能为:

0:成功-容器健康且可用
1:不健康-容器无法正常工作
2:保留状态值自定义

例:每隔五分钟检测一次,超时时间为3秒,使用curl命令对localhost进行检测,失败退出为1

SHELL

设置默认shell所使用的shell类型,linux默认shell是["/bin/sh", "-c"],Windows默认shell是["cmd", "/S", "/C"],在Dockerfile中必须以JSON形式编写shell指令。

SHELL指令在Windows下特别有用,Windows下通常有cmd和powershell两种shell,以及sh备用shell。

SHELL指令可以出现多次。每个SHELL指令将覆盖所有先前的SHELL指令,并影响所有后续的指令。

STOPSIGNAL

停止容器所要发送的系统调用信号,该信号可以内核系统调用表中合法的值(例如9或SIGKILL)。

ARG

用于Dockerfile内的环境变量,与ENV相似,但是ARG仅docker build的过程中有效,在docker build构建时,可以使用--build-arg <varname>=<value>参数传递替换,构建成功的镜像不存在此环境变量。

ARG指令可以进行一些宏定义,比如我定义ENV JAVA_HOME=/opt/jdk,之后RUN后面的shell命令中的${JAVA_HOME}都会被/opt/jdk代替。

例:

ONBUILD

在Dockerfile中定义一个触发器,当所构建的镜像被用作其他镜像的基础镜像时,该镜像中的触发器会被触发。

ONBUILD不支持自我嵌套,而且不会触发FROM和MAINTAINER指令

 

更多内容请见官方文档:https://docs.docker.com/engine/reference/builder/

原文链接:Dockerfile文件指令介绍,转载请注明来源!

0