docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

vendor: github.com/docker/buildx v0.21.0 

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
This commit is contained in:
jsternberg 2025-02-19 20:58:57 +00:00 committed by github-actions[bot]
parent 9bfe7ad474
commit d73f7624d5
9 changed files with 202 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
_vendor/github.com/docker/buildx/docs/bake-reference.md generated
View File

@ -285,19 +285,11 @@ The key takes a list of annotations, in the format of `KEY=VALUE`.
```hcl ```hcl
target "default" { target "default" {
output = ["type=image,name=foo"] output = [{ type = "image", name = "foo" }]
annotations = ["org.opencontainers.image.authors=dvdksn"] annotations = ["org.opencontainers.image.authors=dvdksn"]
} }
``` ```
is the same as
```hcl
target "default" {
output = ["type=image,name=foo,annotation.org.opencontainers.image.authors=dvdksn"]
}
```
By default, the annotation is added to image manifests. You can configure the By default, the annotation is added to image manifests. You can configure the
level of the annotations by adding a prefix to the annotation, containing a level of the annotations by adding a prefix to the annotation, containing a
comma-separated list of all the levels that you want to annotate. The following comma-separated list of all the levels that you want to annotate. The following
@ -305,7 +297,7 @@ example adds annotations to both the image index and manifests.
```hcl ```hcl
target "default" { target "default" {
output = ["type=image,name=foo"] output = [{ type = "image", name = "foo" }]
annotations = ["index,manifest:org.opencontainers.image.authors=dvdksn"] annotations = ["index,manifest:org.opencontainers.image.authors=dvdksn"]
} }
``` ```
@ -321,8 +313,13 @@ This attribute accepts the long-form CSV version of attestation parameters.
```hcl ```hcl
target "default" { target "default" {
attest = [ attest = [
"type=provenance,mode=min", {
"type=sbom" type = "provenance",
mode = "max",
},
{
type = "sbom",
}
] ]
} }
``` ```
@ -338,8 +335,15 @@ This takes a list value, so you can specify multiple cache sources.
```hcl ```hcl
target "app" { target "app" {
cache-from = [ cache-from = [
"type=s3,region=eu-west-1,bucket=mybucket", {
"user/repo:cache", type = "s3",
region = "eu-west-1",
bucket = "mybucket"
},
{
type = "registry",
ref = "user/repo:cache"
}
] ]
} }
``` ```
@ -355,8 +359,14 @@ This takes a list value, so you can specify multiple cache export targets.
```hcl ```hcl
target "app" { target "app" {
cache-to = [ cache-to = [
"type=s3,region=eu-west-1,bucket=mybucket", {
"type=inline" type = "s3",
region = "eu-west-1",
bucket = "mybucket"
},
{
type = "inline",
}
] ]
} }
``` ```
@ -863,7 +873,7 @@ The following example configures the target to use a cache-only output,
```hcl ```hcl
target "default" { target "default" {
output = ["type=cacheonly"] output = [{ type = "cacheonly" }]
} }
``` ```
@ -903,8 +913,8 @@ variable "HOME" {
target "default" { target "default" {
secret = [ secret = [
"type=env,id=KUBECONFIG", { type = "env", id = "KUBECONFIG" },
"type=file,id=aws,src=${HOME}/.aws/credentials" { type = "file", id = "aws", src = "${HOME}/.aws/credentials" },
] ]
} }
``` ```
@ -948,7 +958,7 @@ This can be useful if you need to access private repositories during a build.
```hcl ```hcl
target "default" { target "default" {
ssh = ["default"] ssh = [{ id = "default" }]
} }
``` ```

6
_vendor/modules.txt
View File

@ -1,6 +1,6 @@
# github.com/moby/moby v27.5.1+incompatible # github.com/moby/moby v27.5.1+incompatible
# github.com/moby/buildkit v0.19.0 # github.com/moby/buildkit v0.20.0
# github.com/docker/buildx v0.20.1 # github.com/docker/buildx v0.21.0
# github.com/docker/cli v27.5.1+incompatible # github.com/docker/cli v28.0.0-rc.2+incompatible
# github.com/docker/compose/v2 v2.33.0 # github.com/docker/compose/v2 v2.33.0
# github.com/docker/scout-cli v1.15.0 # github.com/docker/scout-cli v1.15.0

2
data/buildx/docker_buildx_build.yaml
View File

@ -18,7 +18,7 @@ options:
kubernetes: false kubernetes: false
swarm: false swarm: false
- option: allow - option: allow
value_type: stringSlice value_type: stringArray
default_value: '[]' default_value: '[]'
description: | description: |
Allow extra privileged entitlement (e.g., `network.host`, `security.insecure`) Allow extra privileged entitlement (e.g., `network.host`, `security.insecure`)

2
data/buildx/docker_buildx_debug_build.yaml
View File

@ -17,7 +17,7 @@ options:
kubernetes: false kubernetes: false
swarm: false swarm: false
- option: allow - option: allow
value_type: stringSlice value_type: stringArray
default_value: '[]' default_value: '[]'
description: | description: |
Allow extra privileged entitlement (e.g., `network.host`, `security.insecure`) Allow extra privileged entitlement (e.g., `network.host`, `security.insecure`)

2
data/buildx/docker_buildx_history.yaml
View File

@ -10,12 +10,14 @@ cname:
- docker buildx history ls - docker buildx history ls
- docker buildx history open - docker buildx history open
- docker buildx history rm - docker buildx history rm
- docker buildx history trace
clink: clink:
- docker_buildx_history_inspect.yaml - docker_buildx_history_inspect.yaml
- docker_buildx_history_logs.yaml - docker_buildx_history_logs.yaml
- docker_buildx_history_ls.yaml - docker_buildx_history_ls.yaml
- docker_buildx_history_open.yaml - docker_buildx_history_open.yaml
- docker_buildx_history_rm.yaml - docker_buildx_history_rm.yaml
- docker_buildx_history_trace.yaml
inherited_options: inherited_options:
- option: builder - option: builder
value_type: string value_type: string

105
data/buildx/docker_buildx_history_inspect.yaml
View File

@ -8,6 +8,18 @@ cname:
- docker buildx history inspect attachment - docker buildx history inspect attachment
clink: clink:
- docker_buildx_history_inspect_attachment.yaml - docker_buildx_history_inspect_attachment.yaml
options:
- option: format
value_type: string
default_value: pretty
description: Format the output
details_url: '#format'
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false
inherited_options: inherited_options:
- option: builder - option: builder
value_type: string value_type: string
@ -29,6 +41,99 @@ inherited_options:
experimentalcli: false experimentalcli: false
kubernetes: false kubernetes: false
swarm: false swarm: false
examples: |-
### Format the output (--format) {#format}
The formatting options (`--format`) pretty-prints the output to `pretty` (default),
`json` or using a Go template.
```console
$ docker buildx history inspect
Name: buildx (binaries)
Context: .
Dockerfile: Dockerfile
VCS Repository: https://github.com/crazy-max/buildx.git
VCS Revision: f15eaa1ee324ffbbab29605600d27a84cab86361
Target: binaries
Platforms: linux/amd64
Keep Git Dir: true
Started: 2025-02-07 11:56:24
Duration: 1m 1s
Build Steps: 16/16 (25% cached)
Image Resolve Mode: local
Materials:
URI DIGEST
pkg:docker/docker/dockerfile@1 sha256:93bfd3b68c109427185cd78b4779fc82b484b0b7618e36d0f104d4d801e66d25
pkg:docker/golang@1.23-alpine3.21?platform=linux%2Famd64 sha256:2c49857f2295e89b23b28386e57e018a86620a8fede5003900f2d138ba9c4037
pkg:docker/tonistiigi/xx@1.6.1?platform=linux%2Famd64 sha256:923441d7c25f1e2eb5789f82d987693c47b8ed987c4ab3b075d6ed2b5d6779a3
Attachments:
DIGEST PLATFORM TYPE
sha256:217329d2af959d4f02e3a96dcbe62bf100cab1feb8006a047ddfe51a5397f7e3 https://slsa.dev/provenance/v0.2
Print build logs: docker buildx history logs g9808bwrjrlkbhdamxklx660b
```
```console
$ docker buildx history inspect --format json
{
"Name": "buildx (binaries)",
"Ref": "5w7vkqfi0rf59hw4hnmn627r9",
"Context": ".",
"Dockerfile": "Dockerfile",
"VCSRepository": "https://github.com/crazy-max/buildx.git",
"VCSRevision": "f15eaa1ee324ffbbab29605600d27a84cab86361",
"Target": "binaries",
"Platform": [
"linux/amd64"
],
"KeepGitDir": true,
"StartedAt": "2025-02-07T12:01:05.75807272+01:00",
"CompletedAt": "2025-02-07T12:02:07.991778875+01:00",
"Duration": 62233706155,
"Status": "completed",
"NumCompletedSteps": 16,
"NumTotalSteps": 16,
"NumCachedSteps": 4,
"Config": {
"ImageResolveMode": "local"
},
"Materials": [
{
"URI": "pkg:docker/docker/dockerfile@1",
"Digests": [
"sha256:93bfd3b68c109427185cd78b4779fc82b484b0b7618e36d0f104d4d801e66d25"
]
},
{
"URI": "pkg:docker/golang@1.23-alpine3.21?platform=linux%2Famd64",
"Digests": [
"sha256:2c49857f2295e89b23b28386e57e018a86620a8fede5003900f2d138ba9c4037"
]
},
{
"URI": "pkg:docker/tonistiigi/xx@1.6.1?platform=linux%2Famd64",
"Digests": [
"sha256:923441d7c25f1e2eb5789f82d987693c47b8ed987c4ab3b075d6ed2b5d6779a3"
]
}
],
"Attachments": [
{
"Digest": "sha256:450fdd2e6b868fecd69e9891c2c404ba461aa38a47663b4805edeb8d2baf80b1",
"Type": "https://slsa.dev/provenance/v0.2"
}
]
}
```
```console
$ docker buildx history inspect --format "{{.Name}}: {{.VCSRepository}} ({{.VCSRevision}})"
buildx (binaries): https://github.com/crazy-max/buildx.git (f15eaa1ee324ffbbab29605600d27a84cab86361)
```
deprecated: false deprecated: false
hidden: false hidden: false
experimental: false experimental: false

54
data/buildx/docker_buildx_history_trace.yaml Normal file
View File

@ -0,0 +1,54 @@
command: docker buildx history trace
short: Show the OpenTelemetry trace of a build record
long: Show the OpenTelemetry trace of a build record
usage: docker buildx history trace [OPTIONS] [REF]
pname: docker buildx history
plink: docker_buildx_history.yaml
options:
- option: addr
value_type: string
default_value: 127.0.0.1:0
description: Address to bind the UI server
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false
- option: compare
value_type: string
description: Compare with another build reference
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false
inherited_options:
- option: builder
value_type: string
description: Override the configured builder instance
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false
- option: debug
shorthand: D
value_type: bool
default_value: "false"
description: Enable debug logging
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false

8
go.mod
View File

@ -3,16 +3,16 @@ module github.com/docker/docs
go 1.23.1 go 1.23.1
require ( require (
github.com/docker/buildx v0.20.1 // indirect github.com/docker/buildx v0.21.0 // indirect
github.com/docker/cli v27.5.1+incompatible // indirect github.com/docker/cli v28.0.0-rc.2+incompatible // indirect
github.com/docker/compose/v2 v2.33.0 // indirect github.com/docker/compose/v2 v2.33.0 // indirect
github.com/docker/scout-cli v1.15.0 // indirect github.com/docker/scout-cli v1.15.0 // indirect
github.com/moby/buildkit v0.19.0 // indirect github.com/moby/buildkit v0.20.0 // indirect
github.com/moby/moby v27.5.1+incompatible // indirect github.com/moby/moby v27.5.1+incompatible // indirect
) )
replace ( replace (
github.com/docker/buildx => github.com/docker/buildx v0.20.1 github.com/docker/buildx => github.com/docker/buildx v0.21.0
github.com/docker/cli => github.com/docker/cli v27.5.1+incompatible github.com/docker/cli => github.com/docker/cli v27.5.1+incompatible
github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.32.4 github.com/docker/compose/v2 => github.com/docker/compose/v2 v2.32.4
github.com/docker/scout-cli => github.com/docker/scout-cli v1.15.0 github.com/docker/scout-cli => github.com/docker/scout-cli v1.15.0

2
go.sum
View File

@ -92,6 +92,8 @@ github.com/docker/buildx v0.20.0 h1:XM2EvwEfohbxLPAheVm03biNHpspB/dA6U9F0c6yJsI=
github.com/docker/buildx v0.20.0/go.mod h1:VVi4Nvo4jd/IkRvwyExbIyW7u82fivK61MRx5I0oKic= github.com/docker/buildx v0.20.0/go.mod h1:VVi4Nvo4jd/IkRvwyExbIyW7u82fivK61MRx5I0oKic=
github.com/docker/buildx v0.20.1 h1:q88EfoYwrWEKVqNb9stOFq8fUlFp/OPlDcFE+QUYZBM= github.com/docker/buildx v0.20.1 h1:q88EfoYwrWEKVqNb9stOFq8fUlFp/OPlDcFE+QUYZBM=
github.com/docker/buildx v0.20.1/go.mod h1:VVi4Nvo4jd/IkRvwyExbIyW7u82fivK61MRx5I0oKic= github.com/docker/buildx v0.20.1/go.mod h1:VVi4Nvo4jd/IkRvwyExbIyW7u82fivK61MRx5I0oKic=
github.com/docker/buildx v0.21.0 h1:cp++wh60cjMraq8VXM59jV1aolR3eFIkCx1Z7o5Q2ZY=
github.com/docker/buildx v0.21.0/go.mod h1:8V4UMnlKsaGYwz83BygmIbJIFEAYGHT6KAv8akDZmqo=
github.com/docker/cli v24.0.2+incompatible h1:QdqR7znue1mtkXIJ+ruQMGQhpw2JzMJLRXp6zpzF6tM= github.com/docker/cli v24.0.2+incompatible h1:QdqR7znue1mtkXIJ+ruQMGQhpw2JzMJLRXp6zpzF6tM=
github.com/docker/cli v24.0.2+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8= github.com/docker/cli v24.0.2+incompatible/go.mod h1:JLrzqnKDaYBop7H2jaqPtU4hHvMKP+vjCwu2uszcLI8=
github.com/docker/cli v24.0.4+incompatible h1:Y3bYF9ekNTm2VFz5U/0BlMdJy73D+Y1iAAZ8l63Ydzw= github.com/docker/cli v24.0.4+incompatible h1:Y3bYF9ekNTm2VFz5U/0BlMdJy73D+Y1iAAZ8l63Ydzw=