tomdesinto/jenkins-dsl-ready

Jenkins DSL Ready镜像说明

镜像概述

本镜像基于官方Jenkins镜像构建，预装Job DSL和Jenkins Configuration as Code（JCasC）插件，旨在通过单条Docker命令实现Jenkins及作业的自动化部署，简化安装与配置流程。

核心功能

1. 预装常用插件：Job DSL、JCasC、Pipeline、Git、SVN、GitHub Pull Request Builder等（完整列表见plugins.txt）；
2. 支持通过Git/SVN仓库或本地目录提供DSL脚本，自动创建作业；
3. 支持JCasC配置文件，实现Jenkins配置即代码；
4. 提供多种Docker-in-Docker（DinD）方案，支持作业中使用Docker命令。

使用场景

• 快速搭建Jenkins CI/CD环境；
• 自动化管理Jenkins作业，减少手动配置；
• 团队协作中标准化Jenkins部署流程；
• 需要通过代码定义Jenkins配置与作业的场景。

配置说明

基础运行

bash
docker run -d -p 8080:8080 tomdesinto/jenkins-dsl-ready

挂载本地DSL目录

bash
docker run -d -p 8080:8080 -v /本地/DSL目录:/usr/share/jenkins/ref/jobs/SeedJob/workspace/:ro tomdesinto/jenkins-dsl-ready

从Git/SVN拉取DSL脚本

bash
# Git
docker run -d -p 8080:8080 -e SEEDJOB_GIT=https://你的仓库地址.git tomdesinto/jenkins-dsl-ready
# SVN
docker run -d -p 8080:8080 -e SEEDJOB_SVN=svn://你的仓库地址 tomdesinto/jenkins-dsl-ready

JCasC配置

bash
docker run -d -p 8080:8080 -v /本地/JCasC配置.yml:/var/jenkins_home/casc_configs/jenkins.yml tomdesinto/jenkins-dsl-ready

Docker-in-Docker方案

方法1：共享主机Docker引擎（root用户）

bash
docker run -d \
  -u root \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -p 8080:8080 \
  --name jenkins \
  tomdesinto/jenkins-dsl-ready

方法2：共享主机Docker引擎（sudo方式）

bash
docker run -d \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -p 8080:8080 \
  --name jenkins \
  tomdesinto/jenkins-dsl-ready

方法3：使用DinD容器

bash
# 启动DinD容器
docker run -d --name dind \
  --privileged \
  -e DOCKER_DRIVER=overlay2 \
  -e DOCKER_TLS_CERTDIR='' \
  docker:19.03-dind

# 启动Jenkins容器
docker run -d \
  -p 8080:8080 \
  --link dind:dind \
  -e DOCKER_HOST=tcp://dind:2375 \
  --name jenkins \
  tomdesinto/jenkins-dsl-ready

DSL语法参考

• https://jenkinsci.github.io/job-dsl-plugin/
• https://github.com/jenkinsci/job-dsl-plugin/wiki/Tutorial---Using-the-Jenkins-Job-DSL

自定义镜像

1. 添加DSL脚本：将自定义DSL脚本放入dsl/目录，重新构建镜像；
2. 添加插件：编辑plugins.txt，每行添加一个插件ID（可指定版本，如greenballs:1.15）；
3. 安装依赖：在Dockerfile的customize below部分添加apt-get install命令安装所需工具。