github.com/pdmccormick/importable-docker-buildx@v0.0.0-20240426161518-e47091289030/docs/reference/buildx_inspect.md (about)

     1  # buildx inspect
     2  
     3  ```text
     4  docker buildx inspect [NAME]
     5  ```
     6  
     7  <!---MARKER_GEN_START-->
     8  Inspect current builder instance
     9  
    10  ### Options
    11  
    12  | Name                        | Type     | Default | Description                                 |
    13  |:----------------------------|:---------|:--------|:--------------------------------------------|
    14  | [`--bootstrap`](#bootstrap) |          |         | Ensure builder has booted before inspecting |
    15  | [`--builder`](#builder)     | `string` |         | Override the configured builder instance    |
    16  
    17  
    18  <!---MARKER_GEN_END-->
    19  
    20  ## Description
    21  
    22  Shows information about the current or specified builder.
    23  
    24  ## Examples
    25  
    26  ### <a name="bootstrap"></a> Ensure that the builder is running before inspecting (--bootstrap)
    27  
    28  Use the `--bootstrap` option to ensure that the builder is running before
    29  inspecting it. If the driver is `docker-container`, then `--bootstrap` starts
    30  the BuildKit container and waits until it's operational. Bootstrapping is
    31  automatically done during build, and therefore not necessary. The same BuildKit
    32  container is used during the lifetime of the associated builder node (as
    33  displayed in `buildx ls`).
    34  
    35  ### <a name="builder"></a> Override the configured builder instance (--builder)
    36  
    37  Same as [`buildx --builder`](buildx.md#builder).
    38  
    39  ### Get information about a builder instance
    40  
    41  By default, `inspect` shows information about the current builder. Specify the
    42  name of the builder to inspect to get information about that builder.
    43  The following example shows information about a builder instance named
    44  `elated_tesla`:
    45  
    46  > **Note**
    47  >
    48  > The asterisk (`*`) next to node build platform(s) indicate they have been
    49  > manually set during `buildx create`. Otherwise the platforms were
    50  > automatically detected.
    51  
    52  ```console
    53  $ docker buildx inspect elated_tesla
    54  Name:          elated_tesla
    55  Driver:        docker-container
    56  Last Activity: 2022-11-30 12:42:47 +0100 CET
    57  
    58  Nodes:
    59  Name:           elated_tesla0
    60  Endpoint:       unix:///var/run/docker.sock
    61  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"
    62  Status:         running
    63  Flags:          --debug --allow-insecure-entitlement security.insecure --allow-insecure-entitlement network.host
    64  BuildKit:       v0.10.6
    65  Platforms:      linux/arm64*, linux/arm/v7, linux/arm/v6
    66  Labels:
    67   org.mobyproject.buildkit.worker.executor:         oci
    68   org.mobyproject.buildkit.worker.hostname:         docker-desktop
    69   org.mobyproject.buildkit.worker.network:          host
    70   org.mobyproject.buildkit.worker.oci.process-mode: sandbox
    71   org.mobyproject.buildkit.worker.selinux.enabled:  false
    72   org.mobyproject.buildkit.worker.snapshotter:      overlayfs
    73  GC Policy rule#0:
    74   All:           false
    75   Filters:       type==source.local,type==exec.cachemount,type==source.git.checkout
    76   Keep Duration: 48h0m0s
    77   Keep Bytes:    488.3MiB
    78  GC Policy rule#1:
    79   All:           false
    80   Keep Duration: 1440h0m0s
    81   Keep Bytes:    24.21GiB
    82  GC Policy rule#2:
    83   All:        false
    84   Keep Bytes: 24.21GiB
    85  GC Policy rule#3:
    86   All:        true
    87   Keep Bytes: 24.21GiB
    88  ```
    89  
    90  `debug` flag can also be used to get more information about the builder:
    91  
    92  ```console
    93  $ docker --debug buildx inspect elated_tesla
    94  ```