Docker Manifest 是 Docker 用于管理多架构镜像的核心功能，允许将不同平台（如 amd64、arm64）的镜像元数据整合为单一虚拟镜像，从而简化跨平台部署流程。以下是详细说明：

一、Manifest 的定义与作用

1. 基本概念
   Manifest 是一个 JSON 文件，包含多个镜像的元数据（如操作系统、架构、层信息等），用于描述一个虚拟镜像（称为 Manifest List 或 清单列表）。它本身不存储实际镜像层，而是指向不同架构镜像的清单文件。

   • Manifest List：通过 docker manifest create 命令生成，整合多个架构的镜像清单，客户端拉取时会根据当前平台自动选择对应镜像。
   • 实验性特性：截至 2025 年，docker manifest 仍处于实验性阶段，功能可能随版本迭代变化。

2. 核心功能

   • 多架构支持：允许通过单一镜像名称管理跨平台镜像（如 myapp:latest 同时包含 arm64 和 x86 版本）。
   • 简化部署：用户无需手动指定架构标签（如 myapp:arm64），直接拉取即可自动匹配本地环境。
   • 版本控制：与 Docker Registry 集成，支持推送和拉取 Manifest List，便于镜像分发与维护。

二、Manifest 的使用场景

1. 跨平台应用开发
   当应用需在 Linux、Windows 或不同硬件架构（如 ARM、PowerPC）上运行时，Manifest 可统一管理多版本镜像。
2. 云原生与容器编排
   在 Kubernetes 等环境中，Manifest 支持多架构镜像的滚动更新和自动调度，提升部署效率。
3. 私有仓库管理
   通过本地 Registry 搭建私有镜像仓库时，Manifest 可实现多架构镜像的集中存储与分发。

三、Manifest 的操作流程

1. 构建并推送多架构镜像

   • 为每个目标架构构建镜像并打上标签（如 myapp:arm64、myapp:x86），推送至 Docker Registry。

   docker build -t myapp:arm64 -f Dockerfile.arm . && docker push myapp:arm64
   docker build -t myapp:x86 -f Dockerfile.x86 . && docker push myapp:x86
   

2. 创建 Manifest List
   使用 docker manifest create 将多个镜像关联为虚拟镜像：

   docker manifest create myapp:latest myapp:arm64 myapp:x86
   

3. 注解架构信息
   通过 docker manifest annotate 为每个镜像指定操作系统和架构：

   docker manifest annotate myapp:latest myapp:arm64 --os linux --arch arm64
   docker manifest annotate myapp:latest myapp:x86 --os linux --arch amd64
   

4. 推送 Manifest List
   将清单列表推送到 Registry，使其生效：

   docker manifest push myapp:latest
   

5. 验证与使用

   • 通过 docker manifest inspect 查看清单详情。
   • 拉取时客户端自动选择匹配架构的镜像：

     docker pull myapp:latest  # 根据本地环境自动匹配 arm64/x86
     

四、注意事项

1. 实验性限制

   • docker manifest 命令需在 Docker 客户端启用实验模式（--experimental 或配置 daemon.json）。
   • 建议优先使用 docker buildx（Docker 19.03+）替代，其功能更完善且非实验性。

2. 多平台验证

   • 构建时需确保目标架构的镜像已正确推送至 Registry，否则拉取时可能失败。
   • 可通过 --insecure 参数临时允许不安全的 Registry 访问（仅限测试环境）。

3. 兼容性管理

   • 使用 docker manifest inspect 检查清单文件，确保所有镜像的元数据（如 os.version）一致。
   • 避免直接修改 Manifest List，需通过重新创建和推送覆盖。

五、技术原理

根据 OCI 规范，Manifest List 是一个索引文件，包含多个镜像清单（Manifest）的摘要和平台信息。拉取时，Docker 根据本地架构匹配对应的清单文件，进而下载实际镜像层。例如：

{
  "schemaVersion": 2,
  "mediaType": "application/vnd.docker.distribution.manifest.list.v2+json",
  "manifests": [
    {"mediaType": "application/vnd.docker.distribution.manifest.v2+json", "digest": "sha256:...amd64", "platform": {"architecture": "amd64", "os": "linux"}},
    {"mediaType": "application/vnd.docker.distribution.manifest.v2+json", "digest": "sha256:...arm64", "platform": {"architecture": "arm64", "os": "linux"}}
  ]
}

总结

Docker Manifest 是实现多架构镜像管理的核心工具，通过整合不同平台的镜像元数据，简化了跨环境部署流程。尽管其命令仍处于实验性阶段，但结合 docker buildx 等工具可进一步优化多架构支持。开发者需注意实验性限制，并通过验证和版本控制确保镜像兼容性。

参考链接：简单云(ezOne.work)一站式云原生DevOps研发协同平台|研发效能平台|让研发“简单一点”