guglio/dind-buildx

Docker in Docker with buildx 镜像文档

镜像概述和主要用途

本镜像为Docker-in-Docker(DIND)环境，集成了Docker 20.10.7和buildx 0.6.0工具。主要用于GitLab CI/CD流水线，特别适用于需要构建多架构Docker镜像（如amd64和arm架构）的场景。

Docker版本信息：

bash
Docker version 20.10.7, build f0df350

核心功能和特性

• Docker-in-Docker支持：提供完整的Docker环境，可在容器内运行Docker命令
• buildx集成：内置buildx 0.6.0，支持多架构镜像构建
• 多架构支持：可同时构建linux/arm/v7、linux/arm64/v8、linux/amd64等架构镜像
• GitLab CI兼容：已在.gitlab-ci.yml流水线中测试并使用，可直接集成到GitLab CI流程

使用场景和适用范围

• GitLab CI/CD流水线中的Docker镜像构建环节
• 需要构建多架构Docker镜像的开发和部署流程
• 持续集成环境中需要嵌套Docker环境的场景

使用方法和配置说明

GitLab CI配置示例

以下是在GitLab CI中使用本镜像构建并推送到GitLab容器仓库的完整配置示例：

yaml
variables:
  DOCKER_HOST: tcp://docker:2375/  # Docker守护进程地址
  DOCKER_DRIVER: overlay2          # 使用overlay2存储驱动

stages:
  - build  # 定义构建阶段

# 针对master分支的构建作业
docker-build-master:
  image: guglio/dind-buildx:latest  # 使用本镜像
  stage: build                      # 关联到build阶段
  services:
    - docker:20.10-dind             # 使用Docker-in-Docker服务
  before_script:
    # 登录GitLab容器仓库
    - docker login -u "$CI_REGISTRY_USER" -p "$CI_REGISTRY_PASSWORD" $CI_REGISTRY
  script:
    # 初始化QEMU以支持多架构构建，并创建buildx构建器
    - docker run --rm --privileged multiarch/qemu-user-static --reset -p yes; docker buildx create --use
    # 构建并推送多架构镜像到GitLab仓库
    - docker buildx build --push --platform linux/arm/v7,linux/arm64/v8,linux/amd64 --tag "$CI_REGISTRY_IMAGE" .
  only:
    - master  # 仅在master分支触发

# 针对标签的构建作业
docker-build-tag:
  image: guglio/dind-buildx:latest
  stage: build
  services:
    - docker:20.10-dind
  before_script:
    - docker login -u "$CI_REGISTRY_USER" -p "$CI_REGISTRY_PASSWORD" $CI_REGISTRY
  script:
    - docker run --rm --privileged multiarch/qemu-user-static --reset -p yes; docker buildx create --use
    # 构建并推送带标签的多架构镜像
    - docker buildx build --push --platform linux/arm/v7,linux/arm64/v8,linux/amd64 --tag "$CI_REGISTRY_IMAGE:$CI_COMMIT_TAG" .
  only:
    - tags  # 仅在标签推送时触发

配置说明

• 环境变量：

  • DOCKER_HOST: 指定Docker守护进程地址，通常设置为tcp://docker:2375/
  • DOCKER_DRIVER: 指定Docker存储驱动，推荐使用overlay2

• 关键步骤：

  1. 登录容器仓库：通过docker login命令使用GitLab CI提供的环境变量（CI_REGISTRY_USER、CI_REGISTRY_PASSWORD、CI_REGISTRY）进行身份验证
  2. 初始化多架构支持：通过multiarch/qemu-user-static镜像配置QEMU模拟环境
  3. 创建buildx构建器：使用docker buildx create --use创建并使用buildx构建上下文
  4. 构建多架构镜像：使用docker buildx build命令，通过--platform指定目标架构，--push参数直接推送到仓库

• GitLab CI环境变量：

  • CI_REGISTRY_IMAGE: GitLab项目的容器仓库地址
  • CI_COMMIT_TAG: 当前构建的标签名称（仅在标签构建时可用）