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

可用性：測試版

要求： Docker Desktop 4.31 及更高版本

作業摘要包含一個用於下載執行的構建記錄檔案的連結。構建記錄檔案是一個 ZIP 檔案，其中包含構建的詳細資訊（如果使用 `docker/bake-action` 構建多個目標，則包含多個構建的詳細資訊）。您可以將此構建記錄檔案匯入 Docker Desktop，它提供了一個功能強大、圖形化的介面，用於透過 Docker Desktop **構建**檢視進一步分析構建效能。

要將構建記錄檔案匯入 Docker Desktop，請執行以下操作：

下載並安裝 Docker Desktop。
從 GitHub Actions 的作業摘要中下載構建記錄檔案。
在 Docker Desktop 中開啟**構建**檢視。
選擇**匯入構建**按鈕，然後瀏覽您下載的 `.zip` 檔案作業摘要。或者，您可以在開啟匯入構建對話方塊後將構建記錄檔案 ZIP 檔案拖放到 Docker Desktop 視窗中。
選擇**匯入**以新增構建記錄。

幾秒鐘後，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 上的儲存庫中檢視。