Docker 镜像制作（Dockerfile）

1 Dockerfile 概念

Dockerfile 是什么？
镜像的定制实际上就是定制每一层所添加的配置、文件。如果我们可以把每一层修改、安装、构建、操作的命令都写入一个脚本，用这个脚本来构建、定制镜像,这个脚本就是 Dockerfile。
Dockerfile 是一个文本文件，其内包含了一条条的指令(Instruction)，每一条指令构建一层，因此每一条指令的内容，就是描述该层应当如何构建。

为什么需要 Dockerfile？
可以按照需求自定义镜像：
和 docker commit 一样能够自定义镜像，官方的镜像可以说很少能直接满足
我们应用的，都需要我们自己打包自己的代码进去然后做成对应的应用镜像对外
使用。
很方便的自动化构建，重复执行：
通过 dockerfile 可以自动化的完成镜像构建，而不是像 docker commit 一样，
手动一个命令一个命令执行，而且可以重复执行， docker commit 的话很容易忘
记执行了哪个命令，哪个命令没有执行。
维护修改方便，不再是黑箱操作：
使用 docker commit 意味着所有对镜像的操作都是黑箱操作，生成的镜像也
被称为黑箱镜像,dockerfile 很容易二次开发。
更加标准化，体积可以做的更小：
docker 容器启动后，系统运行会生成很多运行时的文件，如果使用 commit 会
导致这些文件也存储到镜像里面，而且 commit 的时候安装了很多的依赖文件，
没有有效的清理机制的话会导致镜像非常的臃肿。使用 Dockerfile 则会更加标准
化，而且提供多级构建，将编译和构建分开，不会有运行时的多余文件，更加的
标准化。

2 Dockerfile 指令

2.1 FROM

•功能：
￮ FROM 指令用于为镜像文件构建过程指定基础镜像，后续的指令运行于此基础镜像所提供的运行环境；
注意事项
￮ FROM 指令必须是 Dockerfile 中非注释行或者 ARG 之后的第一个指令；
￮实践中，基准镜像可以是任何可用镜像文件，默认情况下， docker build 会在docker 主机上查找指定的镜像文件，在其不存在时，则会自动从 Docker 的公共库 pull 镜像下来。如果找不到指定的镜像文件， docker build 会返回一个错误信息；
￮ FROM 可以在一个 Dockerfile 中出现多次，如果有需求在一个 Dockerfile 中创建多个镜像,或将一个构建阶段作为另一个的依赖。
￮如果 FROM 语句没有指定镜像标签，则默认使用 latest 标签。

FROM [--platform=<platform>] <image> [AS <name>]
FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]
FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]

• 参数
￮ <platform>:构建的 cpu 架构，如 linux/amd64, linux/arm64,windows/amd64
￮ <image>：指定作为 base image 的名称；
￮ <tag>： base image 的标签，省略时默认 latest；
￮ <digest>：是镜像的哈希码；
￮ AS <name>: 指定构建步骤的名称，配合 COPY --from=<name>可以完成多级构建；

实操：

打开Dockerfile文件

vim Dockerfile

编辑一下代码

FROM ubuntu:22.04 as baseOs

执行命令

docker build -t testimage:v0.1 .

2.2 LABEL

• 功能
￮为镜像添加元数据，元数据是 kv 对形式;

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

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"

执行命令

docker build -t testimage:v0.2 .

docker inspect testimage:v0.2

获得如下字段

2.3 COPY

• 功能
￮用于从 docker 主机复制新文件或者目录至创建的新镜像指定路径中。

COPY [--chown=<user>:<group>] <src>... <dest>
COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]

• 参数
￮ <src>：要复制的源文件或目录，支持使用通配符；
￮ <dest>：目标路径，即正在创建的 image 的文件系统路径；建议<dest>使用绝对路径，否则， COPY 指定以 WORKDIR 为当前路径在路径中有空白字符时，通常使用第 2 种格式；
￮ --chown：修改用户和组
￮ --from <name>可选项 :
▪ 可以从之前构建的步骤中拷贝内容，结合 FROM .. AS <name>往往用作多级构建
• 注意事项
￮ <src>必须是 build 上下文中的路径，不能是其父目录中的文件；
￮如果<src>是目录，则其内部文件或子目录会被递归复制，但<src>目录自身不会被复制；
￮如果指定了多个<src>，或在<src>中使用了通配符，则<dest>必须是一个目录，且必须以 / 结尾；
￮如果<dest>事先不存在，它将会被自动创建，这包括父目录路径。

