Dockerfile学习笔记

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

通过定义一系列命令和参数，Dockerfile 指导 Docker 构建一个自定义的镜像。

FROM：定制的镜像都是基于FROM指定的镜像。

RUN：执行后面跟着的命令行命令

shell格式：

RUN <命令行命令>
# <命令行命令> 等同于，在终端操作的 shell 命令。

exec格式：

RUN ["可执行文件", "参数1", "参数2"]
# 例如：
# RUN ["./test.php", "dev", "offline"] 等价于 RUN ./test.php dev offline

注意：Dockerfile 的指令每执行一次都会在 docker 上新建一层。所以过多无意义的层，会造成镜像膨胀过大。例如：

FROM centos
RUN yum -y 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 -y install wget \
    && wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz" \
    && tar -xvf redis.tar.gz

构建镜像的命令

docker build -t nginx:v3 .

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

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

由于 docker 的运行模式是 C/S。我们本机是 C，docker 引擎是 S。实际的构建过程是在 docker 引擎下完成的，所以这个时候无法用到我们本机的文件。这就需要把我们本机的指定目录下的文件一起打包提供给 docker 引擎使用。

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

MAINTAINER：指定Dockerfile的作者名字（已弃用）建议使用LABEL指令

LABEL：添加镜像的元数据，使用键值对形式

RUN：在构建过程中镜像中执行的命令

CMD：指定容器创建时的默认命令（可以被覆盖）

ENTRYPOINT：设置容器创建时的主要命令（不可被覆盖）

ENV：在容器内部设置环境变量

ADD：将文件、目录或远程URL复制到镜像中

COPY：将文件或目录复制到镜像中

VOLUME：为容器创建挂载点或声明卷

WORKDIR：设置后续指令的工作目录

USER：设置后续指令的用户上下文

ARG：定义在构建过程中传递给构建器的变量，可使用 "docker build" 命令设置。

ONBUILD：当该镜像被用作另一个构建过程的基础时，添加触发器。

STOPSIGNAL：设置发送给容器以退出的系统调用信号。

HEALTHCHECK：定义周期性检查容器健康状态的命令。

SHELL：覆盖Docker中默认的shell，用于RUN、CMD和ENTRYPOINT指令。

EXPOSE：声明容器运行时监听的特定网络端口。

COPY：将文件或目录复制到镜像中

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

[--chown=<user>:<group>]：可选参数，用户改变复制到容器内文件的拥有者和属组。

<源路径>：源文件或者源目录，这里可以是通配符表达式，

<目标路径>：容器内的指定路径，该路径不用事先建好，路径不存在的话，会自动创建。

ADD：将文件、目录或远程URL复制到镜像中

ADD 指令和 COPY 的使用格类似（同样需求下，官方推荐使用 COPY）。

不同之处在于

• ADD 的优点：在执行 <源文件> 为 tar 压缩文件的话，压缩格式为 gzip, bzip2 以及 xz 的情况下，会自动复制并解压到 <目标路径>。
• ADD 的缺点：在不解压的前提下，无法复制 tar 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。

CMD：指定容器创建时的默认命令（可以被覆盖）

类似于 RUN 指令，用于运行程序，但二者运行的时间点不同:

• CMD 在docker run 时运行。
• RUN 是在 docker build。

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

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

格式：

CMD <shell 命令> 
CMD ["<可执行文件或命令>","<param1>","<param2>",...] 
CMD ["<param1>","<param2>",...]  # 该写法是为 ENTRYPOINT 指令指定的程序提供默认参数

ENTRYPOINT：设置容器创建时的主要命令（不可被覆盖）

类似于 CMD 指令，但其不会被 docker run 的命令行参数指定的指令所覆盖，而且这些命令行参数会被当作参数送给 ENTRYPOINT 指令指定的程序。如果运行 docker run 时使用了 --entrypoint 选项，将覆盖 ENTRYPOINT 指令指定的程序。

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

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

格式：

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

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

FROM nginx

ENTRYPOINT ["nginx", "-c"] # 定参
CMD ["/etc/nginx/nginx.conf"] # 变参 

docker run

容器内会默认运行以下命令，启动主进程。

nginx -c /etc/nginx/nginx.conf

传参运行

docker run  nginx:test -c /etc/nginx/new.conf

容器内

nginx -c /etc/nginx/new.conf

ENV：在容器内部设置环境变量

格式：

ENV <key> <value>
ENV <key1>=<value1> <key2>=<value2>.

ARG：定义在构建过程中传递给构建器的变量，可使用 "docker build" 命令设置

构建参数，与 ENV 作用一致。不过作用域不一样。ARG 设置的环境变量仅对 Dockerfile 内有效，也就是说只有 docker build 的过程中有效，构建好的镜像内不存在此环境变量。

构建命令 docker build 中可以用 --build-arg <参数名>=<值> 来覆盖。

格式

ARG <参数名>[=<默认值>]

VOLUME：为容器创建挂载点或声明卷

定义匿名数据卷。在启动容器时忘记挂载数据卷，会自动挂载到匿名卷。

作用：

• 避免重要的数据，因容器重启而丢失，这是非常致命的。
• 避免容器不断变大。

格式：

VOLUME ["<路径1>", "<路径2>"...]
VOLUME <路径>

在启动容器 docker run 的时候，可以通过 -v 参数修改挂载点。

EXPOSE：声明容器运行时监听的特定网络端口。

• 帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射。
• 在运行时使用随机端口映射时，也就是 docker run -P 时，会自动随机映射 EXPOSE 的端口

格式：

EXPOSE <端口1> [<端口2>...]

WORKDIR：设置后续指令的工作目录

指定工作目录。用 WORKDIR 指定的工作目录，会在构建镜像的每一层中都存在。以后各层的当前目录就被改为指定的目录，如该目录不存在，WORKDIR 会帮你建立目录。

指定工作目录。用 WORKDIR 指定的工作目录，会在构建镜像的每一层中都存在。以后各层的当前目录就被改为指定的目录，如该目录不存在，WORKDIR 会帮你建立目录。

格式：

WORKDIR <工作目录路径>

USER：设置后续指令的用户上下文

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

格式:

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

HEALTHCHECK：定义周期性检查容器健康状态的命令。

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

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

HEALTHCHECK [选项] CMD <命令> : 这边 CMD 后面跟随的命令使用，可以参考 CMD 的用法。

LABEL：指令用来给镜像添加一些元数据（metadata），以键值对的形式

语法格式如下：

LABEL <key>=<value> <key>=<value> <key>=<value> ...