Merge pull request #21858 from docker-tools-robot/dispatch/buildx-ref…

…-v0.20.0

Update buildx reference to v0.20.0

_vendor/modules.txt

@@ -1,6 +1,6 @@
 # github.com/moby/moby v27.5.0+incompatible
-# github.com/moby/buildkit v0.18.1
-# github.com/docker/buildx v0.19.2
+# github.com/moby/buildkit v0.19.0
+# github.com/docker/buildx v0.20.0
 # github.com/docker/cli v27.5.0+incompatible
 # github.com/docker/compose/v2 v2.32.4
 # github.com/docker/scout-cli v1.15.0

content/manuals/build/bake/_index.md

@@ -6,13 +6,6 @@ aliases:
   - /build/customize/bake/
 ---
 
-{{% experimental %}}
-
-Bake is an experimental feature, and we are looking for
-[feedback from users](https://github.com/docker/buildx/issues).
-
-{{% /experimental %}}
-
 Bake is a feature of Docker Buildx that lets you define your build configuration
 using a declarative file, as opposed to specifying a complex CLI expression. It
 also lets you run multiple builds concurrently with a single invocation.

content/manuals/build/buildkit/dockerfile-release-notes.md

@@ -13,6 +13,37 @@ issues, and bug fixes in [Dockerfile reference](/reference/dockerfile.md).
 
 For usage, see the [Dockerfile frontend syntax](frontend.md) page.
 
+## 1.13.0
+
+{{< release-date date="2025-01-20" >}}
+
+The full release note for this release is available
+[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.13.0).
+
+```dockerfile
+# syntax=docker/dockerfile:1.13.0
+```
+
+- New `TARGETOSVERSION`, `BUILDOSVERSION` builtin build-args are available for Windows builds, and `TARGETPLATFORM` value now also contains `OSVersion` value. [moby/buildkit#5614](https://github.com/moby/buildkit/pull/5614)
+- Allow syntax forwarding for external frontends for files starting with a Byte Order Mark (BOM). [moby/buildkit#5645](https://github.com/moby/buildkit/pull/5645)
+- Default `PATH` in Windows Containers has been updated with `powershell.exe` directory. [moby/buildkit#5446](https://github.com/moby/buildkit/pull/5446)
+- Fix Dockerfile directive parsing to not allow invalid syntax. [moby/buildkit#5646](https://github.com/moby/buildkit/pull/5646)
+- Fix case where `ONBUILD` command may have run twice on inherited stage. [moby/buildkit#5593](https://github.com/moby/buildkit/pull/5593)
+- Fix possible missing named context replacement for child stages in Dockerfile. [moby/buildkit#5596](https://github.com/moby/buildkit/pull/5596)
+
+## 1.13.0-labs
+
+{{< release-date date="2025-01-20" >}}
+
+The full release note for this release is available
+[on GitHub](https://github.com/moby/buildkit/releases/tag/dockerfile%2F1.13.0-labs).
+
+```dockerfile
+# syntax=docker.io/docker/dockerfile-upstream:1.13.0-labs
+```
+
+- Fix support for non-octal values for `COPY --chmod`. [moby/buildkit#5626](https://github.com/moby/buildkit/pull/5626)
+
 ## 1.12.0
 
 {{< release-date date="2024-11-27" >}}

content/manuals/build/release-notes.md

@@ -10,6 +10,38 @@ toc_max: 2
 This page contains information about the new features, improvements, and bug
 fixes in [Docker Buildx](https://github.com/docker/buildx).
 
+## 0.20.0
+
+{{< release-date date="2025-01-20" >}}
+
+The full release note for this release is available
+[on GitHub](https://github.com/docker/buildx/releases/tag/v0.20.0).
+
+### 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)
+- Bake: Update lookup order for default definition files to load the files with "override" suffix later. [docker/buildx#2886](https://github.com/docker/buildx/pull/2886)
+
+### Bug fixes
+
+- Bake: Fix entitlements check for default SSH socket. [docker/buildx#2898](https://github.com/docker/buildx/pull/2898)
+- Bake: Fix missing default target in group's default targets. [docker/buildx#2863](https://github.com/docker/buildx/pull/2863)
+- Bake: Fix named context from target platform matching. [docker/buildx#2877](https://github.com/docker/buildx/pull/2877)
+- Fix missing documentation for quiet progress mode. [docker/buildx#2899](https://github.com/docker/buildx/pull/2899)
+- Fix missing last progress from loading layers. [docker/buildx#2876](https://github.com/docker/buildx/pull/2876)
+- Validate BuildKit configuration before creating a builder. [docker/buildx#2864](https://github.com/docker/buildx/pull/2864)
+
+### Packaging
+
+- Compose compatibility has been updated to v2.4.7. [docker/buildx#2893](https://github.com/docker/buildx/pull/2893), [docker/buildx#2857](https://github.com/docker/buildx/pull/2857), [docker/buildx#2829](https://github.com/docker/buildx/pull/2829)
+
 ## 0.19.1
 
 {{< release-date date="2024-11-27" >}}

content/reference/cli/docker/buildx/history/_index.md

@@ -0,0 +1,16 @@
+---
+datafolder: buildx
+datafile: docker_buildx_history
+title: docker buildx history
+layout: cli
+aliases:
+- /engine/reference/commandline/buildx_history/
+---
+
+<!--
+This page is automatically generated from Docker's source code. If you want to
+suggest a change to the text that appears here, open a ticket or pull request
+in the source repository on GitHub:
+
+https://github.com/docker/buildx
+-->

content/reference/cli/docker/buildx/history/inspect/_index.md

@@ -0,0 +1,16 @@
+---
+datafolder: buildx
+datafile: docker_buildx_history_inspect
+title: docker buildx history inspect
+layout: cli
+aliases:
+- /engine/reference/commandline/buildx_history_inspect/
+---
+
+<!--
+This page is automatically generated from Docker's source code. If you want to
+suggest a change to the text that appears here, open a ticket or pull request
+in the source repository on GitHub:
+
+https://github.com/docker/buildx
+-->

content/reference/cli/docker/buildx/history/inspect/attachment.md

@@ -0,0 +1,16 @@
+---
+datafolder: buildx
+datafile: docker_buildx_history_inspect_attachment
+title: docker buildx history inspect attachment
+layout: cli
+aliases:
+- /engine/reference/commandline/buildx_history_inspect_attachment/
+---
+
+<!--
+This page is automatically generated from Docker's source code. If you want to
+suggest a change to the text that appears here, open a ticket or pull request
+in the source repository on GitHub:
+
+https://github.com/docker/buildx
+-->

content/reference/cli/docker/buildx/history/logs.md

@@ -0,0 +1,16 @@
+---
+datafolder: buildx
+datafile: docker_buildx_history_logs
+title: docker buildx history logs
+layout: cli
+aliases:
+- /engine/reference/commandline/buildx_history_logs/
+---
+
+<!--
+This page is automatically generated from Docker's source code. If you want to
+suggest a change to the text that appears here, open a ticket or pull request
+in the source repository on GitHub:
+
+https://github.com/docker/buildx
+-->

content/reference/cli/docker/buildx/history/ls.md

@@ -0,0 +1,16 @@
+---
+datafolder: buildx
+datafile: docker_buildx_history_ls
+title: docker buildx history ls
+layout: cli
+aliases:
+- /engine/reference/commandline/buildx_history_ls/
+---
+
+<!--
+This page is automatically generated from Docker's source code. If you want to
+suggest a change to the text that appears here, open a ticket or pull request
+in the source repository on GitHub:
+
+https://github.com/docker/buildx
+-->

content/reference/cli/docker/buildx/history/open.md

@@ -0,0 +1,16 @@
+---
+datafolder: buildx
+datafile: docker_buildx_history_open
+title: docker buildx history open
+layout: cli
+aliases:
+- /engine/reference/commandline/buildx_history_open/
+---
+
+<!--
+This page is automatically generated from Docker's source code. If you want to
+suggest a change to the text that appears here, open a ticket or pull request
+in the source repository on GitHub:
+
+https://github.com/docker/buildx
+-->

content/reference/cli/docker/buildx/history/rm.md

@@ -0,0 +1,16 @@
+---
+datafolder: buildx
+datafile: docker_buildx_history_rm
+title: docker buildx history rm
+layout: cli
+aliases:
+- /engine/reference/commandline/buildx_history_rm/
+---
+
+<!--
+This page is automatically generated from Docker's source code. If you want to
+suggest a change to the text that appears here, open a ticket or pull request
+in the source repository on GitHub:
+
+https://github.com/docker/buildx
+-->

data/buildx/docker_buildx.yaml

@@ -11,6 +11,7 @@ cname:
     - docker buildx debug
     - docker buildx dial-stdio
     - docker buildx du
+    - docker buildx history
     - docker buildx imagetools
     - docker buildx inspect
     - docker buildx ls
@@ -26,6 +27,7 @@ clink:
     - docker_buildx_debug.yaml
     - docker_buildx_dial-stdio.yaml
     - docker_buildx_du.yaml
+    - docker_buildx_history.yaml
     - docker_buildx_imagetools.yaml
     - docker_buildx_inspect.yaml
     - docker_buildx_ls.yaml

data/buildx/docker_buildx_bake.yaml

@@ -59,24 +59,34 @@ options:
       experimentalcli: false
       kubernetes: false
       swarm: false
+    - option: list
+      value_type: string
+      description: List targets or variables
+      details_url: '#list'
+      deprecated: false
+      hidden: false
+      experimental: false
+      experimentalcli: false
+      kubernetes: false
+      swarm: false
     - option: list-targets
       value_type: bool
       default_value: "false"
       description: List available targets
-      deprecated: false
+      deprecated: true
       hidden: true
       experimental: false
-      experimentalcli: true
+      experimentalcli: false
       kubernetes: false
       swarm: false
     - option: list-variables
       value_type: bool
       default_value: "false"
       description: List defined variables
-      deprecated: false
+      deprecated: true
       hidden: true
       experimental: false
-      experimentalcli: true
+      experimentalcli: false
       kubernetes: false
       swarm: false
     - option: load
@@ -125,7 +135,7 @@ options:
       value_type: string
       default_value: auto
       description: |
-        Set type of progress output (`auto`, `plain`, `tty`, `rawjson`). Use plain to show container output
+        Set type of progress output (`auto`, `quiet`, `plain`, `tty`, `rawjson`). Use plain to show container output
       details_url: '#progress'
       deprecated: false
       hidden: false
@@ -259,6 +269,42 @@ examples: |-
     See the [Bake file reference](/build/bake/reference/)
     for more details.
 
+    ### List targets and variables (--list) {#list}
+
+    The `--list` flag displays all available targets or variables in the Bake
+    configuration, along with a description (if set using the `description`
+    property in the Bake file).
+
+    To list all targets:
+
+    ```console {title="List targets"}
+    $ docker buildx bake --list=targets
+    TARGET              DESCRIPTION
+    binaries
+    default             binaries
+    update-docs
+    validate
+    validate-golangci   Validate .golangci.yml schema (does not run Go linter)
+    ```
+
+    To list variables:
+
+    ```console
+    $ docker buildx bake --list=variables
+    VARIABLE      VALUE                DESCRIPTION
+    REGISTRY      docker.io/username   Registry and namespace
+    IMAGE_NAME    my-app               Image name
+    GO_VERSION    <null>
+    ```
+
+    By default, the output of `docker buildx bake --list` is presented in a table
+    format. Alternatively, you can use a long-form CSV syntax and specify a
+    `format` attribute to output the list in JSON.
+
+    ```console
+    $ docker buildx bake --list=type=targets,format=json
+    ```
+
     ### Write build results metadata to a file (--metadata-file) {#metadata-file}
 
     Similar to [`buildx build --metadata-file`](/reference/cli/docker/buildx/build/#metadata-file) but