Skip to content

Commit c72b904

Browse files
crazy-maxgithub-actions[bot]
authored andcommitted
vendor: github.com/docker/buildx v0.26.0
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent fad8c0e commit c72b904

12 files changed

+839
-105
lines changed

_vendor/github.com/docker/buildx/docs/bake-reference.md

Lines changed: 2 additions & 3 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

_vendor/modules.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# github.com/moby/moby v28.3.2+incompatible
22
# github.com/moby/buildkit v0.23.2
3-
# github.com/docker/buildx v0.25.0
3+
# github.com/docker/buildx v0.26.0
44
# github.com/docker/cli v28.3.3-0.20250711132746-c69d8bde4adc+incompatible
55
# github.com/docker/compose/v2 v2.38.2
66
# github.com/docker/model-cli v0.1.33-0.20250703103301-d4e4936a9eb2

data/buildx/docker_buildx.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ cname:
88
- docker buildx bake
99
- docker buildx build
1010
- docker buildx create
11+
- docker buildx dap
1112
- docker buildx debug
1213
- docker buildx dial-stdio
1314
- docker buildx du
@@ -24,6 +25,7 @@ clink:
2425
- docker_buildx_bake.yaml
2526
- docker_buildx_build.yaml
2627
- docker_buildx_create.yaml
28+
- docker_buildx_dap.yaml
2729
- docker_buildx_debug.yaml
2830
- docker_buildx_dial-stdio.yaml
2931
- docker_buildx_du.yaml

data/buildx/docker_buildx_bake.yaml

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -311,6 +311,11 @@ examples: |-
311311
The file can be an HCL, JSON or Compose file. If multiple files are specified,
312312
all are read and the build configurations are combined.
313313
314+
Alternatively, the environment variable `BUILDX_BAKE_FILE` can be used to specify the build definition to use.
315+
This is mutually exclusive with `-f` / `--file`; if both are specified, the environment variable is ignored.
316+
Multiple definitions can be specified by separating them with the system's path separator
317+
(typically `;` on Windows and `:` elsewhere), but can be changed with `BUILDX_BAKE_PATH_SEPARATOR`.
318+
314319
You can pass the names of the targets to build, to build only specific target(s).
315320
The following example builds the `db` and `webapp-release` targets that are
316321
defined in the `docker-bake.dev.hcl` file:
@@ -366,12 +371,15 @@ examples: |-
366371
367372
```console
368373
$ docker buildx bake --list=variables
369-
VARIABLE VALUE DESCRIPTION
370-
REGISTRY docker.io/username Registry and namespace
371-
IMAGE_NAME my-app Image name
372-
GO_VERSION <null>
374+
VARIABLE TYPE VALUE DESCRIPTION
375+
REGISTRY string docker.io/username Registry and namespace
376+
IMAGE_NAME string my-app Image name
377+
GO_VERSION <null>
378+
DEBUG bool false Add debug symbols
373379
```
374380
381+
Variable types will be shown when set using the `type` property in the Bake file.
382+
375383
By default, the output of `docker buildx bake --list` is presented in a table
376384
format. Alternatively, you can use a long-form CSV syntax and specify a
377385
`format` attribute to output the list in JSON.
@@ -531,6 +539,7 @@ examples: |-
531539
* `context`
532540
* `dockerfile`
533541
* `entitlements`
542+
* `extra-hosts`
534543
* `labels`
535544
* `load`
536545
* `no-cache`

data/buildx/docker_buildx_build.yaml

