buildx_imagetools_inspect
Inspect registry image manifests remotely without pulling, supporting OCI indexes, attestations, and annotations. Retrieve detailed metadata for single or multi-platform images.
Instructions
Inspect a manifest in a registry without pulling.
Replaces docker manifest inspect. The standalone docker manifest command is in
maintenance mode and lacks support for OCI image indexes, attestations, and
annotations — buildx imagetools inspect is the path forward and handles both
single-platform manifests and multi-platform manifest lists / OCI indexes. Uses the docker
CLI's credential store; registry_manifest answers the same question over direct HTTPS
with no daemon or plugin.
args:
image - Image reference, e.g. "alpine:3.19" or "ghcr.io/org/repo@sha256:..."
raw - Return the raw manifest bytes (a JSON document) instead of the
human-rendered tree
format - Go template format string (mutually exclusive with raw)
builder - Override the active builder
returns: dict - {"returncode": int, "stdout": str, "stderr": str, "truncated": bool}.
When raw=True or format="{{json .}}", stdout is a JSON document
the caller can parse.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | ||
| image | Yes | ||
| format | No | ||
| builder | No |