docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

build: import build records in Docker Desktop 

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
David Karlsson 2024-05-17 09:53:59 +02:00 committed by CrazyMax
parent e040c9c92c
commit 1fa9d048b2
No known key found for this signature in database
GPG Key ID: ADE44D8C9D44FBE4
2 changed files with 53 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
content/build/ci/github-actions/build-summary.md
View File

@ -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

17
content/desktop/use-desktop/builds.md
View File

@ -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.