diff --git a/content/build/ci/github-actions/build-summary.md b/content/build/ci/github-actions/build-summary.md index cf16e1c743..b31408b1a9 100644 --- a/content/build/ci/github-actions/build-summary.md +++ b/content/build/ci/github-actions/build-summary.md @@ -32,6 +32,42 @@ message that caused the build to fail: ![Builds summary error message](../images/build_summary_error.png) +## Import build records to Docker Desktop + +{{< introduced desktop 4.31 >}} + +> **Beta feature** +> +> Import builds is currently in [Beta](../../../release-lifecycle.md#Beta). +{ .experimental } + +The job summary includes a link for downloading a build record archive for the +run. The build record archive is a ZIP file containing the details about a build +(or builds, if you use `docker/bake-action` to build multiple targets). You can +import this build record archive into Docker Desktop, which gives you a +powerful, graphical interface for further analyzing the build's performance via +the [Docker Desktop **Builds** view](../../../desktop/use-desktop/builds.md). + +To import the build record archive into Docker Desktop: + +1. Download and install [Docker Desktop](../../../get-docker.md). + +2. Download the build record archive from the job summary in GitHub Actions. + +3. Open the **Builds** view in Docker Desktop. + +4. Select the **Import build** button, and then browse for the `.zip` archive + job summary that you downloaded. Alternatively, you can drag-and-drop the + build record archive ZIP file onto the Docker Desktop window after opening + the import build dialog. + +5. Select **Import** to add the build records. + +After a few seconds, the builds from the GitHub Actions run appear under the +**Completed builds** tab in the Builds view. To inspect a build and see a +detailed view of all the inputs, results, build steps, and cache utilization, +select the item in the list. + ## Disable job summary To disable job summaries, set the `DOCKER_BUILD_NO_SUMMARY` environment diff --git a/content/desktop/use-desktop/builds.md b/content/desktop/use-desktop/builds.md index 9833878c88..869ac77050 100644 --- a/content/desktop/use-desktop/builds.md +++ b/content/desktop/use-desktop/builds.md @@ -32,10 +32,27 @@ The list shows builds for your active, running builders. It doesn't list builds for inactive builders: builders that you've removed from your system, or builders that have been stopped. +### Builder settings + The top-right corner shows the name of your currently selected builder, and the **Builder settings** button lets you [manage builders](#manage-builders) in the Docker Desktop settings. +### Import builds + +> **Beta feature** +> +> Import builds is currently in [Beta](../../release-lifecycle.md#Beta). +{ .experimental } + +The **Import builds** button lets you import build records for builds by other +people, or builds in a CI environment. When you've imported a build record, it +gives you full access to the logs, traces, and other data for that build, +directly in Docker Desktop. The [build summary](../../build/ci/github-actions/build-summary.md) +for the `docker/build-push-action` and `docker/bake-action` GitHub Actions +includes a link to download the build records, for inspecting CI jobs with +Docker Desktop. + ## Inspect builds To inspect a build, select the build that you want to view in the list.