Dockerfile详解

Posted 2021-01-23 skyflask

一、Dockerfile 概念

1、Dockerfile是什么

Docker 镜像是一个特殊的文件系统，除了提供容器运行时所需的程序、库、资源、配置等文件外，还包含了一些为运行时准备的一些配置参数（如匿名卷、环境变量、用户等）。镜像不包含任何动态数据，其内容在构建之后也不会被改变。

镜像的定制实际上就是定制每一层所添加的配置、文件。如果我们可以把每一层修改、安装、构建、操作的命令都写入一个脚本，用这个脚本来构建、定制镜像，那么之前提及的无法重复的问题、镜像构建透明性的问题、体积的问题就都会解决。这个脚本就是 Dockerfile。

Dockerfile 是一个文本文件，其内包含了一条条的指令(Instruction)，每一条指令构建一层，因此每一条指令的内容，就是描述该层应当如何构建。有了 Dockerfile，当我们需要定制自己额外的需求时，只需在 Dockerfile 上添加或者修改指令，重新生成 image 即可，省去了敲命令的麻烦。

二、Dockerfile构建方式

Docker通过对Dockerfile中的一系列指令的顺序解析实现自动镜像构建，构建方式：

1. 通过使用build命令，根据Dockerfie的命令来构建镜像，默认加载当前目录下的Dockerfile文件
2. 通过源代码路径的方式，即指定Dockerfile文件位置，比如Git仓库位置
3. 通过标准输入流的方式

通过源代码路径方式

• Dockerfile需要放置在项目的根目录位置
• 在构建的时候，Dockerfile client会把整个context打包发送到Docker Server端，然后由server端负责build镜像，在构建成功后，会删除context目录
• docker build -t {镜像名字} {项目路径可以是相对路径}

　　

通过标准输入流方式

• 通过标准输入流的方式获取Dockerfile的内容
• client不会打包上传context目录，因此对于一些ADD、COPY等涉及host本地文件复制的操作不能够支持
• docker build -t {镜像名字} - < Dockerfile路径

 

通过build命令

• 这是最常用的方式，docker build -t {镜像名字} {项目路径可以是相对路径，也可以是网络文件}
• docker build -t="xuequn/nginx:v1" [email protected]:loveliuli/custom_dockerfile
• 注意：custom_dockerfile目录下必须存在Dockerfile文件才行！

三、构建缓存

• Dockerfile中的每一个指令执行完毕后，都会提交为一个image，这样保证了指令之间不会有影响
• Dockerfile会尽可能尝试重用之前已经构建的镜像
• 可以通过在build命令中增加--no-cache的方式来禁用这个cache

四、Dockerfile常用指令

• 只支持Docker自己定义的一套指令，不支持自定义
• 大小写不敏感，但是建议全部使用大写
• 根据Dockerfile的内容顺序执行

Dockerfile常用指令如下：

 

FROM：

　　FROM {base镜像}

　　必须放在DOckerfile的第一行，表示从哪个baseimage开始构建

 

MAINTAINER：

　　可选的，用来标识image作者的地方

 

RUN：

　　每一个RUN指令都会是在一个新的container里面运行，并提交为一个image作为下一个RUN的base

　　一个Dockerfile中可以包含多个RUN，按定义顺序执行

　　RUN支持两种运行方式：

　　　　RUN <cmd> 这个会当作/bin/sh -c “cmd” 运行

　　　　RUN [“executable”，“arg1”，。。]，Docker把他当作json的顺序来解析，因此必须使用双引号，而且executable需要是完整路径

 

　　RUN 都是启动一个容器、执行命令、然后提交存储层文件变更。第一层 RUN command1 的执行仅仅是当前进程，一个内存上的变化而已，其结果不会造成任何文件。而到第二层的时候，启动的是一个全新的容器，跟第一层的容器更完全没关系，自然不可能继承前一层构建过程中的内存变化。而如果需要将两条命令或者多条命令联合起来执行需要加上&&。如：cd /usr/local/src && wget xxxxxxx

 

CMD：

　　CMD的作用是作为执行container时候的默认行为（容器默认的启动命令）

　　当运行container的时候声明了command，则不再用image中的CMD默认所定义的命令

　　一个Dockerfile中只能有一个有效的CMD，当定义多个CMD的时候，只有最后一个才会起作用

 

CMD定义的三种方式：

　　CMD <cmd> 这个会当作/bin/sh -c "cmd"来执行

　　CMD ["executable","arg1",....]

　　CMD ["arg1","arg2"]，这个时候CMD作为ENTRYPOINT的参数

 

EXPOSE 声明端口

　　格式为 EXPOSE <端口1> [<端口2>...]。

　　EXPOSE 指令是声明运行时容器提供服务端口，这只是一个声明，在运行时并不会因为这个声明应用就会开启这个端口的服务。在 Dockerfile 中写入这样的声明有两个好处，一个是帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射；另一个用处则是在运行时使用随机端口映射时，也就是 docker run -P 时，会自动随机映射 EXPOSE 的端口。

 

entrypoint：

　　entrypoint的作用是，把整个container变成了一个可执行的文件，这样不能够通过替换CMD的方法来改变创建container的方式。但是可以通过参数传递的方法影响到container内部

　　每个Dockerfile只能够包含一个entrypoint，多个entrypoint只有最后一个有效

　　当定义了entrypoint以后，CMD只能够作为参数进行传递

 

entrypoint定义方式：

　　entrypoint ["executable","arg1","arg2"]，这种定义方式下，CMD可以通过json的方式来定义entrypoint的参数，可以通过在运行container的时候通过指定command的方式传递参数

　　entrypoint <cmd>，当作/bin/bash -c "cmd"运行命令

 

ADD & COPY：

　　当在源代码构建的方式下，可以通过ADD和COPY的方式，把host上的文件或者目录复制到image中

　　ADD和COPY的源必须在context路径下

　　当src为网络URL的情况下，ADD指令可以把它下载到dest的指定位置，这个在任何build的方式下都可以work

　　ADD相对COPY还有一个多的功能，能够进行自动解压压缩包

 

ENV：

　　ENV key value

　　用来设置环境变量，后续的RUN可以使用它所创建的环境变量

　　当创建基于该镜像的container的时候，会自动拥有设置的环境变量

 

WORKDIR：

　　用来指定当前工作目录（或者称为当前目录）

　　当使用相对目录的情况下，采用上一个WORKDIR指定的目录作为基准

 

USER：

　　指定UID或者username，来决定运行RUN指令的用户

 

ONBUILD：

　　ONBUILD作为一个trigger的标记，可以用来trigger任何Dockerfile中的指令

　　可以定义多个ONBUILD指令

　　当下一个镜像B使用镜像A作为base的时候，在FROM A指令前，会先按照顺序执行在构建A时候定义的ONBUILD指令

　　ONBUILD <DOCKERFILE 指令> <content>

 

VOLUME：

　　用来创建一个在image之外的mount point，用来在多个container之间实现数据共享

　　运行使用json array的方式定义多个volume

　　VOLUME ["/var/data1","/var/data2"]

　　或者plain text的情况下定义多个VOLUME指令