实操：

随便创建一个文件

touch code.cc

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
COPY code.cc /data/code/

执行命令

docker build -t testimage:v0.3 .

docker run -it --rm testimage:v0.3 ls /data/code

发现该目录下果然拷贝有code.cc

2.4 ENV

• 功能
￮用于为镜像定义所需的环境变量，并可被 Dockerfile 文件中位于其后的其它指令(如 ENV、 ADD、 COPY 等)所调用
￮调用格式为$variable_name 或 ${variable_name}

ENV <key>=<value> ...

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
COPY code.cc ${DIR}

执行命令

docker build -t testimage:v0.4 .

效果同2.3故省略后续操作

2.5 WORKDIR

• 功能
￮为 Dockerfile 中所有的 RUN、 CMD、 ENTRYPOINT、 COPY 和 ADD 指定设定工作目录

WORKDIR /path/to/workdir

• 注意事项
￮默认的工作目录是/
￮如果提供了相对路径，它将相对于前一条 WORKDIR 指令的路径。
￮ WORKDIR 指令可以解析先前使用设置的环境变量 ENV。

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
COPY code.cc ${DIR}
WORKDIR /usr/local

执行命令

docker build -t testimage:v0.5 .

pwd查看虚拟机工作目录

2.6 ADD

功能
￮ ADD 指令类似于 COPY 指令， ADD 支持使用 TAR 文件和 URL 路径,会自动完成解压和下载；

ADD [--chown=<user>:<group>] <src>... <dest>
ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

• 参数
￮ <src>：要复制的源文件或目录，支持使用通配符；
￮ <dest>：目标路径，即正在创建的 image 的文件系统路径；建议<dest>使用绝对路径，否则， ADD 指定以 WORKDIR 为其实路径；在路径中有空白字符时，通常使用第 2 种格式；
￮ --chown：修改用户和组

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
ENV NGINX_VERSION="nginx-1.22.1"
COPY code.cc ${DIR}
WORKDIR /usr/local
ADD https://nginx.org/download/${NGINX_VERSION}.tar.gz ./src

执行命令

docker build -t dockerimage:v0.6 .

最后效果

如果指定的是URL它的压缩包没有被解压，但是如果是宿主机上的压缩包就会被解压；

2.7 RUN

• 功能
￮用于指定 docker build 过程中运行的程序，其可以是任何命令；

#shell form
RUN <command>
#exec form 推荐这种
RUN ["executable", "param1", "param2"]

• 参数
￮第一种格式中， <command>通常是一个 shell 命令，且以“/bin/sh -c”来运行它,Windows 默认为 cmd /S /C。如果一个脚本 test.sh 不能自己执行，必须要/bin/sh -c test.sh 的方式来执行，那么，如果使用 RUN 的 shell 形式，最后得到的命令相当于：
/bin/sh -c "/bin/sh -c 'test.sh'"
￮第二种语法格式中的参数是一个 JSON 格式的数组，其中<executable>为要运行的命令，后面的 <paramN>为传递给命令的选项或参数；然而，此种格式指定的命令不会以“/bin/sh -c”来发起，因此常见的 shell 操作如变量替换以及通配符(?,*等)替换将不会进行；不过，如果要运行的命令依赖于此 shell 特性的话，可以将其替换为类似下面的格式。
RUN ["/bin/bash", "-c", "<executable>","<param1>"]

实操

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
ENV NGINX_VERSION="nginx-1.22.1"
COPY code.cc ${DIR}
WORKDIR /usr/local
ADD https://nginx.org/download/${NGINX_VERSION}.tar.gz ./src
RUN cd ./src && tar zxvf ${NGINX_VERSION}.tar.gz

执行命令

docker build -t testimage:v0.7 .

查看效果

2.8 CMD

• 功能
￮类似于 RUN 指令， CMD 指令也可用于运行任何命令或应用程序，不过，二者的运行时间点不同
￮ RUN 指令运行于映像文件构建过程中，而 CMD 指令运行于基于 Dockerfile构建出的新映像文件启动一个容器时
￮ CMD 指令的首要目的在于为启动的容器指定默认要运行的程序，且其运行结束后，容器也将终止；不过， CMD 指定的命令其可以被 docker run 的命令行选项所覆盖
￮在 Dockerfile 中可以存在多个 CMD 指令，但仅最后一个会生效

