一文学会Dockerfile语法

接应上篇,续讲前文。今天咱来聊一下Dockerfile的使用 。

 

虽然可以通过docker commit命令来手动创建镜像,但是通过Dockerfile文件,可以帮助我们自动创建镜像,并且能够自定义创建过程。本质上,Dockerfile就是一系列命令和参数构成的脚本,这些命令应用于基础镜像并最终创建一个新的镜像,简化了从头到尾的构建流程并极大地简化了部署工作。

使用Dockerfile的优点:

  • 像编程一样构建镜像,支持分层构建及缓存。
  • 可以快速而精确的重新创建镜像以便于维护和升级。
  • 便于持续集成。
  • 可在任何地方快速构建镜像。

 

一、Dockerfile构建镜像步骤

 

1、创建Dockerfile文件,名字就是Dockerfile

2、docker build Dockerfile所在路径 -t 镜像名称[:tag]

 

二、Dockerfile指令

 

1、FORM

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

基准镜像可以是任务可用镜像文件,默认情况下,docker build会在docker主机上查找指定的镜像文件,如果不存在,则会从Docker Hub Registry上拉取所需的镜像文件。

也就是说,任何新建镜像必须基于已有的镜像进行构建。

 

格式:FROM 镜像名称[:tag]

例如:FROM ngxin

 

2、MAINTAINER

用于让Dockerfile制作者提供本人的详细信息,此指令位置不限,但推荐放置FROM之后。

格式:MAINTAINER 作者信息

例如:MAINTAINER “lsy”

 

3、LABLE

为镜像指定标签,会继承基础镜像的LABLE,如果key相同,则覆盖。可替代MAINTANIER使用。

 

格式:LABLE key1=value1 key2=value2

例如:LABLE author=lsy

4、RUN

指定要运行并捕获到新容器镜像中的命令,包括安装文件、创建文件等,在容器创建过程中执行。

 

格式 :RUN 指令1 [&& 指令2]

 

注意:由于Dockerfile中每一个指令都会创建一层,所有层一起构成新的镜像。如果指令过多的话,会变得很臃肿,增加构建时间,所以可以将指令合并执行

例如:RUN mkdir -p /usr/lsy && echo ‘this is lsy file’ > /usr/lsy/lsy.html

 

例如下面这个Dockerfile文件:

基于nginx创建一个镜像,并创建/usr/lsy目录并创建lsy.html文件

FROM nginx
MAINTAINER "lsy"
RUN mkdir -p /usr/lsy &&  echo 'this is lsy file' > /usr/lsy/lsy.html

  

使用命令进行构建

docker build ./ -t my_nginx_1:v1.1

  

 

可以看到,docker会一层层的进行构建。

 

启动镜像:

docker run --rm --name my_nginx_1 -it my_nginx_1:v1.1 /bin/bash

  

 

 

可以看到,容器中确实是执行了RUN指令。

 

5、COPY

将宿主机的文件或者目录拷贝到容器的文件系统中,需相对于Dockerfile的路径。

 

格式:COPY <src> <dest>

文件复制准则:

  1. <src>必须是build上下文的相对路径。
  2. <src>是目录的话,则内部文件或子目录会递归复制,但是目录自身不会被复制
  3. 如果指定多个src,则dest必须是一个目录,且必须以/结尾
  4. 目标路径如果不存在,则会自动创建

例如:把Dockerfile同目录的test.html文件拷贝到容器中的/usr/lsy目录中

FROM nginx
MAINTAINER "lsy"
RUN mkdir -p /usr/lsy &&  echo 'this is lsy file' > /usr/lsy/lsy.html
COPY ./test.html /usr/lsy

  

 

使用docker build对Dockerfile进行构建:

 

启动容器查看文件是否已拷贝:

 

6、ADD

功能与COPY类似,还可以使用url规范从远程位置复制到容器中

 

格式 :ADD <source> <dest>

例如:ADD ./test.html /usr/lsy

ADD //www.python.org/ftp/python/3.5.1/python-3.5.1.exe /temp/python-3.5.1.exe

 

7、WORKDIR

用于为其他Dockerfile指令(如 RUN、CMD)设置一个工作目录,并且还设置用于运行容器映像实例的工作目录。WORKDIR之后的指令都会基于设定的工作目录中运行。

 

格式:WORKDIR 路径

例如:将/usr/lsy设置为工作目录,然后在目录中创建一个a.html文件

FROM nginx
MAINTAINER "lsy"
RUN mkdir -p /usr/lsy
WORKDIR /usr/lsy
RUN touch a.html

  

使用docker build创建镜像

 

