【docker】使用 Dockerfile 构建镜像

一、什么是Dockerfile

Dockerfile 是用于构建 Docker 镜像的文本文件。它包含了一系列的指令，用于描述如何构建镜像的步骤和配置。

通过编写 Dockerfile，您可以定义镜像的基础环境、安装软件包、复制文件、设置环境变量等操作。Dockerfile 提供了一种可重复、可自动化的方式来构建镜像，使得您可以轻松地创建和部署应用程序的容器化版本。

Dockerfile 的编写非常灵活，您可以根据自己的需求和项目的特点来定义构建镜像的步骤和配置。通过使用 Dockerfile，您可以将整个构建过程以代码的形式进行版本控制，并且可以轻松地在不同的环境中重复构建相同的镜像。

Dockerfile的基本结构包括四个部分：基础镜像信息、维护者信息、镜像操作指令和容器启动时执行指令。

Docker以从上到下的顺序运行Dockerfile的指令。为了指定基本映像，第一条指令必须是FROM。一个声明以“#”字符开头则被视为注释。

在Dockerfile中可以使用多种指令，例如RUN、CMD、FROM、EXPOSE、ENV等。这些指令可以用来定义镜像的操作系统、软件安装、环境变量等。

一旦编写好 Dockerfile，您可以使用 Docker 命令来构建镜像。通过运行 docker build 命令并指定 Dockerfile 的路径，Docker 引擎将根据 Dockerfile 中的指令逐步执行构建过程，生成一个新的镜像。

总结来说，Dockerfile 是一个用于定义构建 Docker 镜像的文本文件，它提供了一种可重复、可自动化的方式来构建和配置镜像，使得容器化应用程序的构建和部署更加简单和可靠。

二、Dockerfile 中常用的指令

指令	说明
FROM	指定基础镜像
MAINTAINER	设置维护者信息
RUN	在镜像中执行命令
CMD	指定容器启动时要执行的命令
ENTRYPOINT	与 CMD 类似，但不会被 docker run 命令行参数覆盖
COPY	复制文件或目录到镜像中
ADD	复制文件或目录到镜像中，支持远程 URL 和解压缩功能
ENV	设置环境变量
ARG	定义构建时的变量，可以通过 --build-arg 参数传递
WORKDIR	设置工作目录
EXPOSE	声明容器运行时需要监听的端口
USER	指定运行容器时的用户名或 UID
HEALTHCHECK	定义容器的健康检查命令
VOLUME	声明容器中的挂载点
LABEL	为镜像添加元数据

这些指令可以根据需要灵活组合，构建出符合需求的 Docker 镜像。请注意，Dockerfile 中的指令顺序很重要，因为每个指令都会创建一个新的镜像层，而后续的指令将基于前面的镜像层进行操作。

更详细的指令说明和用法，请参考 Docker 官方文档：https://docs.docker.com/engine/reference/builder/

三、Dockerfile 使用示例

1、以nginx为例，通过Dockerfile构建镜像

以下是一个简单的 Dockerfile 示例，以构建一个基于 Nginx 的镜像：

# 使用基础镜像
FROM nginx:latest

# 复制自定义配置文件到镜像中
COPY nginx.conf /etc/nginx/nginx.conf

# 复制静态文件到镜像中
COPY static /usr/share/nginx/html

# 暴露容器的80端口
EXPOSE 80

# 设置容器启动时执行的命令
CMD ["nginx", "-g", "daemon off;"]

在这个示例中，我们选择了一个基于最新版本的 Nginx 镜像作为基础镜像。然后，我们将自定义的 nginx.conf 配置文件复制到镜像中的 /etc/nginx/nginx.conf 路径下。接下来，我们将静态文件复制到镜像中的 /usr/share/nginx/html 路径下。然后，我们使用 EXPOSE 指令来声明容器运行时需要监听的端口，这里是80端口。最后，我们使用 CMD 指令来指定容器启动时要执行的命令，即运行 Nginx 并保持守护进程模式。

您可以将这个 Dockerfile 文件与您的 Nginx 配置文件和静态文件放在同一个目录下，并使用以下命令构建镜像：

docker build -t mynginx .

然后，您可以使用以下命令运行容器：

docker run -d -p 80:80 mynginx

这将启动一个容器，并将容器的80端口映射到主机的80端口，从而可以通过主机的80端口访问 Nginx 服务。

请注意，这只是一个简单的示例，实际的 Dockerfile 可能会更复杂，根据您的项目需求进行相应的配置和调整。

2、以Java Springboot项目为例

当您在Java中使用Spring Boot项目时，可以使用以下示例Dockerfile来构建和运行您的应用程序：

# 使用基础的Java镜像
FROM openjdk:8-jdk-alpine

# 定义ARG指令传入jar包名称和文件路径
ARG JAR_FILE
ARG APP_HOME=/app

