如何在GitLab CI分阶段推送Docker Buildx多架构镜像至Nexus

针对你遇到的问题，核心原因是Buildx构建的多架构镜像是manifest list（指向不同架构镜像的索引），而非单架构镜像，普通docker save/load只能处理单个镜像，无法完整导出/导入整个多架构镜像集合。以下是可行的实现方案：

核心思路：使用OCI标准tarball保存/恢复多架构镜像 #

Docker Buildx支持将多架构镜像导出为符合OCI标准的tar包，这个格式包含完整的manifest list和所有架构的镜像层，完美适配跨服务器的构建-推送分离场景。

步骤1：构建阶段（GitLab CI Build Job） #

在构建服务器上执行以下操作：

1. 初始化Buildx builder（若未创建）：

   docker buildx create --use
   

2. 构建多架构镜像并导出为OCI tarball：

   docker buildx build \
     --platform linux/amd64,linux/arm64,linux/arm/v7 \
     -t your-registry/your-image:your-tag \
     --output type=oci,dest=multi-arch-image.tar \
     .
   

3. 将生成的multi-arch-image.tar配置为GitLab CI的Artifact，确保后续推送阶段能跨服务器获取：

   # .gitlab-ci.yml 中Build Job的配置
   build:
     stage: build
     script:
       - 上述构建命令
     artifacts:
       paths:
         - multi-arch-image.tar
       expire_in: 1d # 根据需求设置过期时间
   

步骤2：推送阶段（GitLab CI Push Job） #

在推送服务器上执行以下操作：

1. 从Artifact中获取multi-arch-image.tar后，导入到Buildx：

   docker buildx imagetools import multi-arch-image.tar --tag your-registry/your-image:your-tag
   

2. 推送多架构镜像到仓库：

   docker push your-registry/your-image:your-tag
   

注意事项 #

• 确保GitLab CI服务器上的Docker Buildx版本足够新（建议v0.8+），以支持OCI导出和imagetools import命令。
• 若使用私有镜像仓库，需在推送阶段提前执行docker login完成认证。
• 不要拆分单架构镜像推送，否则会丢失多架构manifest list，用户拉取时无法自动匹配架构。

内容的提问来源于stack exchange，提问作者crimson_code