liveBook · Manning

Docker manifest command

As explained in Learn Docker in a Month of Lunches, Second Edition

A Docker manifest command is a Docker CLI subcommand for creating, inspecting, or pushing image manifests and manifest lists.

The docker manifest command works with image manifests and manifest lists. It can inspect registry metadata, create a local manifest list from platform-specific image tags, and push that list to a registry. section 12.3

Use the command in a multi-platform publishing workflow:

  • Inspect an existing image with docker manifest inspect; the output includes image digests, CPU architectures, and operating systems without pulling images locally. section 12.3
  • Create a manifest list that groups the platform-specific image tags under one image tag. section 12.3
  • Push the manifest list to the registry so one tag represents multiple platform variants. section 12.3
# create a manifest list with a name
# followed by all the tags it contains:
docker manifest create "$dockerId/ch12-folder-list:2e" `
 "$dockerId/ch12-folder-list:2e-linux-amd64" `
 "$dockerId/ch12-folder-list:2e-linux-arm64" `
 "$dockerId/ch12-folder-list:2e-linux-arm"
# push the manifest to Docker Hub:
docker manifest push "$dockerId/ch12-folder-list:2e"
# now browse to your page on Docker Hub and check the image

Create a manifest list from amd64, arm64, and arm tags, then push it to Docker Hub. section 12.3

How Learn Docker in a Month of Lunches, Second Edition covers it

How deep it goes
Explains inspection, local manifest-list creation, and registry pushing, but does not detail manifest metadata formats.
Examples
Uses docker manifest inspect diamol/base:2e and combines amd64, arm64, and arm image tags.
What it assumes
Assumes platform-specific images are tagged and pushed to an accessible registry.
What you can do after
Operate Docker CLI commands to inspect, create, and push a multi-platform manifest list.
How it connects
Connects image tags, image manifests, manifest lists, Docker registries, and platform-specific images.
Cover of Learn Docker in a Month of Lunches, Second Edition
liveBookmanning.com
Read Learn Docker in a Month of Lunches, Second Edition on liveBook Get the book at manning.com

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Learn Docker in a Month of Lunches, Second Edition. The section links point to the parts of the book it draws on.