基于Debian的Docker镜像在Alpine Dind环境构建时apt执行失败

核心原因 #

GitLab Runner若运行在x86_64架构机器上，使用docker:dind构建arm64镜像时，默认缺少QEMU用户态模拟支持，导致无法正确执行arm64架构的/bin/sh。本地能正常构建是因为你大概率已在本地Docker中配置了跨架构模拟（比如执行过docker run --privileged --rm tonistiigi/binfmt --install all），但CI环境的docker:dind默认未开启该功能。

具体解决步骤 #

• 在CI流水线中提前配置QEMU支持
  在构建镜像的Job中，先安装QEMU依赖并注册跨架构格式支持，确保docker:dind能处理arm64镜像：

  build:
    image: docker:latest
    services:
      - name: docker:dind
        command: ["--experimental"]
    variables:
      DOCKER_DRIVER: overlay2
      DOCKER_TLS_CERTDIR: "/certs"
    before_script:
      - apk add --no-cache qemu-user-static
      - docker run --privileged --rm tonistiigi/binfmt --install all
    script:
      - docker build --platform linux/arm64 -t your-image-name .
  

  其中qemu-user-static提供跨架构执行的底层依赖，tonistiigi/binfmt用来向Docker注册QEMU格式支持，让Docker自动调用QEMU运行arm64架构的容器命令。

• 指定docker:dind的具体版本并开启实验模式
  避免使用docker:dind的latest标签，尽量指定稳定版本（比如docker:25-dind），同时开启--experimental参数，部分跨架构构建功能需要依赖实验性支持。

• 确认Runner架构
  如果你的GitLab Runner本身是arm64架构机器，无需配置QEMU，直接构建即可；若为x86_64架构，则必须配置QEMU模拟。

• 验证基础镜像的架构正确性
  在CI构建前先拉取指定架构的基础镜像，避免因镜像缓存或源的问题拉取错误架构的镜像：

  docker pull --platform linux/arm64 python:3.12-slim
  

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