jonoh/docker-buildx-qemu

docker-buildx-qemu

镜像概述和主要用途

docker-buildx-qemu是一个基于Debian的Docker镜像，集成了Docker客户端、buildx和QEMU工具，旨在简化跨平台Docker镜像的构建流程。该镜像已在GitLab CI环境（gitlab.com）中测试通过，适用于任何支持docker-in-docker（DinD）且内核启用binfmt_misc的环境。

核心功能和特性

• 基于Debian系统：提供稳定的基础运行环境
• 集成关键工具：包含Docker客户端、buildx构建工具和QEMU模拟器
• 跨平台支持：支持为不同CPU架构（如x86_64、ARM等）构建镜像
• CI/CD兼容：适配GitLab CI等持续集成环境
• 多平台构建：支持同时构建并推送多个平台的镜像

使用场景和适用范围

• 需要在CI/CD流水线中构建跨平台Docker镜像的场景
• 开发环境中需要为多种架构（如x86_64、arm/v7）构建镜像
• 需在单一环境中测试不同架构镜像运行情况的场景
• 任何支持docker-in-docker且内核启用binfmt_misc的环境

使用方法和配置说明

前提条件

• 环境需支持docker-in-docker（DinD）
• 内核需启用binfmt_misc模块

Dockerfile示例

dockerfile
FROM alpine

RUN echo "Hello, my CPU architecture is $(uname -m)"

GitLab CI配置示例

yaml
variables:
  DOCKER_HOST: tcp://docker:2375/  # 配置Docker守护进程连接地址

build:
  image: jonoh/docker-buildx-qemu  # 使用当前镜像
  stage: build
  services:
    - docker:dind  # 启动Docker-in-Docker服务
  before_script:
    # 登录到Docker仓库
    - docker login -u "$CI_REGISTRY_USER" -p "$CI_REGISTRY_PASSWORD" $CI_REGISTRY
    # 创建并使用docker-container驱动的buildx构建器（支持推送和多平台构建）
    - docker buildx create --driver docker-container --use
    # 初始化构建器
    - docker buildx inspect --bootstrap
  script:
    # 启用binfmt_misc以支持其他架构的二进制格式执行
    - update-binfmts --enable
    # 构建并推送多平台镜像（示例为arm/v7和本地架构）
    - docker buildx build --platform linux/arm/v7,local --pull -t "$CI_REGISTRY_IMAGE" --push .

输出示例

构建过程中会显示不同架构的构建结果，类似以下输出：

#6 [linux/amd64 2/2] RUN echo "Hello, my CPU architecture is $(uname -m)"#6 0.120 Hello, my CPU architecture is x86_64
#6 DONE 0.3s

#8 [linux/arm/v7 2/2] RUN echo "Hello, my CPU architecture is $(uname -m)"
#8 0.233 Hello, my CPU architecture is armv7l
#8 DONE 0.2s