# 创建应用目录
RUN mkdir -p ${APP_HOME}

# 将jar包复制到应用目录
COPY ${JAR_FILE} ${APP_HOME}/app.jar

# 设置工作目录
WORKDIR ${APP_HOME}

# 暴露端口
EXPOSE 8080

# 运行Spring Boot应用
CMD ["java", "-jar", "app.jar"]

使用该Dockerfile构建镜像时，可以通过–build-arg参数传入jar包名称和文件路径，例如：

docker build -t my-springboot-app --build-arg JAR_FILE=my-app.jar .

这将构建一个名为my-springboot-app的镜像，并将my-app.jar复制到镜像中的/app目录下。然后，可以通过运行该镜像来启动Spring Boot应用程序：

docker run -d -p 8080:8080 my-springboot-app

这将在本地的8080端口上运行您的Spring Boot应用程序。

3、多阶段构建示例（多次FROM）

在Dockerfile中，FROM指令用于指定基础镜像。虽然在一个Dockerfile中只能有一个FROM指令作为起点，但您可以使用多个FROM指令来构建多个阶段的镜像。每个FROM指令都会创建一个新的镜像层，并且可以在后续的指令中引用前面的镜像层。以下是一个示例：

# 第一个阶段：基于Node.js的构建阶段
FROM node:14 as builder
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install
COPY . .
RUN npm run build

# 第二个阶段：基于Nginx的运行阶段
FROM nginx:latest
COPY --from=builder /app/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

在上面的示例中，我们使用了两个FROM指令。第一个FROM指令使用了Node.js作为基础镜像，并在其中构建了应用程序。第二个FROM指令使用了Nginx作为基础镜像，并从第一个阶段的镜像中复制构建好的应用程序。这样可以将构建和运行分离，减小最终镜像的大小，并提高镜像的安全性。

四、docker build命令详解

docker build 命令用于从 Dockerfile 创建镜像。语法如下：

docker build [OPTIONS] PATH | URL | -

其中， PATH 是 Dockerfile 所在的路径， URL 是 Dockerfile 的 URL， - 表示从标准输入读取 Dockerfile。

docker build 命令可以使用以下选项：

• -t ：指定镜像的名称和标签。
• -f ：指定 Dockerfile 的路径或 URL。
• -q ：只显示镜像 ID。
• -no-cache ：不使用缓存构建镜像。
• -build-arg ：指定构建镜像时使用的参数。
• -force-rm ：在构建镜像时删除中间容器。
• -target ：指定构建镜像的目标阶段。

以下是 docker build 命令的一些示例：

# 从当前目录构建镜像
docker build -t my-image .

# 从指定路径构建镜像
docker build -t my-image /path/to/Dockerfile

# 从指定 URL 构建镜像
docker build -t my-image https://github.com/docker/dockerfile-examples/blob/master/nginx.dockerfile

# 只显示镜像 ID
docker build -t my-image -q .

# 不使用缓存构建镜像
docker build -t my-image -no-cache .

# 指定构建镜像时使用的参数
docker build -t my-image -build-arg VERSION=1.0 .

# 在构建镜像时删除中间容器
docker build -t my-image -force-rm .

# 指定构建镜像的目标阶段
docker build -t my-image -target build .

docker build 命令是构建 Docker 镜像的常用命令。它可以用于从 Dockerfile 创建镜像，也可以从指定的路径或 URL 创建镜像。

补充说明--target参数

-target 参数用于指定构建镜像的目标阶段。当 Dockerfile 中定义了多个阶段时，可以使用 -target 参数来选择性地构建特定阶段的镜像。

在 Dockerfile 中定义多个阶段时，可以使用 AS 关键字为每个阶段命名。例如：

FROM base AS build
RUN apt-get update && apt-get install -y build-essential

FROM base AS test
RUN apt-get update && apt-get install -y curl

FROM base AS deploy
COPY --from=build /app /app
COPY --from=test /test /test

在上面的示例中，Dockerfile 定义了三个阶段： build 、 test 和 deploy 。每个阶段都有一个特定的操作。 deploy 阶段依赖于 build 和 test 阶段的结果。

使用 -target 参数，可以选择性地构建特定的阶段。例如，要只构建 build 阶段的镜像，可以执行以下命令：

docker build -t my-image --target build .

这将只构建 build 阶段的镜像，并忽略其他阶段。通过 -target 参数，可以控制构建过程中所涉及的阶段，从而提高构建效率。

需要注意的是， -target 参数只能选择构建过程中的某个阶段，而不能选择构建过程中的某个指令。因此，指定的目标阶段必须在 Dockerfile 中明确定义。

-target 参数是一个有用的选项，特别适用于大型项目或复杂的构建流程，可以帮助减少构建时间并提高构建效率。

参考

Docker 官方文档：https://docs.docker.com/engine/reference/builder/