Docker-Dockerfile

一、Dockerfile 详解

什么是 Dockerfile？
Dockerfile 是一个用来构建镜像的文本文件，文本内容包含了一条条构建镜像所需的指令和说明。

1. FROM 指定基础镜像

所谓定制镜像，那一定是以一个镜像为基础，在其上进行定制。比如说指定 centos 为基础镜像，再进行修改，基础镜像是必须指定的。而 FROM 就是指定 基础镜像，因此一个 Dockerfile 中 FROM 是必备的指令，并且必须是第一条指令。
Docker 还有一个特殊的镜像 scratch，这个镜像是虚拟的，表示空白镜像

FROM centos

2. RUN 执行命令

RUN 指令是用来执行命令行命令的。由于命令行的强大能力，RUN 指令在定制镜像时是最常用的指令之一。其格式有两种（我比较常用shell格式的，因为比较好理解）：

1.shell 格式：RUN <命令>，就像直接在命令行中输入的命令一样。刚才写的 Dockerfile 中的 RUN 指令就是这种格式。

RUN mkdir /a

2.exec 格式：RUN ["可执行文件", "参数1", "参数2"]，这更像是函数调用中的格式。

RUN ["executable", "param1", "param2"]

所以在使用shell格式的时候，多个命令可以用\续行符
注意：续行符后面不可以有任何东西

RUN /bin/bash -c 'source $HOME/.bashrc; \
 echo $HOME'

Dockerfile 中每一个指令都会建立一层，RUN 也不例外。每一个 RUN 的行为，就和刚才我们手工建立镜像的过程一样：新建立一层，在其上执行这些命令，执行结束后，commit 这一层的修改，构成新的镜像。
Union FS 是有最大层数限制的，比如 AUFS，曾经是最大不得超过 42 层，现在是不得超过 127 层。

FROM centos
RUN yum install wget
RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz"
RUN tar -xvf redis.tar.gz
以上执行会创建 3 层镜像。可简化为以下格式：
FROM centos
RUN yum install wget; \
     wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz"; \
     tar -xvf redis.tar.gz

3. 开始构建镜像

在 Dockerfile 文件的存放目录下，执行构建动作。

以下示例，通过目录下的 Dockerfile 构建一个 centos7:1（镜像名称:镜像标签）。

注：最后的 . 代表本次执行的上下文路径

命令语法格式：
docker bulid -t 仓库名/镜像名:tag <上下文路径/URL/->

[root@bogon ~]# vim Dockerfile
[root@bogon ~]# cat Dockerfile 
FROM centos:7
RUN mkdir /a
[root@bogon ~]# docker build -t centos7:1 .
Sending build context to Docker daemon  33.28kB
Step 1/2 : FROM centos:7
 ---> 8652b9f0cb4c
Step 2/2 : RUN mkdir /a     #执行了RUN命令
 ---> Running in f5dc2aaff862
Removing intermediate container f5dc2aaff862
 ---> bf46894cf65f
Successfully built bf46894cf65f
Successfully tagged centos7:1

4. 上下文路径

刚刚有提到指令最后一个 . 是上下文路径，那么什么是上下文路径呢？

上下文路径，是指 docker 在构建镜像，有时候想要使用到本机的文件（比如复制），docker build 命令得知这个路径后，会将路径下的所有内容打包。

如果未说明最后一个参数，那么默认上下文路径就是 Dockerfile 所在的位置。

注意：上下文路径下不要放无用的文件，因为会一起打包发送给 docker 引擎，如果文件过多会造成过程缓慢。

二、指令详情

LABEL 指令

LABEL 指令用于指定一个镜像的描述信息

该LABEL指令将元数据添加到镜像中。

LABEL是一个键值对。

LABEL maintainer="yangge@qf.com"
LABEL "com.example.vendor"="ACME Incorporated"
LABEL version="1.0"
LABEL description="This text illustrates \
that label-values can span multiple lines."

1. COPY 复制

复制指令，从上下文目录中复制文件或者目录到容器里指定路径。
格式：

COPY [--chown=<user>:<group>] <源路径1>...  <目标路径>
COPY [--chown=<user>:<group>] ["<源路径1>",...  "<目标路径>"]

[--chown=<user>:<group>]：可选参数，用户改变复制到容器内文件的拥有者和属组。
<源路径>：源文件或者源目录，这里可以是通配符表达式，其通配符规则要满足 Go 的 filepath.Match 规则。
<目标路径>：容器内的指定路径，该路径不用事先建好，路径不存在的话，会自动创建。例如：

COPY hom* /mydir/
COPY hom?.txt /mydir/

