Skip to content

build: buildx 0.21.0 release notes #22063

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Feb 20, 2025
Merged

build: buildx 0.21.0 release notes #22063

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
48967bb
build: buildx 0.21.0 release notes
crazy-max Feb 20, 2025
f213371
build: add url_v2 gha cache backend attribute
crazy-max Feb 20, 2025
18b5a09
Update content/manuals/build/release-notes.md
aevesdocker Feb 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions content/manuals/build/cache/backends/gha.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,9 @@ The following table describes the available CSV parameters that you can pass to
`--cache-to` and `--cache-from`.

| Name | Option | Type | Default | Description |
| -------------- | ----------------------- | ----------- | ------------------------ | -------------------------------------------------------------------- |
|----------------|-------------------------|-------------|--------------------------|----------------------------------------------------------------------|
| `url` | `cache-to`,`cache-from` | String | `$ACTIONS_CACHE_URL` | Cache server URL, see [authentication][1]. |
| `url_v2` | `cache-to`,`cache-from` | String | `$ACTIONS_CACHE_URL` | Cache v2 server URL, see [authentication][1]. |
| `token` | `cache-to`,`cache-from` | String | `$ACTIONS_RUNTIME_TOKEN` | Access token, see [authentication][1]. |
| `scope` | `cache-to`,`cache-from` | String | `buildkit` | Which scope cache object belongs to, see [scope][2] |
| `mode` | `cache-to` | `min`,`max` | `min` | Cache layers to export, see [cache mode][3]. |
Expand All @@ -47,10 +48,10 @@ The following table describes the available CSV parameters that you can pass to

## Authentication

If the `url` or `token` parameters are left unspecified, the `gha` cache backend
will fall back to using environment variables. If you invoke the `docker buildx`
command manually from an inline step, then the variables must be manually
exposed. Consider using the
If the `url`, `url_v2` or `token` parameters are left unspecified, the `gha`
cache backend will fall back to using environment variables. If you invoke the
`docker buildx` command manually from an inline step, then the variables must
be manually exposed. Consider using the
[`crazy-max/ghaction-github-runtime`](https://github.com/crazy-max/ghaction-github-runtime),
GitHub Action as a helper for exposing the variables.

Expand Down
28 changes: 28 additions & 0 deletions content/manuals/build/release-notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,34 @@
This page contains information about the new features, improvements, and bug
fixes in [Docker Buildx](https://github.com/docker/buildx).

## 0.21.0

{{< release-date date="2025-02-19" >}}

The full release note for this release is available
[on GitHub](https://github.com/docker/buildx/releases/tag/v0.21.0).

### New

- New command `buildx history trace` lets you inspect traces of a build in a Jaeger UI-based viewer and compare one trace with another. [docker/buildx#2904](https://github.com/docker/buildx/pull/2904)

Check warning on line 22 in content/manuals/build/release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'UI' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'UI' has no definition.", "location": {"path": "content/manuals/build/release-notes.md", "range": {"start": {"line": 22, "column": 85}}}, "severity": "WARNING"}

### Enhancements

- The history inspection command `buildx history inspect` now supports custom formatting with `--format` flag and JSON formatting for machine-readable output. [docker/buildx#2964](https://github.com/docker/buildx/pull/2964)
- Support for CDI device entitlement in build and bake. [docker/buildx#2994](https://github.com/docker/buildx/pull/2994)

Check warning on line 27 in content/manuals/build/release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'CDI' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'CDI' has no definition.", "location": {"path": "content/manuals/build/release-notes.md", "range": {"start": {"line": 27, "column": 15}}}, "severity": "WARNING"}
- Supported CDI devices are now shown in the builder inspection. [docker/buildx#2983](https://github.com/docker/buildx/pull/2983)

Check warning on line 28 in content/manuals/build/release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.Acronyms] 'CDI' has no definition.

Raw Output:
{"message": "[Docker.Acronyms] 'CDI' has no definition.", "location": {"path": "content/manuals/build/release-notes.md", "range": {"start": {"line": 28, "column": 13}}}, "severity": "WARNING"}
- When using [GitHub Cache backend `type=gha`](cache/backends/gha.md), the URL for the Version 2 or API is now read from the environment and sent to BuildKit. Version 2 backend requires BuildKit v0.20.0 or later. [docker/buildx#2983](https://github.com/docker/buildx/pull/2983), [docker/buildx#3001](https://github.com/docker/buildx/pull/3001)

Check warning on line 29 in content/manuals/build/release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.URLFormat] Use 'URL of' instead of 'URL for'.

Raw Output:
{"message": "[Docker.URLFormat] Use 'URL of' instead of 'URL for'.", "location": {"path": "content/manuals/build/release-notes.md", "range": {"start": {"line": 29, "column": 76}}}, "severity": "WARNING"}

### Bug fixes

- Avoid unnecessary warnings and prompts when using `--progress=rawjson`. [docker/buildx#2957](https://github.com/docker/buildx/pull/2957)
- Fix regression with debug shell sometimes not working correctly on `--on=error`. [docker/buildx#2958](https://github.com/docker/buildx/pull/2958)
- Fix possible panic errors when using an unknown variable in the Bake definition. [docker/buildx#2960](https://github.com/docker/buildx/pull/2960)
- Fix invalid duplicate output on JSON format formatting of `buildx ls` command. [docker/buildx#2970](https://github.com/docker/buildx/pull/2970)
- Fix bake handling cache imports with CSV string containing multiple registry references. [docker/buildx#2944](https://github.com/docker/buildx/pull/2944)
- Fix issue where error from pulling BuildKit image could be ignored. [docker/buildx#2988](https://github.com/docker/buildx/pull/2988)
- Fix race on pausing progress on debug shell. [docker/buildx#3003](https://github.com/docker/buildx/pull/3003)

## 0.20.1

{{< release-date date="2025-01-23" >}}
Expand Down