Skip to content

Use buildx imagetools to assemble multi-arch manifests - #245

Merged
ericmj merged 1 commit into
mainfrom
fix-docker-manifest-imagetools
Jun 4, 2026
Merged

ericmj merged 1 commit into
mainfrom
fix-docker-manifest-imagetools

Conversation

@ericmj

@ericmj ericmj commented Jun 4, 2026

Copy link
Copy Markdown
Member

docker manifest push re-serializes each child manifest before upload. The amd64 per-arch images are pushed by buildx with 2-space indented JSON while the legacy docker manifest tool re-marshals to 3-space, changing the bytes and therefore the digest. The pushed child landed under a new digest while the manifest list still referenced the original, so the registry rejected the list with "manifest blob unknown: blob unknown to registry".

docker buildx imagetools create copies children by digest without re-serializing, so digests stay stable. It also keeps no local manifest store, avoiding the unbounded growth of ~/.docker/manifests left behind by "docker manifest push --purge" on failed pushes.

Install the buildx CLI plugin in the app image since it only shipped Debian's docker.io package without buildx.

docker manifest push re-serializes each child manifest before upload.
The amd64 per-arch images are pushed by buildx with 2-space indented
JSON while the legacy docker manifest tool re-marshals to 3-space,
changing the bytes and therefore the digest. The pushed child landed
under a new digest while the manifest list still referenced the
original, so the registry rejected the list with "manifest blob
unknown: blob unknown to registry".

docker buildx imagetools create copies children by digest without
re-serializing, so digests stay stable. It also keeps no local
manifest store, avoiding the unbounded growth of ~/.docker/manifests
left behind by "docker manifest push --purge" on failed pushes.

Install the buildx CLI plugin in the app image since it only shipped
Debian's docker.io package without buildx.
@ericmj
ericmj merged commit d02e4cb into main Jun 4, 2026
8 checks passed
@ericmj
ericmj deleted the fix-docker-manifest-imagetools branch June 4, 2026 09:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant