Dockerfile制作镜像的常用指令详解

1.Dockerfile 指令清单

更多更详细指令：官网 Dockerfile reference | Docker Docs

Dockerfile 指令功能FROM指定基础镜像RUN在镜像构建过程中执行命令COPY将文件或目录从构建环境复制到镜像中ADD类似于 COPY，但更强大，支持 URL 和解压缩操作WORKDIR设置工作目录ENV设置环境变量ARG定义构建时的参数EXPOSE声明容器运行时要监听的端口VOLUME创建挂载点，用于持久化数据CMD指定容器启动时要运行的默认命令ENTRYPOINT配置容器启动时执行的命令LABEL添加元数据，用于标记镜像USER设置容器中运行命令的用户SHELL配置 shell 类型

在包含 Dockerfile 文件的目录中执行以下命令：

docker build -t <image_name>:<tag> <path_to_dockerfile_directory>

-t <image_name>:<tag> 用于指定构建的镜像名称及标签。
<path_to_dockerfile_directory> 是 Dockerfile 所在的目录路径。

2. FROM 指令

FROM 指令初始化一个新的构建阶段，并为后续指令设置基础镜像。因此，一个有效的 Dockerfile 必须以 FROM 指令开头。镜像可以是任何有效的镜像。

FROM [–platform=<platform>] <image> [AS <name>]

参数
- <platform>: 构建的 cpu 架构，如 Linux/amd 64，Linux/arm 64。
- <image>: 指定 base image 的名称。
- AS <name>: 指定构建步骤的名称。

3. LABEL 指令

为镜像添加元数据，元数据为键值对的形式。

LABEL <key>=<value> <key>=<value> <key>=<value> …

比如

LABEL author=\”xiaoming\” version=\”1.0\” desc=\”create ubuntu demo1\”

4. COPY 指令

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

COPY [–chown=<user>:<group>] [–chmod=<perms>] <src>… <dest>
# 或
COPY [–chown=<user>:<group>] [–chmod=<perms>] [\”<src>\”,… \”<dest>\”]

<src> 是构建环境中要复制的文件或目录的路径。
<dest> 是要将文件或目录复制到容器中的目标路径。

除了基本的格式之外，COPY 指令还支持一些参数来指定复制行为：

-chown=<user>:<group>：设置文件的所有者和组。例如 -chown=root:root。
–from=<source_stage>：从之前的构建阶段（指定的构建阶段或者镜像）复制文件。这个参数可以让你从一个镜像或者构建阶段中复制文件到当前的镜像。这对于多阶段构建非常有用。

案例：

创建一个 Dockerfile 文件，内容如下。

FROM ubuntu:22.04 as demo1
LABEL author=\”xiaoming\” version=\”1.0\” desc=\”create ubuntu demo1\”
COPY ./index.html /data/web/html/

使用 FROM ubuntu:22.04 as demo1 指令，表示初始化一个新的构建阶段，并以 ubuntu:22.04 镜像作为基础镜像，并将该阶段命名为 demo1。
使用 LABEL 指令，添加元数据信息。author="xiaoming" 表示作者为 "xiaoming"；version="1.0" 表示版本为 "1.0"；desc="create ubuntu demo1" 表示描述为 "create ubuntu demo 1"。
将主机中的当前目录下的 index.html 文件拷贝到容器的 /data/web/html/ 目录中。

5. ENV 指令

ENV <key1>=<value1> <key2>=<value2> …

其中<key>是环境变量的名称，<value>是环境变量的值。这种格式用于设置单个环境变量，也可以使用通配符。

FROM ubuntu:22.04 as demo1
LABEL author=\”xiaoming\” version=\”1.0\” desc=\”create ubuntu demo1\”
ENV MYROOTDIR=/data/web/html/
# 使用通配符引用 MYROOTDIR
COPY ./index.html ${MYROOTDIR}
ENV MYTEST=1

6.WORKDIR

WORKDIR指令用于设置工作目录，即在容器中执行后续命令的默认目录。

WORKDIR <directory>

其中<directory>是要设置为工作目录的路径。可以使用绝对路径或相对路径。如果指定的路径不存在，WORKDIR 指令将创建该目录。

FROM ubuntu:22.04 as demo1
LABEL author=\”xiaoming\” version=\”1.0\” desc=\”create ubuntu demo1\”
# 指定工作目录
WORKDIR /data/src

构建这个镜像，并启动。

WORKDIR 指令的作用是设置容器中执行后续命令的默认工作目录。它影响接下来所有命令执行的上下文环境，使得在Docker 容器中执行命令时不必每次都指定完整的路径。

7. ADD

ADD 指令用于将本地文件、目录、或远程文件 URL 添加到镜像中。它类似于 COPY 指令，但具有更多的功能，比如会它可以解压和下载。

ADD <source> <destination>

其中<source>是要添加到镜像中的文件、目录或 URL，而<destination>是文件系统中的目标路径。

FROM ubuntu:22.04 as demo1

LABEL author=\”xiaoming\” version=\”1.0\” desc=\”create ubuntu demo1\”

WORKDIR /data/src

# 将nginx的源代码下载到当前目录（/data/src）

ADD https://nginx.org/download/nginx-1.24.0.tar.gz .

也可以再进行解压（过程就不展示了）。

FROM ubuntu:22.04 as demo1

LABEL author=\”xiaoming\” version=\”1.0\” desc=\”create ubuntu demo1\”

WORKDIR /data/src

# 将nginx的源代码下载到当前目录（/data/src）

ADD https://nginx.org/download/nginx-1.24.0.tar.gz .

# 解压到当前目录（/data/src）

ADD ./nginx-1.24.0.tar.gz .

8.RUN

RUN 指令用于在镜像构建过程中执行命令。它可以执行任何有效的 shell 命令、可执行文件或脚本。其基本格式为：

RUN <command> && <command> ……

其中<command>是要执行的命令。在 Dockerfile 中可以是任何合法的 shell 命令，例如安装软件包、运行脚本、创建目录等。

FROM ubuntu:22.04 as demo1
LABEL author=\”xiaoming\” version=\”1.0\” desc=\”create ubuntu demo1\”
WORKDIR /data/src
# 将nginx的源代码下载到当前目录（/data/src）
ADD https://nginx.org/download/nginx-1.24.0.tar.gz .
# 执行 cd 与 tar 命令
RUN cd /data/src && tar zxvf nginx-1.24.0.tar.gz