buildx_imagetools_create
Combine per-platform image tags into a single multi-arch manifest list and push it in one operation.
Instructions
Create a manifest list / OCI image index from existing per-platform tags.
Replaces docker manifest create + docker manifest push — builds the index and pushes it in
one operation. Source tags must already be pushed; this only stitches them together. Verify
the result with buildx_imagetools_inspect.
Does not raise on a non-zero CLI exit — inspect returncode/stderr in the result.
args:
target - Tag for the new manifest list (-t)
sources - Source image references to combine
append - Append to the existing manifest at target rather than replacing
dry_run - Print the resulting manifest without pushing
annotations - OCI annotations (repeatable; passed verbatim)
platforms - Filter source platforms when combining
descriptor_files - Files to read source descriptors from, instead of refs (copied to the
target host if no local plugin)
builder - Override the active builder
timeout_seconds - Subprocess timeout (default 600s)
returns: dict - {"returncode": int, "stdout": str, "stderr": str, "truncated": bool}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| append | No | ||
| target | Yes | ||
| builder | No | ||
| dry_run | No | ||
| sources | Yes | ||
| platforms | No | ||
| annotations | No | ||
| timeout_seconds | No | ||
| descriptor_files | No |