CMD ["executable","param1","param2"] (exec form, this is the
preferred form)
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
CMD command param1 param2 (shell form)

2.9 EXPOSE

• 功能
￮用于为容器声明打开指定要监听的端口以实现与外部通信
￮该 EXPOSE 指令实际上并不发布端口。它充当构建图像的人和运行容器的人之间的一种文档，关于要发布哪些端口。要在运行容器时实际发布端口，使用-p 参数发布和映射一个或多个端口，或者使用-Pflag 发布所有暴露的端口并将它们映射宿主机端口；

EXPOSE <port> [<port>/<protocol>...]

• 参数
￮ <protocol>： tcp/udp 协议
￮ <port>：端口

2.10 ENTRYPOINT

• 功能
￮用于指定容器的启动入口

#exec from
ENTRYPOINT ["executable", "param1", "param2"]
# shell form
ENTRYPOINT command param1 param2

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
ENV NGINX_VERSION="nginx-1.22.1"
COPY code.cc ${DIR}
WORKDIR /usr/local
ADD https://nginx.org/download/${NGINX_VERSION}.tar.gz ./src
RUN cd ./src && tar zxvf ${NGINX_VERSION}.tar.gz
#1.安装 build-essential 构建工具
#2.安装依赖包 libpcre3 libpcre3-dev zlib1g-dev 依赖库
RUN apt-get update -y && apt install -y build-essential libpcre3 libpcre3-dev zlib1g-dev
#3.进入 nginx 目录
#4.执行编译和构建
RUN cd ./src/${NGINX_VERSION} \
&& ./configure --prefix=/usr/local/nginx \
&& make && make install
ENTRYPOINT ["/usr/local/nginx/sbin/nginx","-g daemon off;"]

2.11 ARG

• 功能
￮ ARG 指令类似 ENV，定义了一个变量；区别于 ENV：用户可以在构建时
docker build --build-arg <varname> = <value> 进行对变量的修改； ENV 不可以；
￮如果用户指定了未在 Dockerfile 中定义的构建参数，那么构建输出警告。

ARG <name>[=<default value>]

• 注意事项
￮ Dockerfile 可以包含一个或多个 ARG 指令
￮ ARG 支持指定默认值
￮使用范围：定义之后才能使用，定义之前为空

￮ ENV 和 ARG 同时存在， ENV 会覆盖 ARG

实操：
编辑Dockerfile

ARG UBUNTU_VERSION=22.04
FROM ubuntu:${UBUNTU_VERSION} as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
ENV NGINX_VERSION="nginx-1.22.1"
COPY code.cc ${DIR}
WORKDIR /usr/local
ADD https://nginx.org/download/${NGINX_VERSION}.tar.gz ./src
RUN cd ./src && tar zxvf ${NGINX_VERSION}.tar.gz
#1.安装 build-essential 构建工具
#2.安装依赖包 libpcre3 libpcre3-dev zlib1g-dev 依赖库
RUN apt-get update -y && apt install -y build-essential libpcre3 libpcre3-dev zlib1g-dev
#3.进入 nginx 目录
#4.执行编译和构建
RUN cd ./src/${NGINX_VERSION} \
&& ./configure --prefix=/usr/local/nginx \
&& make && make install
ENTRYPOINT ["/usr/local/nginx/sbin/nginx","-g daemon off;"]

执行命令

docker build --build-arg UBUNTU_VERSION=22.10 -t testimage:v0.9 .

如果拉取镜像较慢可以先docker pull将ubuntu22.10拉取到本地

2.12 VOLUME（了解）

• 功能
￮用于在 image 中创建一个挂载点目录
￮通过 VOLUME 指令创建的挂载点，无法指定主机上对应的目录，是自动生成的。

VOLUME <mountpoint>
VOLUME ["<mountpoint>"]

