探索构建

Docker Desktop 中的构建视图

构建视图是一个简单的界面,可让您检查构建历史记录并使用 Docker Desktop 管理构建器

在 Docker Desktop 中打开“构建”视图会显示已完成构建的列表。默认情况下,列表按日期排序,在顶部显示最新版本。您可以切换到活动构建来查看任何正在进行的构建。

构建 UI 屏幕截图 活动构建

如果您通过Docker Build Cloud连接到云构建器 ,则构建视图还会列出连接到同一云构建器的其他团队成员的任何活动或已完成的云构建。

显示构建列表

选择Docker 仪表板中的“构建”视图以打开构建列表。

构建列表显示活动构建器的正在运行和已完成的构建。右上角显示当前选择的构建器的名称, 构建器设置按钮可让您 在 Docker Desktop 设置中管理构建器。

正在运行的构建显示在此视图的顶部部分,其中包含有关构建目标和进度的信息。

视图的下半部分显示您最近的构建。您可以从活动构建或已完成构建部分中选择任何构建来查看详细信息,例如日志、性能细分、缓存利用率等。

构建列表不包括非活动构建器的构建。也就是说,您已从系统中删除的构建器或已停止的构建器。

检查构建

要检查构建,请选择要在列表中查看的构建。检查视图包含许多选项卡。

“信息”选项卡显示有关构建的详细信息。

如果您正在检查多平台构建,则可以使用此选项卡右上角的下拉菜单将信息过滤到特定平台:

平台过滤器

详细信息部分显示有关前端的信息 以及用于构建的源代码存储库(如果有)。

构建时机

“信息”选项卡的“构建计时”部分包含从各个角度显示构建执行细目的图表。

  • 实时是指完成构建所需的挂钟时间。
  • 累计时间显示所有步骤的总 CPU 时间。
  • 缓存使用情况显示了构建操作的缓存程度。
  • 并行执行显示了并行运行步骤花费了多少构建执行时间。
构建时序图

图表颜色和图例键描述了不同的构建操作。构建操作定义如下:

构建操作描述
本地文件传输将本地文件从客户端传输到构建器所花费的时间。
文件操作涉及在构建中创建和复制文件的任何操作。例如,Dockerfile 前端中的COPY, WORKDIR,指令都会引发文件操作。ADD
图片拉取提取图像所花费的时间。
处决容器执行,例如RUN在 Dockerfile 前端中定义为指令的命令。
HTTP协议使用 远程工件下载ADD
git与HTTP相同,但适用于 Git URL。
结果导出导出构建结果所花费的时间。
SBOM生成SBOM 证明所花费的时间 。
闲置的构建工作人员的空闲时间,如果您配置了 最大并行度限制,则可能会发生这种情况。

构建依赖关系

依赖部分显示构建过程中使用的图像和远程资源。此处列出的资源包括:

  • 构建期间使用的容器镜像
  • ADD使用Dockerfile 指令包含的 Git 存储库
  • ADD使用Dockerfile 指令包含远程 HTTPS 资源

参数、秘密和其他参数

“信息”选项卡的“配置”部分显示传递给构建的参数:

  • 构建参数,包括解析值
  • 秘密,包括其 ID(但不包括其值)
  • SSH 套接字
  • 标签
  • 其他背景

输出和工件

构建结果部分显示生成的构建工件的摘要,包括图像清单详细信息、证明和开放遥测跟踪。

证明是附加到容器映像的元数据记录。元数据描述了有关图像的一些信息,例如它是如何构建的或者它包含哪些包。有关证明的更多信息,请参阅 构建证明

构建的开放遥测跟踪捕获有关 Buildx 和 BuildKit 中构建执行步骤的信息。您可以使用 Jaeger 等跟踪可视化工具自行查看和分析跟踪。有关更多信息,请参阅 OpenTelemetry 支持。

Dockerfile 来源和错误

当检查成功完成的构建或正在进行的活动构建时,“源”选项卡显示 用于创建构建的前端。

如果构建失败,则会显示“错误”选项卡,而不是“源”选项卡。错误消息内嵌在 Dockerfile 源中,指示发生故障的位置和原因。

Dockerfile 中内联显示的构建错误

构建日志

日志选项卡显示构建日志。对于活动构建,日志会实时更新。

您可以在构建日志的列表视图纯文本视图之间切换。

  • 列表视图以可折叠格式显示所有构建步骤,并带有用于沿时间轴导航日志的时间线。

  • 纯文本视图将日志显示为纯文本。

通过“复制”按钮,您可以将日志的纯文本版本复制到剪贴板。

创造历史

“历史记录”选项卡显示有关已完成构建的统计数据。

时间序列图表说明了相关构建的持续时间、构建步骤和缓存使用情况的趋势,帮助您识别构建操作随时间变化的模式和变化。例如,构建持续时间的显着峰值或大量缓存未命中可能预示着优化 Dockerfile 的机会。

构建历史图表

您可以通过在图表中选择相关构建或使用图表下方的过go构建列表来导航到并检查相关构建。

管理建造者

Docker Desktop 设置中的Builder 设置视图可让您:

  • 检查活动构建器的状态和配置
  • 启动和停止构建器
  • 删除构建历史记录
  • 添加或删除构建器(或者在云构建器的情况下连接和断开连接)
生成器设置下拉菜单

有关管理构建器的更多信息,请参阅: