Skip to content

Update buildx reference to v0.20.0 #21858

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 6 commits into from
Jan 21, 2025
Merged

Update buildx reference to v0.20.0 #21858

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
559d554
vendor: github.com/docker/buildx v0.20.0
crazy-max Jan 20, 2025
2c74df2
buildx: create stub files for new history command
crazy-max Jan 21, 2025
f466e48
vendor: github.com/moby/buildkit v0.19.0
dvdksn Jan 21, 2025
e8842a8
build: buildx v0.20.0 release notes
dvdksn Jan 21, 2025
9cdce0c
build: dockerfile v0.13.0 release notes
dvdksn Jan 21, 2025
7051907
build: remove experimental callout for bake
dvdksn Jan 21, 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
4 changes: 2 additions & 2 deletions _vendor/github.com/docker/buildx/docs/bake-reference.md
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

27 changes: 15 additions & 12 deletions _vendor/github.com/moby/buildkit/frontend/dockerfile/docs/reference.md
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions _vendor/modules.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
7 changes: 0 additions & 7 deletions content/manuals/build/bake/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
31 changes: 31 additions & 0 deletions content/manuals/build/buildkit/dockerfile-release-notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,37 @@

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

Check failure on line 21 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 21, "column": 37}}}, "severity": "ERROR"}

```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)

Check failure on line 27 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 27, "column": 166}}}, "severity": "ERROR"}
- 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)

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

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.RecommendedWords] Consider using 'let' instead of 'Allow'

Raw Output:
{"message": "[Docker.RecommendedWords] Consider using 'let' instead of 'Allow'", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 28, "column": 3}}}, "severity": "INFO"}

Check failure on line 28 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 28, "column": 105}}}, "severity": "ERROR"}
- Default `PATH` in Windows Containers has been updated with `powershell.exe` directory. [moby/buildkit#5446](https://github.com/moby/buildkit/pull/5446)

Check failure on line 29 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 29, "column": 96}}}, "severity": "ERROR"}
- Fix Dockerfile directive parsing to not allow invalid syntax. [moby/buildkit#5646](https://github.com/moby/buildkit/pull/5646)

Check warning on line 30 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.RecommendedWords] Consider using 'let' instead of 'allow'

Raw Output:
{"message": "[Docker.RecommendedWords] Consider using 'let' instead of 'allow'", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 30, "column": 43}}}, "severity": "INFO"}

Check failure on line 30 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 30, "column": 71}}}, "severity": "ERROR"}
- Fix case where `ONBUILD` command may have run twice on inherited stage. [moby/buildkit#5593](https://github.com/moby/buildkit/pull/5593)

Check failure on line 31 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 31, "column": 81}}}, "severity": "ERROR"}
- Fix possible missing named context replacement for child stages in Dockerfile. [moby/buildkit#5596](https://github.com/moby/buildkit/pull/5596)

Check failure on line 32 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 32, "column": 88}}}, "severity": "ERROR"}

## 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).

Check failure on line 39 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 39, "column": 37}}}, "severity": "ERROR"}

```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)

Check failure on line 45 in content/manuals/build/buildkit/dockerfile-release-notes.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.

Raw Output:
{"message": "[Vale.Terms] Use 'BuildKit' instead of 'buildkit'.", "location": {"path": "content/manuals/build/buildkit/dockerfile-release-notes.md", "range": {"start": {"line": 45, "column": 62}}}, "severity": "ERROR"}

## 1.12.0

{{< release-date date="2024-11-27" >}}
Expand Down
32 changes: 32 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,38 @@
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)

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": 282}}}, "severity": "WARNING"}

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.We] Avoid using first-person plural like 'we'.

Raw Output:
{"message": "[Docker.We] Avoid using first-person plural like 'we'.", "location": {"path": "content/manuals/build/release-notes.md", "range": {"start": {"line": 22, "column": 353}}}, "severity": "WARNING"}

### 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" >}}
Expand Down
16 changes: 16 additions & 0 deletions content/reference/cli/docker/buildx/history/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
-->
16 changes: 16 additions & 0 deletions content/reference/cli/docker/buildx/history/inspect/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
-->
16 changes: 16 additions & 0 deletions content/reference/cli/docker/buildx/history/inspect/attachment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
-->
16 changes: 16 additions & 0 deletions content/reference/cli/docker/buildx/history/logs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
-->
16 changes: 16 additions & 0 deletions content/reference/cli/docker/buildx/history/ls.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
-->
16 changes: 16 additions & 0 deletions content/reference/cli/docker/buildx/history/open.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
-->
16 changes: 16 additions & 0 deletions content/reference/cli/docker/buildx/history/rm.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
-->
2 changes: 2 additions & 0 deletions data/buildx/docker_buildx.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down
56 changes: 51 additions & 5 deletions data/buildx/docker_buildx_bake.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down
Loading
Loading