GitHub Actions 建置摘要

Docker 用於建置與推送映像檔的 GitHub Actions 會針對您的建置產生一份工作摘要，概述執行過程與使用的素材

• 顯示所使用的 Dockerfile、建置持續時間與快取使用率的摘要
• 建置的輸入參數，例如建置引數 (build arguments)、標籤 (tags)、標籤 (labels) 與建置上下文 (build contexts)
• 若建置使用了 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 Builds 檢視進一步分析建置效能。

若要將建置記錄存檔匯入 Docker Desktop：

1. 下載並安裝 Docker Desktop。

2. 從 GitHub Actions 的工作摘要中下載建置記錄存檔。

3. 在 Docker Desktop 中開啟 Builds 檢視。

4. 選擇 Import build (匯入建置) 按鈕，然後瀏覽您下載的 .zip 存檔工作摘要。或者，您也可以在開啟匯入建置對話框後，將建置記錄存檔的 ZIP 檔案直接拖放至 Docker Desktop 視窗中。

5. 選擇 Import (匯入) 以新增建置記錄。

幾秒鐘後，來自 GitHub Actions 執行的建置就會出現在 Builds 檢視的 Completed builds (已完成的建置) 標籤頁下。若要檢查某個建置並查看所有輸入、結果、建置步驟與快取使用率的詳細檢視，請選取清單中的項目。

停用工作摘要

若要停用工作摘要，請在建置步驟的 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 的儲存庫上檢視。