myapp:latest (manifest list)
  ├── linux/amd64 (sha256:abc...)
  ├── linux/arm64 (sha256:def...)
  └── linux/arm/v7 (sha256:ghi...)

{
  "schemaVersion": 2,
  "mediaType": "application/vnd.oci.image.index.v1+json",
  "manifests": [
    {
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {"os": "linux", "architecture": "amd64"},
      "digest": "sha256:abc123..."
    },
    {
      "mediaType": "application/vnd.oci.image.manifest.v1+json",
      "platform": {"os": "linux", "architecture": "arm64"},
      "digest": "sha256:def456..."
    }
  ]
}

# 用户只需
docker pull myapp:latest

# Docker 自动完成
# 1. 拉取 manifest list
# 2. 根据当前系统架构选择对应的 manifest
# 3. 拉取对应的镜像层

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -t registry.example.com/myapp:latest \
  --push .

# 分别构建
docker build --platform linux/amd64 -t myapp:amd64 .
docker build --platform linux/arm64 -t myapp:arm64 .

# 推送到仓库
docker push myapp:amd64
docker push myapp:arm64

# 创建 manifest list
docker manifest create myapp:latest \
  myapp:amd64 \
  myapp:arm64

# 推送 manifest list
docker manifest push myapp:latest

manifest-tool push from-spec manifest.yaml

# 查看 manifest
docker manifest inspect myapp:latest

# 查看支持的架构
docker buildx imagetools inspect myapp:latest

Name:      docker.io/myapp:latest
MediaType: application/vnd.docker.distribution.manifest.list.v2+json
Digest:    sha256:xyz...

Manifests:
  linux/amd64   digest: sha256:abc...
  linux/arm64   digest: sha256:def...

# 指定平台拉取
docker pull --platform linux/arm64 myapp:latest

# 指定平台运行
docker run --platform linux/arm64 myapp:latest uname -m

# 需要手动指定架构 tag
docker pull myapp:latest-amd64
docker pull myapp:latest-arm64

# 确认基础镜像支持哪些架构
docker buildx imagetools inspect node:18