dtforce/dind-gradle

Docker-in-Docker with Gradle 镜像

1. 镜像概述与主要用途

本镜像集成Docker-in-Docker(DinD)和Gradle构建工具，为持续集成(CI)环境提供一体化解决方案。通过整合Docker容器化能力与Gradle构建工具链，可在CI流程中直接执行Docker命令（如镜像构建、推送）和Gradle任务（如编译、测试、打包），简化CI环境配置，提升构建流程一致性。

2. 核心功能与特性

• Docker-in-Docker支持：允许在容器内运行Docker守护进程及命令，实现CI环境中的Docker镜像构建与管理
• 内置Gradle工具：预安装Gradle构建系统，支持Java及其他Gradle项目构建，无需额外配置构建工具
• CI流程优化：整合Docker与Gradle工具链，减少环境依赖配置步骤，提升CI流水线效率

3. 使用场景与适用范围

• Gradle项目持续集成：需在CI中执行代码编译、单元测试、打包的Java及多语言项目
• 容器化构建流程：需在CI环境中构建Docker镜像并推送至仓库的应用开发场景
• 自动化构建部署：作为CI/CD流水线基础环境，支持从代码拉取到容器化部署的全流程操作

4. 使用方法与配置说明

4.1 运行要求

• 必须使用--privileged参数运行容器（Docker-in-Docker需要系统权限）
• 建议挂载持久化卷保存Gradle缓存和Docker数据，提升构建性能

4.2 环境变量配置

4.3 基本使用步骤

4.3.1 拉取镜像

bash
docker pull [镜像仓库地址]/dind-gradle:latest

4.3.2 启动容器

bash
docker run --privileged -d \
  -v gradle-cache:/root/.gradle \
  -v docker-data:/var/lib/docker \
  -e GRADLE_OPTS="-Xmx2048m" \
  --name ci-worker [镜像仓库地址]/dind-gradle:latest

4.3.3 执行构建任务

bash
# 进入容器
docker exec -it ci-worker /bin/bash

# 执行Gradle构建
gradle clean build

# 构建Docker镜像
docker build -t app:latest .

5. CI配置示例（GitLab CI）

在.gitlab-ci.yml中使用该镜像：

yaml
stages:
  - build
  - package

build:
  stage: build
  image: [镜像仓库地址]/dind-gradle:latest
  script:
    - gradle clean build -x test
  artifacts:
    paths:
      - build/libs/*.jar

package:
  stage: package
  image: [镜像仓库地址]/dind-gradle:latest
  script:
    - docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .
    - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
  needs:
    - job: build
      artifacts: true