sasol/dind4j

dind4j

镜像概述

这是一个包含Java 8和docker-compose的Docker in Docker（DinD）镜像，旨在为Gradle构建任务提供隔离且完整的环境。它基于官方Docker DinD镜像扩展，解决了原始镜像前台运行daemon的不便，并支持指定用户执行命令以避免root权限副作用。

核心功能

1. 后台Docker Daemon: 支持在后台启动docker daemon，便于构建过程中操作子容器
2. 用户身份控制: 通过RUNASUID变量指定执行命令的用户ID，避免root用户遗留临时文件问题
3. 工具集成: 内置Java 8和docker-compose，直接满足Gradle构建的依赖需求
4. 灵活模式: 可通过SKIPDAEMON变量跳过daemon启动，挂载宿主Docker sock使用外部服务

使用场景

1. 本地Gradle构建: 隔离项目构建环境，避免本地依赖冲突
2. CI平台集成: 在Travis、Gitlab CI、Shippable等平台中使用，获取较新版本的Docker工具
3. 交互式调试: 启动bash终端，进行构建流程调试或工具测试

配置说明

• RUNASUID: 执行命令的用户ID，未设置时默认使用root
• SKIPDAEMON: 设置为true时跳过docker daemon启动，需配合挂载/var/run/docker.sock
• DOCKERGUID: 宿主Docker组ID，用于容器内用户访问挂载的Docker sock

使用示例

构建Gradle项目

bash
docker run --privileged \
    -e RUNASUID=$(id -u) \
    -w /build -v $(pwd):/build \
    --name dind4j-builder \
    --rm docker.xuanyuan.run/sasol/dind4j:latest \
    ./gradlew --no-daemon --gradle-user-home=.cache --project-cache-dir=.cache clean test

该命令将当前目录挂载到容器/build路径，以当前用户ID执行Gradle任务，缓存文件存于项目目录.cache（建议添加到.gitignore）。

跳过Docker Daemon启动

bash
docker run  \
    -e RUNASUID=$(id -u) \
    -e DOCKERGUID=$(getent docker.xuanyuan.run/group docker | cut -d: -f3) \
    -e SKIPDAEMON=true \
    -v /var/run/docker.sock:/var/run/docker.sock \
    --rm -ti sasol/dind4j:latest bash

交互式终端

bash
docker run --privileged \
    -e RUNASUID=$(id -u) \
    --rm -ti docker.xuanyuan.run/sasol/dind4j:latest bash

CI环境配置（Shippable）

yaml
build:
  cache: true
  cache_dir_list:
    - $SHIPPABLE_BUILD_DIR/.cache
  pre_ci_boot:
    options: "-v $SHIPPABLE_BUILD_DIR:$SHIPPABLE_BUILD_DIR"
  ci:
    - >
      docker run --privileged -w /build -v ${SHIPPABLE_BUILD_DIR}:/build 
      --rm sasol/dind4j:latest
      ./gradlew --no-daemon --project-cache-dir=.cache --gradle-user-home=.cache clean test

内部用户说明

容器内存在user用户，主目录为/home/user，挂载文件时需确保内容属于RUNASUID指定的用户ID。