mirror of https://github.com/docker/docs.git
117 lines
4.0 KiB
YAML
117 lines
4.0 KiB
YAML
command: docker buildx inspect
|
|
short: Inspect current builder instance
|
|
long: Shows information about the current or specified builder.
|
|
usage: docker buildx inspect [NAME]
|
|
pname: docker buildx
|
|
plink: docker_buildx.yaml
|
|
options:
|
|
- option: bootstrap
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Ensure builder has booted before inspecting
|
|
details_url: '#bootstrap'
|
|
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
|
|
details_url: '#builder'
|
|
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
|
|
examples: |-
|
|
### Ensure that the builder is running before inspecting (--bootstrap) {#bootstrap}
|
|
|
|
Use the `--bootstrap` option to ensure that the builder is running before
|
|
inspecting it. If the driver is `docker-container`, then `--bootstrap` starts
|
|
the BuildKit container and waits until it's operational. Bootstrapping is
|
|
automatically done during build, and therefore not necessary. The same BuildKit
|
|
container is used during the lifetime of the associated builder node (as
|
|
displayed in `buildx ls`).
|
|
|
|
### Override the configured builder instance (--builder) {#builder}
|
|
|
|
Same as [`buildx --builder`](/reference/cli/docker/buildx/#builder).
|
|
|
|
### Get information about a builder instance
|
|
|
|
By default, `inspect` shows information about the current builder. Specify the
|
|
name of the builder to inspect to get information about that builder.
|
|
The following example shows information about a builder instance named
|
|
`elated_tesla`:
|
|
|
|
> [!NOTE]
|
|
> The asterisk (`*`) next to node build platform(s) indicate they have been
|
|
> manually set during `buildx create`. Otherwise the platforms were
|
|
> automatically detected.
|
|
|
|
```console
|
|
$ docker buildx inspect elated_tesla
|
|
Name: elated_tesla
|
|
Driver: docker-container
|
|
Last Activity: 2022-11-30 12:42:47 +0100 CET
|
|
|
|
Nodes:
|
|
Name: elated_tesla0
|
|
Endpoint: unix:///var/run/docker.sock
|
|
Driver Options: env.BUILDKIT_STEP_LOG_MAX_SPEED="10485760" env.JAEGER_TRACE="localhost:6831" image="moby/buildkit:latest" network="host" env.BUILDKIT_STEP_LOG_MAX_SIZE="10485760"
|
|
Status: running
|
|
Flags: --debug --allow-insecure-entitlement security.insecure --allow-insecure-entitlement network.host
|
|
BuildKit: v0.10.6
|
|
Platforms: linux/arm64*, linux/arm/v7, linux/arm/v6
|
|
Labels:
|
|
org.mobyproject.buildkit.worker.executor: oci
|
|
org.mobyproject.buildkit.worker.hostname: docker-desktop
|
|
org.mobyproject.buildkit.worker.network: host
|
|
org.mobyproject.buildkit.worker.oci.process-mode: sandbox
|
|
org.mobyproject.buildkit.worker.selinux.enabled: false
|
|
org.mobyproject.buildkit.worker.snapshotter: overlayfs
|
|
GC Policy rule#0:
|
|
All: false
|
|
Filters: type==source.local,type==exec.cachemount,type==source.git.checkout
|
|
Keep Duration: 48h0m0s
|
|
Keep Bytes: 488.3MiB
|
|
GC Policy rule#1:
|
|
All: false
|
|
Keep Duration: 1440h0m0s
|
|
Keep Bytes: 24.21GiB
|
|
GC Policy rule#2:
|
|
All: false
|
|
Keep Bytes: 24.21GiB
|
|
GC Policy rule#3:
|
|
All: true
|
|
Keep Bytes: 24.21GiB
|
|
```
|
|
|
|
`debug` flag can also be used to get more information about the builder:
|
|
|
|
```console
|
|
$ docker --debug buildx inspect elated_tesla
|
|
```
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
|