GitLab CI多架构构建全流程：以gh_mirrors/do/dockerfiles为例

1. 核心概念

• 多架构构建：同时生成支持不同CPU架构（如amd64, arm64, arm/v7）的容器镜像
• Buildx：Docker官方多架构构建工具，需配合QEMU模拟器
• Manifest列表：统一管理多架构镜像的索引文件

2. 环境准备

在.gitlab-ci.yml中配置基础环境：

variables:
  DOCKER_DRIVER: overlay2
  DOCKER_TLS_CERTDIR: ""
  # 使用GitLab容器仓库
  CI_REGISTRY_IMAGE: registry.gitlab.com/gh_mirrors/do/dockerfiles

services:
  - docker:dind  # 启用DinD(Docker-in-Docker)

before_script:
  - apk add --no-cache curl qemu qemu-system-x86_64  # 安装QEMU
  - docker run --rm --privileged multiarch/qemu-user-static --reset -p yes  # 注册模拟器
  - docker buildx create --name multiarch --use  # 创建Buildx构建器

3. 构建流程设计

graph LR
  A[代码提交] --> B{检测架构需求}
  B -->|amd64| C[构建x86镜像]
  B -->|arm64| D[构建ARM镜像]
  B -->|arm/v7| E[构建ARMv7镜像]
  C & D & E --> F[合并Manifest]
  F --> G[推送到仓库]

4. CI流水线示例

stages:
  - build

multiarch-build:
  stage: build
  script:
    - |
      docker buildx build \
        --platform linux/amd64,linux/arm64,linux/arm/v7 \
        -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA \
        -t $CI_REGISTRY_IMAGE:latest \
        --push .  # 关键参数：--push直接推送
  rules:
    - if: $CI_COMMIT_BRANCH == "main"

5. 关键参数说明

参数	作用
--platform	指定目标架构列表
--push	构建后直接推送至仓库
--builder multiarch	使用预配置的Buildx构建器
-t	设置镜像标签，推荐使用提交SHA和latest双标签

6. 验证与测试

# 查看manifest列表
docker manifest inspect $CI_REGISTRY_IMAGE:latest

# 按架构拉取测试
docker pull --platform linux/arm64 $CI_REGISTRY_IMAGE:latest

7. 优化建议

1. 缓存加速：添加Buildx缓存配置

   --cache-to type=registry,ref=$CI_REGISTRY_IMAGE:cache
   --cache-from type=registry,ref=$CI_REGISTRY_IMAGE:cache
   

2. 矩阵构建：分架构并行构建（需GitLab Runner支持）
3. 安全扫描：集成Trivy镜像漏洞扫描

   after_script:
     - docker run aquasec/trivy image $CI_REGISTRY_IMAGE:latest
   

8. 常见问题解决

• QEMU报错：确保before_script中模拟器注册成功
• 构建超时：调整runner资源限制或分阶段构建
• 权限问题：配置CI_JOB_TOKEN的write_registry权限

实际项目参考：在gh_mirrors/do/dockerfiles中，可通过.gitlab-ci.yml查看完整实现，重点关注platform参数配置和DinD服务初始化流程。