运行容器查看:

 

可以看到,进来容器就是在工作目录中,并且目录中有了需要创建的文件。

 

8、CMD

类似于RUN指令,CMD指令也可用于运行任何命令或应用程序,不过,两者的运行时间不同。

RUN指令运行于 镜像创建过程中,而CMD指令运行于基于Dockerfile构建出的镜像启动一个容器时。

CMD指令的目的在于为启动的容器指定默认要运行的程序,且其运行结束后,容器也将终止,不过CMD指令可以被docker run的命令行参数所覆盖。

Dockerfile中可以指定多个CMD命令,但只有最后一个才会生效。

 

格式:CMD <command>

CMD [‘<executable>’,'<param1>’,'<param2>’]

CMD [‘<param1>’,'<param2>’]

前两种语法跟RUN一样

第三种是用于为ENTERPOINT指令提供默认参数。

 

例如:CMD c:\Apache24\bin\httpd.exe -w

CMD [‘/bin/bash’,’-c’,’c:\Apache24\bin\httpd.exe’,’-w’]

 

9、ENTERPOINT

配置容器启动后执行的命令,并且不可被 docker run 提供的参数覆盖。每个 Dockerfile 中只能有一个ENTRYPOINT,当指定多个时,只有最后一个起效。如果有CMD,则CMD的命令被当作参数传递给ENTERPOINT。

不过,docker run命令的–entrypoint选项的参数可以对Dockerfile中的ENTRYPOINT进行覆盖。

Dockerfile中可存在多个 ENTRYPOINT指令,但只有最后一个 才会执行。

 

格式:ENTRYPOINT <command>

ENTRYPOINT [‘<executable>’,'<param1>’,'<param2>’]

 

10、ENV

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

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

 

格式:ENV key1=value1 key2=value2

ENV key value

 

11、ARG

构建参数,作用于ENV相同,不同的是ARG的参数只在构建镜像的时候起作用,也就是docker build的时候。

 

格式:ARG k=v

 

12、EXPOSE

用来指定端口,是容器内的应用可以通过端口与外界交互

作用跟docker run 命令中的 -p 一样

 

格式:EXPOSE 端口

例如:EXPOSE 80

13、VOLUME

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

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

 

格式:VOLUME <路径>

VOLUME [“<路径1>”, “<路径2>”…]

 

14、USER

用于执行后续命令的用户和用户组

 

格式 :USER 用户名[:用户组]

例如:USER root:root

 

15、HEALTHCHECK

用于指定某个程序或者指令来监控 docker 容器服务的运行状态。

 

格式:HEALTHCHECK [OPTIONS] CMD command

HEALTHCHECK NONE

第一个的功能是在容器内部运行一个命令来检查容器的健康状况

第二个的功能是在基础镜像中取消健康检查命令

 

[OPTIONS]的选项支持以下三中选项:

–interval=DURATION 两次检查默认的时间间隔为30秒

–timeout=DURATION 健康检查命令运行超时时长,默认30秒

–retries=N 当连续失败指定次数后,则容器被认为是不健康的,状态为unhealthy,默认次数是3

–start-period=DURATION 容器启动后多长时间开始执行,默认是0s

 

注意:

HEALTHCHECK命令只能出现一次,如果出现了多次,只有最后一个生效。

 

CMD后边的命令的返回值决定了本次健康检查是否成功,具体的返回值如下:

0: success – 表示容器是健康的

1: unhealthy – 表示容器已经不能工作了

2: reserved – 保留值

 

例如:定时 30s PING一下百度,如果PING失败,则返回1

FROM nginx
MAINTAINER "lsy"
HEALTHCHECK --timeout=3s \
        CMD curl -f //localhost/ || exit 1

  

使用docker build构建镜像

 

运行容器,查看日志输出:

 

16、ONBUILD

用于延迟构建命令的执行。简单的说,就是 Dockerfile 里用 ONBUILD 指定的命令,在本次构建镜像的过程中不会执行(假设镜像为 test-build)。当有新的 Dockerfile 使用了之前构建的镜像 FROM test-build ,这是执行新镜像的 Dockerfile 构建时候,会执行 test-build 的 Dockerfile 里的 ONBUILD 指定的命令。

 

格式 :ONBUILD <其它指令>

 

17、STOPSIGNAL

当容器退出时给系统发送什么样的指令

 

格式:STOPSIGNAL 指令

 

===============================

我是Liusy,一个喜欢健身的程序员。

获取更多干货以及最新消息,请关注公众号:上古伪神

如果对您有帮助,点个关注就是对我最大的支持!!!

Tags: