GitHub Actions 建置摘要

Docker 的 GitHub Actions 用於建置和推送映像檔，會為您的建置產生作業摘要，概述執行情況和使用的素材

• 顯示 Dockerfile、建置期間和快取利用率的摘要
• 建置的輸入，例如建置引數、標籤、標記和建置上下文
• 對於使用 Bake 的建置，建置的完整 bake 定義

如果您使用以下版本的 建置和推送 Docker 映像檔

將建置記錄匯入 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/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/docker-build-push-action@v6
        env:
          DOCKER_BUILD_RECORD_UPLOAD: false
        with:
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}

使用此設定，仍然會產生建置摘要，但其中不包含下載建置記錄封存的連結。

限制

目前不支援下列項目的建置摘要：

• 使用 Docker Build Cloud 的建置。未來版本計劃支援 Docker Build Cloud。
• 託管在 GitHub Enterprise Servers 上的儲存庫。摘要只能針對託管在 GitHub.com 上的儲存庫檢視。