2. ADD

ADD 指令和 COPY 的使用格式一致（同样需求下，官方推荐使用 COPY）。功能也类似，不同之处如下：
ADD 的优点：在执行 <源文件> 为 tar 压缩文件的话，压缩格式为 gzip, bzip2 以及 xz 的情况下，会自动复制并解压到 <目标路径>。
ADD 的缺点：在不解压的前提下，无法复制 tar 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。

ADD hom* /mydir/
ADD hom?.txt /mydir/

3. CMD

类似于 RUN 指令，用于运行程序，但二者运行的时间点不同:
CMD 在docker run 时运行。
RUN 是在 docker build。

作用：为启动的容器指定默认要运行的程序，程序运行结束，容器也就结束。CMD 指令指定的程序可被 docker run 命令行参数中指定要运行的程序所覆盖。

注意：如果 Dockerfile 中如果存在多个 CMD 指令，仅最后一个生效。

格式：
shell格式

CMD <shell 命令> 
CMD systemctl start nginx

exec格式
为 ENTRYPOINT 指令指定的程序提供默认参数

CMD ["<可执行文件或命令>","<param1>","<param2>",...] 
CMD ["sh" "-c" "systemctl start nginx"]

4. ENTRYPOINT

类似于 CMD 指令，但其不会被 docker run 的命令行参数指定的指令所覆盖，而且这些命令行参数会被当作参数送给 ENTRYPOINT 指令指定的程序。

但是, 如果运行 docker run 时使用了 --entrypoint 选项，将覆盖 CMD 指令指定的程序。

优点：在执行 docker run 的时候可以指定 ENTRYPOINT 运行所需的参数。

注意：如果 Dockerfile 中如果存在多个 ENTRYPOINT 指令，仅最后一个生效。

格式：

ENTRYPOINT ["<executeable>","<param1>","<param2>",...]

可以搭配 CMD 命令使用：一般是变参才会使用 CMD ，这里的 CMD 等于是在给 ENTRYPOINT 传参，以下示例会提到。

示例：

FROM centos:7
ENTRYPOINT ["nginx", "-c"] # 定参
CMD ["/etc/nginx/nginx.conf"] # 变参 
构建镜像时就会变成 ["nginx", "-c"，"/etc/nginx/nginx.conf"]

5. ENV

设置环境变量，定义了环境变量，那么在后续的指令中，就可以使用这个环境变量。

格式：

ENV <key1>=<value1> <key2>=<value2>...
或者
ENV <key1>=<value1> \
<key2>=<value2>

以下示例设置 user = shark ， 在后续的指令中可以通过 $user 引用：

ENV user shark
RUN useradd $user

6. USER

用于指定执行后续命令的用户和用户组，这边只是切换后续命令执行的用户（用户和用户组必须提前已经存在）。

格式：

USER <用户名>[:<用户组>]

7. WORKDIR

用于声明当前的工作目录，以后各层的当前目录就被改为指定的目录。

格式为 WORKDIR <工作目录路径>。

如该目录不存在，WORKDIR 会帮你建立目录。

WORKDIR /a/b

8. HEALTHCHECK 健康检查指令

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

HEALTHCHECK [选项] CMD <命令>：设置检查容器健康状况的命令
HEALTHCHECK NONE：如果基础镜像有健康检查指令，使用这行可以屏蔽掉其健康检查指令

初始状态会为 starting

在 HEALTHCHECK 指令检查成功后变为 healthy

如果连续一定次数失败，则会变为 unhealthy。

HEALTHCHECK 支持下列选项：

--interval=<间隔>：两次健康检查的间隔，默认为 30 秒；
--timeout=<时长>：健康检查命令运行超时时间，如果超过这个时间，本次健康检查就被视为失败，默认 30 秒；
--retries=<次数>：当连续失败指定次数后，则将容器状态视为 unhealthy，默认 3 次。
--start-period=<时长>: 容器的初始化实长，默认0秒，不计入健康检测时间内。
和 CMD, ENTRYPOINT 一样，HEALTHCHECK 在 Dockerfile 中只可以出现一次，如果写了多个，只有最后一个生效。

示例：

FROM nginx
COPY index.html /usr/share/nginx/html/index.html
HEALTHCHECK --interval=5s\
 --timeout=3s \
 CMD curl -fs \
            http://localhost || exit 1

9. ONBUILD

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

格式：

ONBUILD <其它指令>

更多资料请参考官网：
https://docs.docker.com/engine/reference/builder/

https://docs.docker.com/develop/develop-images/dockerfile_best-practices/