docs: added note on populating builds tab when building windows container images (#22389)

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->
If a user switches to Windows containers and builds an image using the
`docker build` command as it (using the legacy builder), the Builds tab
is not populated. This is because the build history is provided by
Buildkit. To populate the Builds tab, the customer must either set
`DOCKER_BUILDKIT=1` or use the `buildx build` command.

Current documentation does not mention this and a support ticket was
raised.

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->
- SEG-1116 (Slack thread linked in ticket for context)

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [X] Technical review @karman-docker 
- [X] Editorial review
- [ ] Product review

---------

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
This commit is contained in:
Monica Chao 2025-04-09 07:37:03 -05:00 committed by GitHub
parent 01505f4d80
commit 034dbdfbcc
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 6 additions and 0 deletions

View File

@ -14,6 +14,12 @@ If you're connected to a cloud builder through [Docker Build Cloud](../../build-
the Builds view also lists any active or completed cloud builds by other team members
connected to the same cloud builder.
> [!NOTE]
>
> When building Windows container images using the `docker build` command, the legacy builder is used which does not populate the **Builds** view. To switch to using BuildKit, you can either:
> - Set `DOCKER_BUILDKIT=1` in the build command, such as `DOCKER_BUILDKIT=1 docker build .` or
> - Use the `docker buildx build` command
## Show build list
Open the **Builds** view from the Docker Dashboard to access: