jjlin/jenkins-docker

jjlin/jenkins-docker 镜像文档

镜像概述

jjlin/jenkins-docker 是基于 https://hub.docker.com/r/jenkins/jenkins/ 的定制化镜像，内置Docker和Docker Compose二进制文件，设计用于与主机Docker环境集成。该镜像通过GitHub Actions实现自动化构建，每日检查父镜像（官方Jenkins LTS）更新4次，确保版本同步及时性。

核心功能与特性

• 基于官方Jenkins LTS：继承官方长期支持版本的稳定性与功能完整性
• 内置Docker工具链：包含Docker和Docker Compose二进制文件，无需额外安装即可使用容器化构建能力
• 自动化构建机制：通过GitHub Actions监测父镜像更新，自动触发构建流程，保证版本时效性
• 主机Docker集成：支持直接与主机Docker服务通信，避免Docker-in-Docker架构的潜在问题

使用场景

适用于需要在Docker容器中运行Jenkins，同时需创建新Docker容器执行构建任务的场景。特别适合希望规避 https://jpetazzo.github.io/2015/09/03/do-not-use-docker-in-docker-for-ci/ 的CI/CD环境，实现安全高效的容器化构建流程。

使用方法与配置说明

必要配置

• 挂载主机Docker套接字：必须将主机的/var/run/docker.sock挂载至容器内相同路径，使Jenkins能够访问主机Docker服务
• 时间同步：建议挂载主机/etc/localtime文件（只读模式），确保容器时间与主机一致
• Java参数配置：通过JAVA_OPTS环境变量自定义Jenkins运行参数（如时区、内存配置等）

部署示例

Docker Run 部署命令

bash
docker run -itd --restart=always \
           -p 8080:8080 -p 50000:50000 \  # 映射Web界面端口(8080)和代理端口(50000)
           -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载主机Docker套接字实现集成
           -v /etc/localtime:/etc/localtime:ro \  # 同步主机时间
           -e JAVA_OPTS="-Duser.timezone=Antarctica/South_Pole" \  # 配置Java运行参数（示例为时区）
           --name jenkins-docker jjlin/jenkins-docker