Docker Buildx Release Notes (Versions 0.20.1, 0.20.0 and Bug Fixes for GitHub Cache backend)

- 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) ### 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" >}} The full release notes for this release are available [on GitHub](https://github.com/docker/buildx/releases/tag/v0.20.1). ### Bug fixes - Fix `bake --print` output after missing some attributes for attestations. [docker/buildx#2937](https://github.com/docker/buildx/pull/2937) - Fix allowing comma-separated image reference strings for cache import and export values. [docker/buildx#2944](https://github.com/docker/buildx/pull/2944) ## 0.20.0 {{< release-date date="2025-01-20" >}} The full release notes for this release are available [on GitHub](https://github.com/docker/buildx/releases/tag/v0.20.0). > [!NOTE] > > This version of buildx enables filesystem entitlement checks for `buildx bake` > command by default. If your Bake definition needs to read or write files > outside your current working directory, you need to allow access to these > paths with `--allow fs=<path|*>`. On the terminal, you can also interactively > approve these paths with the provided prompt. Optionally, you can disable > these checks by setting `BUILDX_BAKE_ENTITLEMENTS_FS=0`. This validation > produced a warning in Buildx v0.19.0+, but starting from current release it > produces an error. For more information, see the [reference documentation](/reference/cli/docker/buildx/bake.md#allow). ### New - New `buildx history` command has been added that allows working with build records of completed and running builds. You can use these commands to list, inspect, remove your builds, replay the logs of already completed builds, and quickly open your builds in Docker Desktop Build UI for further debugging. This is an early version of this command and we expect to add more features in the future releases. [#2891](https://github.com/docker/buildx/pull/2891), [#2925](https://github.com/docker/buildx/pull/2925) ### Enhancements - Bake: Definition now supports new object notation for the fields that previously required CSV strings as inputs (`attest`, `output`, `cache-from`, `cache-to`, `secret`, `ssh`). [docker/buildx#2758](https://github.com/docker/buildx/pull/2758), [docker/buildx#2848](https://github.com/docker/buildx/pull/2848), [docker/buildx#2871](https://github.com/docker/buildx/pull/2871), [docker/buildx#2814](https://github.com/docker/buildx/pull/2814) - Bake: Filesystem entitlements now error by default. To disable this behavior, you can set `BUILDX_BAKE_ENTITLEMENTS_FS=0`. [docker/buildx#2875](https://github.com/docker/buildx/pull/2875) - Bake: Infer Git authentication token from remote files to build request. [docker/buildx#2905](https://github.com/docker/buildx/pull/2905) - Bake: Add support for `--list` flag to list targets and variables. [docker/buildx#2900](https://github.com/docker/buildx/pull/2900), [docker/buildx#2907](https://github.com/docker/buildx/pull/2907)

This section details Docker Buildx release notes for versions 0.20.1 and 0.20.0, as well as bug fixes related to the GitHub Cache backend. Version 0.20.1 addresses issues with bake output and cache import/export values. Version 0.20.0 introduces the `buildx history` command, enhances Bake with object notation and filesystem entitlement checks, and adds support for Git authentication and listing targets/variables. Additionally, bug fixes address warnings with `--progress=rawjson`, debug shell regressions, panic errors in Bake, duplicate output in `buildx ls`, cache import handling, BuildKit image pull errors, and race conditions in debug shell pausing. The GitHub Cache backend now reads the API URL from the environment.