buildx imagetools supports --metadata-file
Introduced 2026-03-04 · score 0.94
HOW TO USE IT
When creating a new image from registry sources, pass `--metadata-file` to write create-result metadata, including descriptor and digest values, as JSON. The output directory must already exist and be writable.
docker buildx imagetools create -t <image:tag> <source1> <source2> --metadata-file <metadata.json>WHY THIS HELPS
Capture descriptor or digest metadata while working with an image through imagetools.
REQUIREMENTS AND LIMITATIONS
- Version: v0.32.0
- --metadata-file <string>: Write create-result metadata as JSON to the specified file.
- -t, --tag <image>: Set the reference for the new image.
- SOURCE...: Source manifests or images; they must already exist in the registry where the new manifest is created.
- Prerequisite: The metadata file's directory must already exist and be writable.
- Prerequisite: Source manifests must already exist in the registry where the new manifest is created.
FIRST-PARTY EVIDENCE
- https://github.com/docker/buildx/releases/tag/v0.32.0
- https://github.com/docker/buildx/blob/v0.32.0/docs/reference/buildx_imagetools_create.md
Check the installed version and the source before using it. Entry JSON