• 参数
￮ mountpoint:挂载点目录
￮注意事项
▪ 如果挂载点目录路径下此前有文件存在， docker run 命令会在卷挂载完
成后将此前的所有文件复制到新挂载的卷中
▪ 其实 VOLUME 指令只是起到了声明了容器中的目录作为匿名卷，但是并
没有将匿名卷绑定到宿主机指定目录的功能。
▪ volume 只是指定了一个目录，用以在用户忘记启动时指定-v 参数也可以
保证容器的正常运行。比如 mysql，你不能说用户启动时没有指定-v，然后
删了容器，就把 mysql 的数据文件都删了，那样生产上是会出大事故的，所
以 mysql 的 dockerfile 里面就需要配置 volume，这样即使用户没有指定-v，
容器被删后也不会导致数据文件都不在了。还是可以恢复的。
▪ volume 与-v 指令一样，容器被删除以后映射在主机上的文件不会被删除。
▪ 如果-v 和 volume 指定了同一个位置，会以-v 设定的目录为准，其实
volume 指令的设定的目的就是为了避免用户忘记指定-v 的时候导致的数据丢
失，那么如果用户指定了-v，自然而然就不需要 volume 指定的位置了。

2.13 SHELL（了解）

• 功能
￮ SHELL 指令允许覆盖用于 shell 命令形式的默认 shell。
#Linux 上的默认 shell 是["/bin/sh"， "-c"]
#在 Windows 上是["cmd"， "/S"，"/C"]
￮ SHELL 指令必须以 JSON 格式写入 Dockerfile。

SHELL ["executable", "parameters"]

• 参数
￮ executable： shell 可执行文件的位置
￮ parameters： shell 执行的参数
￮注意事项
▪ SHELL 指令可以多次出现。
▪ 每个 SHELL 指令都会覆盖所有先前的 SHELL 指令，并影响所有后续指令。
▪ 该 SHELL 指令在 Windows 上特别有用，因为 windows 行有两种不同的
shell： cmd 和 powershell

2.14 USER (了解)

• 功能
￮用于指定运行 image 时的或运行 Dockerfile 中任何 RUN、 CMD 或
ENTRYPOINT 指令定的程序时的用户名或 UID
￮默认情况下， container 的运行身份为 root 用户

USER <user>[:<group>]
USER <UID>[:<GID>]

• 参数
￮ user:用户
￮ group：用户组
￮ uid:用户 id
￮ gid:组 id
￮注意事项
▪ <UID>可以为任意数字，但实践中其必须为/etc/passwd 中某用户的有效
UID,否则将运行失败

2.15 HEALTHCHECK（了解）

• 功能
￮ HEALTHCHECK 指令告诉 Docker 如何测试容器以检查它是否仍在工作。
￮即使服务器进程仍在运行，这也可以检测出陷入无限循环且无法处理新连接
的 Web 服务器等情况

HEALTHCHECK [OPTIONS] CMD command (check container health by
running a command inside the container)
HEALTHCHECK NONE (disable any healthcheck inherited from the base
image)

• 参数
￮ OPTIONS 选项有：
▪ --interval=DURATION (default: 30s)：每隔多长时间探测一次，默认 30
秒 ▪
-- timeout= DURATION (default: 30s)：服务响应超时时长，默认 30 秒
▪ --start-period= DURATION (default: 0s)：服务启动多久后开始探测，默
认 0 秒
▪ --retries=N (default: 3)：认为检测失败几次为宕机，默认 3 次
￮返回值
▪ 0：容器成功是健康的，随时可以使用
▪ 1：不健康的容器无法正常工作
▪ 2：保留不使用此退出代码

#样例
HEALTHCHECK --interval=5m --timeout=3s \
CMD curl -f http://localhost/ || exit 1

2.16 ONBUILD

• 功能
￮用于在 Dockerfile 中定义一个触发器
￮以该 Dockerfile 中的作为基础镜像由 FROM 指令在 build 过程中被执行时，
将会“触发”创建其 base image 的 Dockerfile 文件中的 ONBUILD 指令定义的触
发器

#样例
ONBUILD ADD . /app/src

3 docker build

• 功能

docker build 命令用于使用 Dockerfile 创建镜像。

docker build [OPTIONS] PATH | URL | -

• 关键参数
￮ --build-arg=[] :设置镜像创建时的变量；
￮ -f :指定要使用的 Dockerfile 路径；
￮ --label=[] :设置镜像使用的元数据；
￮ --no-cache :创建镜像的过程不使用缓存；
￮ --pull :尝试去更新镜像的新版本；
￮ --quiet, -q :安静模式，成功后只输出镜像 ID；
￮ --tag, -t: 镜像的名字及标签，通常 name:tag 或者 name 格式；可以在一次构
建中为一个镜像设置多个标签。
￮ --network: 默认 default。在构建期间设置 RUN 指令的网络模式