如何使用 docker buildx history import 命令导入构建历史

简介

在本实验中，你将学习如何使用 docker buildx history import 命令导入构建历史。我们将从创建一个简单的 Dockerfile 开始，该文件会基于 Ubuntu 构建镜像并安装 curl 软件包。

完成 Dockerfile 的创建后，你将构建镜像并导出其构建历史。最后，你会将这些构建历史导入到 Docker Desktop 中，并验证导入是否成功。这个动手实践将展示导入构建历史在实际应用中的价值，它能帮助你更好地追踪和调试 Docker 构建过程。

Skills Graph

创建示例 Dockerfile

在这一步中，我们将创建一个简单的 Dockerfile。Dockerfile 是一个文本文件，包含用户可以通过命令行调用的所有指令来构建镜像。Docker 可以通过读取 Dockerfile 中的指令来自动构建镜像。

我们将创建一个基于最新版 Ubuntu 镜像的 Dockerfile，并安装 curl 软件包。

首先，如果你当前不在 ~/project 目录下，请导航至该目录：

cd ~/project

现在，使用 nano 编辑器在 ~/project 目录下创建一个名为 Dockerfile 的新文件：

nano Dockerfile

在 nano 编辑器中，向 Dockerfile 添加以下内容：

FROM ubuntu:latest
RUN apt-get update && apt-get install -y curl

让我们分解这个 Dockerfile 中的指令：

• FROM ubuntu:latest：该指令指定了我们新镜像的基础镜像。我们使用的是 Docker Hub 上官方 Ubuntu 镜像的最新版本。
• RUN apt-get update && apt-get install -y curl：该指令在当前镜像之上的新层中执行命令并提交结果。这里，我们更新软件包列表并使用 apt-get 包管理器安装 curl 软件包。-y 标志会自动对安装过程中的所有提示回答「是」。

添加内容后，保存文件并通过按 Ctrl + X 退出 nano，然后按 Y 确认保存，最后按 Enter 确认文件名。

你可以使用 cat 命令验证 Dockerfile 的内容：

cat Dockerfile

输出应该显示你刚刚添加到文件中的内容。

构建镜像并导出构建历史

在本步骤中，我们将基于上一步创建的 Dockerfile 构建 Docker 镜像，然后导出该镜像的构建历史。

首先，请确保你位于存放 Dockerfile 的 ~/project 目录中：

cd ~/project

现在，使用 docker build 命令构建 Docker 镜像。我们将镜像命名为 my-ubuntu-curl 并打上 latest 标签。命令末尾的 . 表示让 Docker 在当前目录查找 Dockerfile：

docker build -t my-ubuntu-curl:latest .

你将看到构建过程的输出信息，包括下载基础镜像和执行 apt-get 命令。根据你的网络连接情况，这个过程可能需要几分钟。

构建完成后，你可以通过列出本地 Docker 镜像来验证镜像是否创建成功：

docker images

你应该能在镜像列表中看到 my-ubuntu-curl。

接下来，我们将导出该镜像的构建历史。构建历史显示了组成镜像的各层以及创建每层所用的命令。我们可以使用 docker history 命令将历史记录导出到文件中。

让我们将构建历史导出到 ~/project 目录下名为 build_history.txt 的文件中：

docker history my-ubuntu-curl:latest > build_history.txt

该命令会将 docker history my-ubuntu-curl:latest 的输出写入 build_history.txt 文件。

你可以使用 cat 命令查看导出的历史文件内容：

cat build_history.txt

输出将显示一个表格，包含镜像中每一层的信息，包括层 ID、创建时间、大小以及创建该层所用的命令。

将构建历史导入 Docker Desktop

在本步骤中，我们将模拟将上一步导出的构建历史导入 Docker Desktop 的过程。虽然在这个终端环境中无法直接与图形界面的 Docker Desktop 实例交互，但我们可以演示这个概念和文件传输流程。

在实际场景中，当你从构建环境（如本 LabEx 虚拟机）导出 build_history.txt 文件后，通常需要将该文件传输到安装有 Docker Desktop 的机器上。常见的文件传输方法包括使用 scp、sftp 或云存储服务。

为了本实验的目的，我们假设你已将 build_history.txt 文件传输到运行 Docker Desktop 的本地机器上。

文件传输到本地机器后，你需要打开 Docker Desktop。Docker Desktop 提供了图形界面来管理 Docker 镜像、容器和卷。虽然 Docker Desktop 中没有直接"导入构建历史"的按钮来读取这种特定文本文件格式，但 build_history.txt 中的信息对于理解镜像构建过程非常有价值。

开发者通常利用这些构建历史来：

• 理解镜像的分层结构
• 调试镜像构建问题
• 在不同机器上重现构建过程
• 记录镜像创建流程

为了模拟"导入"过程并使构建历史可用于下一步验证，我们只需确保 build_history.txt 文件存在于 ~/project 目录中，就像它已准备好被检查或被能解析它的工具使用一样。

你可以通过以下命令确认文件仍在 ~/project 目录中：

ls ~/project/build_history.txt

如果文件存在，命令将输出其路径。如果不存在，你可能会看到错误信息。

在真实的 Docker Desktop 环境中，你通常会使用图形界面来检查镜像及其分层，这与 build_history.txt 中的信息视图类似。一些高级工具或脚本也可以用来解析和可视化这些历史数据。

由于我们处于终端环境中，build_history.txt 文件出现在预期位置即表示本步骤目标在实验上下文中的完成。

验证导入的构建历史

在这最后一步中，我们将验证上一步"导入"（通过确认其存在）的构建历史文件内容。这模拟了在 Docker Desktop 环境中检查构建历史或使用工具分析导出历史的过程。

我们将使用简单的命令行工具来检查 build_history.txt 文件是否包含预期信息，特别是查找 ubuntu 基础镜像和 curl 安装命令的痕迹。

首先，请确保你位于 ~/project 目录中：

cd ~/project

现在，使用 grep 命令在 build_history.txt 文件中搜索基础镜像信息。我们期望看到一行表明使用了 ubuntu 镜像的记录：

grep "ubuntu" ~/project/build_history.txt

输出应显示包含"ubuntu"的行，很可能与 Dockerfile 中初始的 FROM ubuntu:latest 指令相关。

接下来，我们搜索安装 curl 的命令。期望看到包含"apt-get install -y curl"的行：

grep "apt-get install -y curl" ~/project/build_history.txt

输出应显示用于安装 curl 的命令行。

这些 grep 命令展示了如何以编程方式验证构建历史的各个方面。在真实的 Docker Desktop 环境中，你可以通过图形界面直观地检查各层及其相关命令。

成功在 build_history.txt 文件中找到这些关键信息，确认构建历史已正确导出并可供检查，完成了本实验的目标。

总结

在本实验中，我们学习了如何使用 docker buildx history import 命令来管理 Docker 构建历史。我们首先基于 Ubuntu 创建了一个简单的 Dockerfile 并安装了 curl 包，这演示了定义镜像分层和指令的基本流程。

在创建 Dockerfile 之后，我们继续构建镜像并导出其构建历史。这一步骤对于理解如何捕获和保存镜像构建过程的详细信息至关重要。最后，我们将导出的构建历史导入 Docker Desktop 并验证了历史记录是否成功整合，展示了 buildx history import 命令在共享或迁移构建信息方面的实际应用。