核心是Buildx+Manifest List自动协同：一次配置即可并行构建多架构镜像、自动推送并生成manifest list，拉取时按本地架构自动匹配，无需手动操作。
用 Docker Manifest 实现跨 CPU 架构一键部署，核心不是手动拼凑清单，而是靠 Buildx + Manifest List 自动协同。只要配置一次构建命令，Docker 就能自动为多个平台生成镜像、打标签、推送到仓库，并生成统一的 manifest list——拉取时完全无感，运行时自动匹配本地架构。
第一步：准备好支持多架构的构建环境
Buildx 默认不启用多平台能力，需显式创建并启动一个带 QEMU 模拟支持的构建器：
- 启用实验性功能（如未开启）：export DOCKER_CLI_EXPERIMENTAL=enabled
- 注册 QEMU 仿真器（首次运行）：docker run --privileged multiarch/qemu-user-static --reset -p yes
- 创建并切换到多架构构建器：docker buildx create --use --name mybuilder --bootstrap
- 验证是否支持目标平台：docker buildx inspect | grep Platforms，应看到类似 linux/amd64, linux/arm64, linux/arm/v7
第二步：用单条命令完成构建+推送+清单生成
不再需要分别 build、push、manifest create；Buildx 的 --push 会自动触发 manifest list 创建并上传：
- 执行构建命令（以 x86_64 和 ARM64 为例）：
docker buildx build \
--platform linux/amd64,linux/arm64 \
--push \
-t your-registry/app:latest \
. - 该命令会在后台并行构建两个镜像，推送到仓库后，自动在 your-registry/app:latest 下生成一个 manifest list
- 无需额外 push 各自的架构标签，也不用手动调用 docker manifest create
第三步：验证与实际使用
部署端完全透明，用户只需照常拉取和运行：
- 查看镜像支持哪些架构：docker buildx imagetools inspect your-registry/app:latest（推荐，比 docker manifest inspect 更直观）
- 在 x86_64 机器上执行 docker pull your-registry/app:latest → 自动拉取 linux/amd64 层
- 在 Apple M2 或树莓派上执行相同命令 → 自动拉取 linux/arm64 层
- 若需强制测试某架构（如本地 x86 机器跑 ARM 镜像）：docker run --platform linux/arm64 -it your-registry/app:latest
关键注意事项
- 基础镜像必须是多架构的（如 ubuntu:22.04、alpine:latest），否则构建会失败或只出一个平台
- 构建机需有足够资源（CPU/内存），并行构建多平台会显著增加开销
- 私有 Registry 需支持 OCI Image Index（主流如 Harbor v2.0+、GitHub Container Registry、GitLab Container Registry 均支持）
- 避免混用旧方式（如先 build 多个 tag 再手动 manifest create），易出错且无法享受 Buildx 缓存优化
