GitHub Actions 构建摘要

Docker 用于构建和推送镜像的 GitHub Actions 会为您的构建生成作业摘要，其中概述了执行过程和所用材料。

• 摘要显示了所用的 Dockerfile、构建持续时间和缓存利用率。
• 构建输入，例如构建参数、标签、标记和构建上下文。
• 对于使用 Bake 的构建，将显示完整的 Bake 定义。

如果您使用以下版本的 Build and push Docker images 或 Docker Buildx Bake GitHub Actions，Docker 构建的作业摘要会自动出现。

• docker/build-push-action@v6
• docker/bake-action@v6

要查看作业摘要，请在作业完成后，打开 GitHub 中该作业的详细信息页面。摘要适用于失败和成功的构建。如果构建失败，摘要还会显示导致构建失败的错误消息。

将构建记录导入 Docker Desktop

作业摘要包含一个用于下载运行的构建记录档案的链接。构建记录档案是一个 ZIP 文件，其中包含构建的详细信息（如果使用 `docker/bake-action` 构建多个目标，则包含多个构建的详细信息）。您可以将此构建记录档案导入 Docker Desktop，它提供了一个功能强大、图形化的界面，用于通过 Docker Desktop **构建**视图 进一步分析构建性能。

要将构建记录档案导入 Docker Desktop，请执行以下操作：

1. 下载并安装 Docker Desktop。

2. 从 GitHub Actions 的作业摘要中下载构建记录档案。

3. 在 Docker Desktop 中打开**构建**视图。

4. 选择**导入构建**按钮，然后浏览您下载的 `.zip` 档案作业摘要。或者，您可以在打开导入构建对话框后将构建记录档案 ZIP 文件拖放到 Docker Desktop 窗口中。

5. 选择**导入**以添加构建记录。

几秒钟后，GitHub Actions 运行中的构建将显示在“构建”视图的“**已完成构建**”选项卡下。要检查构建并查看所有输入、结果、构建步骤和缓存利用率的详细视图，请选择列表中的项。

禁用作业摘要

要禁用作业摘要，请在构建步骤的 YAML 配置中设置 `DOCKER_BUILD_SUMMARY` 环境变量

      - name: Build
        uses: docker/build-push-action@v6
        env:
          DOCKER_BUILD_SUMMARY: false
        with:
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}

禁用构建记录上传

要禁用将构建记录档案上传到 GitHub，请在构建步骤的 YAML 配置中设置 `DOCKER_BUILD_RECORD_UPLOAD` 环境变量

      - name: Build
        uses: docker/build-push-action@v6
        env:
          DOCKER_BUILD_RECORD_UPLOAD: false
        with:
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}

使用此配置，仍会生成构建摘要，但其中不包含下载构建记录档案的链接。

限制

目前不支持以下情况的构建摘要：

• 托管在 GitHub Enterprise Servers 上的存储库。摘要只能在托管在 GitHub.com 上的存储库中查看。