Description

A draft tracking issue for containerd multiplatform image UX PRs

The general rule of platform selection is:

1. Commands without --platform should act on the "full" multi-platform image instead of a single platform from that image if possible. Commands that act on information purely based on image config, should default to any present platform, but prefer the one matching the daemon host platform.
2. If the above is not possible, the command should act on any present platform, but prefer the one matching the daemon host platform.
3. Otherwise, the command should error and force user to explicitly pass a specific platform that the operation should act on.

docker push --platform=...

Pick a platform-specific manifest and push it instead of the whole multi-platform index.

• Add CLI switch - cli/push: Add platform switch  docker/cli#4984
• Server implementation - c8d/push: Support --platform switch #47679

docker images --tree

Make docker images output multi-platform aware

• Expose platform-specific subimages informations in the API endpoint - c8d: Multi-platform image list #47526
• PoC on the CLI side - image/list: Add --tree flag docker/cli#4982
• Implement as cli/command/formatter

docker convert (cancelled)

Create new docker images from the existing multi-platform images and filter their manifests.
In future this could also support other operations (like converting layer compression, etc).

NOTE: While docker image create could be a better name for this, docker create is already an alias to docker container create.

• CLI implementation - image: Add convert command docker/cli#4983
• Server implementation - c8d: Add ImageConvert #47678

docker inspect --platform=...

• Expose platform-specific subimages informations in the API endpoint - c8d/inspect: Add Manifests field #48264
• Platform selection [server] - image/inspect: Add platform selection #49586
• Add CLI switch - image/inspect: Add --platform flag docker/cli#5934

docker rmi --platform=...

Remove content of the specified platform

• Add CLI switch image rm: add --platform option docker/cli#6109
• Server implementation c8d/delete: Add support for deleting specific platforms #49982

docker save --platform=...

Pick a platform-specific manifest and save it instead of the whole multi-platform index.

• Add CLI switch c8d: Add --platform flag to history, save and load docker/cli#5331
• Server implementation c8d: Add platform parameter to history, save and load #48295

docker load --platform=...

Load the image from the tarball (multi-platform index), but only import specified platform blobs.

• Add CLI switch c8d: Add --platform flag to history, save and load docker/cli#5331
• Server implementation c8d: Add platform parameter to history, save and load #48295

docker history --platform=...

Show history for the specified platform, otherwise will show the host platform, if host platform isn't available, it will pick any.

• Add CLI switch c8d: Add --platform flag to history, save and load docker/cli#5331
• Server implementation c8d: Add platform parameter to history, save and load #48295