Lines changed: 68 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -703,13 +703,15 @@ examples: |-
703703
Define additional build context with specified contents. In Dockerfile the context can be accessed when `FROM name` or `--from=name` is used.
704704
When Dockerfile defines a stage with the same name it is overwritten.
705705
706-
The value can be a local source directory, [local OCI layout compliant directory](https://github.com/opencontainers/image-spec/blob/main/image-layout.md), container image (with docker-image:// prefix), Git or HTTP URL.
706+
The value can be a:
707707
708-
Replace `alpine:latest` with a pinned one:
708+
- local source directory
709+
- [local OCI layout compliant directory](https://github.com/opencontainers/image-spec/blob/main/image-layout.md)
710+
- container image
711+
- Git URL
712+
- HTTP URL
709713
710-
```console
711-
$ docker buildx build --build-context alpine=docker-image://alpine@sha256:0123456789 .
712-
```
714+
#### Use a local path {#local-path}
713715
714716
Expose a secondary local source directory:
715717
@@ -718,6 +720,16 @@ examples: |-
718720
# docker buildx build --build-context project=https://github.com/myuser/project.git .
719721
```
720722
723+
#### Use a container image {#docker-image}
724+
725+
Use the `docker-image://` scheme.
726+
727+
Replace `alpine:latest` with a pinned one:
728+
729+
```console
730+
$ docker buildx build --build-context alpine=docker-image://alpine@sha256:0123456789 .
731+
```
732+
721733
```dockerfile
722734
# syntax=docker/dockerfile:1
723735
FROM alpine
@@ -726,7 +738,10 @@ examples: |-
726738
727739
#### Use an OCI layout directory as build context {#source-oci-layout}
728740
729-
Source an image from a local [OCI layout compliant directory](https://github.com/opencontainers/image-spec/blob/main/image-layout.md),
741+
Use the `oci-layout:///` scheme.
742+
743+
Source an image from a local
744+
[OCI layout compliant directory](https://github.com/opencontainers/image-spec/blob/main/image-layout.md),
730745
either by tag, or by digest:
731746
732747
```console
@@ -744,7 +759,6 @@ examples: |-
744759
```
745760
746761
The OCI layout directory must be compliant with the [OCI layout specification](https://github.com/opencontainers/image-spec/blob/main/image-layout.md).
747-
You can reference an image in the layout using either tags, or the exact digest.
748762
749763
### Override the configured builder instance (--builder) {#builder}
750764
@@ -756,25 +770,25 @@ examples: |-
756770
--cache-from=[NAME|type=TYPE[,KEY=VALUE]]
757771
```
758772
759-
Use an external cache source for a build. Supported types are `registry`,
760-
`local`, `gha` and `s3`.
773+
Use an external cache source for a build. Supported types are:
761774
762-
- [`registry` source](https://github.com/moby/buildkit#registry-push-image-and-cache-separately)
775+
- [`registry`](/build/cache/backends/registry/)
763776
can import cache from a cache manifest or (special) image configuration on the
764777
registry.
765-
- [`local` source](https://github.com/moby/buildkit#local-directory-1) can
778+
- [`local`](/build/cache/backends/local/) can
766779
import cache from local files previously exported with `--cache-to`.
767-
- [`gha` source](https://github.com/moby/buildkit#github-actions-cache-experimental)
780+
- [`gha`](/build/cache/backends/gha/)
781+
can import cache from a previously exported cache with `--cache-to` in your
782+
GitHub repository.
783+
- [`s3`](/build/cache/backends/s3/)
768784
can import cache from a previously exported cache with `--cache-to` in your
769-
GitHub repository
770-
- [`s3` source](https://github.com/moby/buildkit#s3-cache-experimental)
785+
S3 bucket.
786+
- [`azblob`](/build/cache/backends/azblob/)
771787
can import cache from a previously exported cache with `--cache-to` in your
772-
S3 bucket
788+
Azure bucket.
773789
774790
If no type is specified, `registry` exporter is used with a specified reference.
775791
776-
`docker` driver currently only supports importing build cache from the registry.
777-
778792
```console
779793
$ docker buildx build --cache-from=user/app:cache .
780794
$ docker buildx build --cache-from=user/app .
@@ -784,7 +798,43 @@ examples: |-
784798
$ docker buildx build --cache-from=type=s3,region=eu-west-1,bucket=mybucket .
785799
```
786800
787-
More info about cache exporters and available attributes: https://github.com/moby/buildkit#export-cache
801+
> [!NOTE]
802+
> More info about cache exporters and available attributes can be found in the
803+
> [Cache storage backends documentation](/build/cache/backends/)
804+
805+
### Export build cache to an external cache destination (--cache-to) {#cache-to}
806+
807+
```text
808+
--cache-to=[NAME|type=TYPE[,KEY=VALUE]]
809+
```
810+
811+
Export build cache to an external cache destination. Supported types are:
812+
813+
- [`registry`](/build/cache/backends/registry/) exports
814+
build cache to a cache manifest in the registry.
815+
- [`local`](/build/cache/backends/local/) exports
816+
cache to a local directory on the client.
817+
- [`inline`](/build/cache/backends/inline/) writes the
818+
cache metadata into the image configuration.
819+
- [`gha`](/build/cache/backends/gha/) exports cache
820+
through the GitHub Actions Cache service API.
821+
- [`s3`](/build/cache/backends/s3/) exports cache to a
822+
S3 bucket.
823+
- [`azblob`](/build/cache/backends/azblob/) exports
824+
cache to an Azure bucket.
825+
826+
```console
827+
$ docker buildx build --cache-to=user/app:cache .
828+
$ docker buildx build --cache-to=type=inline .
829+
$ docker buildx build --cache-to=type=registry,ref=user/app .
830+
$ docker buildx build --cache-to=type=local,dest=path/to/cache .
831+
$ docker buildx build --cache-to=type=gha .
832+
$ docker buildx build --cache-to=type=s3,region=eu-west-1,bucket=mybucket .
833+
```
834+
835+
> [!NOTE]
836+
> More info about cache exporters and available attributes can be found in the
837+
> [Cache storage backends documentation](/build/cache/backends/)
788838
789839
### Invoke a frontend method (--call) {#call}
790840
@@ -947,45 +997,6 @@ examples: |-
947997
release (default) is an empty scratch image with only compiled assets
948998
```
949999
950-
### Export build cache to an external cache destination (--cache-to) {#cache-to}
951-
952-
```text
953-
--cache-to=[NAME|type=TYPE[,KEY=VALUE]]
954-
```
955-
956-
Export build cache to an external cache destination. Supported types are
957-
`registry`, `local`, `inline`, `gha` and `s3`.
958-
959-
- [`registry` type](https://github.com/moby/buildkit#registry-push-image-and-cache-separately) exports build cache to a cache manifest in the registry.
960-
- [`local` type](https://github.com/moby/buildkit#local-directory-1) exports
961-
cache to a local directory on the client.
962-
- [`inline` type](https://github.com/moby/buildkit#inline-push-image-and-cache-together)
963-
writes the cache metadata into the image configuration.
964-
- [`gha` type](https://github.com/moby/buildkit#github-actions-cache-experimental)
965-
exports cache through the [GitHub Actions Cache service API](https://github.com/tonistiigi/go-actions-cache/blob/master/api.md#authentication).
966-
- [`s3` type](https://github.com/moby/buildkit#s3-cache-experimental) exports
967-
cache to a S3 bucket.
968-
969-
The `docker` driver only supports cache exports using the `inline` and `local`
970-
cache backends.
971-
972-
Attribute key:
973-
974-
- `mode` - Specifies how many layers are exported with the cache. `min` on only
975-
exports layers already in the final build stage, `max` exports layers for
976-
all stages. Metadata is always exported for the whole build.
977-
978-
```console
979-
$ docker buildx build --cache-to=user/app:cache .
980-
$ docker buildx build --cache-to=type=inline .
981-
$ docker buildx build --cache-to=type=registry,ref=user/app .
982-
$ docker buildx build --cache-to=type=local,dest=path/to/cache .
983-
$ docker buildx build --cache-to=type=gha .
984-
$ docker buildx build --cache-to=type=s3,region=eu-west-1,bucket=mybucket .
985-
```
986-
987-
More info about cache exporters and available attributes: https://github.com/moby/buildkit#export-cache
988-
9891000
### Use a custom parent cgroup (--cgroup-parent) {#cgroup-parent}
9901001
9911002
When you run `docker buildx build` with the `--cgroup-parent` option,

data/buildx/docker_buildx_dap.yaml

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
command: docker buildx dap
2+
short: Start debug adapter protocol compatible debugger
3+
long: Start debug adapter protocol compatible debugger
4+
pname: docker buildx
5+
plink: docker_buildx.yaml
6+
cname:
7+
- docker buildx dap build
8+
clink:
9+
- docker_buildx_dap_build.yaml
10+
inherited_options:
11+
- option: builder
12+
value_type: string
13+
description: Override the configured builder instance
14+
deprecated: false
15+
hidden: false
16+
experimental: false
17+
experimentalcli: false
18+
kubernetes: false
19+
swarm: false
20+
- option: debug
21+
shorthand: D
22+
value_type: bool
23+
default_value: "false"
24+
description: Enable debug logging
25+
deprecated: false
26+
hidden: false
27+
experimental: false
28+
experimentalcli: false
29+
kubernetes: false
30+
swarm: false
31+
deprecated: false
32+
hidden: false
33+
experimental: false
34+
experimentalcli: true
35+
kubernetes: false
36+
swarm: false
37+
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
command: docker buildx dap attach
2+
short: Attach to a container created by the dap evaluate request
3+
long: Attach to a container created by the dap evaluate request
4+
usage: docker buildx dap attach PATH
5+
pname: docker buildx dap
6+
plink: docker_buildx_dap.yaml
7+
inherited_options:
8+
- option: builder
9+
value_type: string
10+
description: Override the configured builder instance
11+
deprecated: false
12+
hidden: false
13+
experimental: false
14+
experimentalcli: false
15+
kubernetes: false
16+
swarm: false
17+
- option: debug
18+
shorthand: D
19+
value_type: bool
20+
default_value: "false"
21+
description: Enable debug logging
22+
deprecated: false
23+
hidden: false
24+
experimental: false
25+
experimentalcli: false
26+
kubernetes: false
27+
swarm: false
28+
deprecated: false
29+
hidden: true
30+
experimental: false
31+
experimentalcli: true
32+
kubernetes: false
33+
swarm: false
34+

0 commit comments

Comments
 (0)