mcreations/jenkins

非官方轻量级Jenkins镜像

基于OpenWRT镜像的Jenkins持续集成/部署服务器，具有小体积特点，且与官方Alpine版本不同，提供glibc支持。

这是一个功能完整的Jenkins服务器，基于长期支持（LTS）版本。更多信息请访问http://jenkins.io/。

最新版本请查看https://hub.docker.com/r/mcreations/jenkins/

使用方法

bash
docker run -p 8080:8080 -p 50000:50000 docker.xuanyuan.run/mcreations/jenkins

注意：关于50000端口映射的作用，请参见下文“附加构建执行器”部分。

数据持久化

Jenkins工作区存储在/data/jenkins_home目录，所有Jenkins数据（包括插件和配置）都保存在此目录。建议显式创建卷以方便管理和升级：

bash
docker run -p 8080:8080 -p 50000:50000 -v jenkins_home:/data/jenkins_home docker.xuanyuan.run/mcreations/jenkins

这将在Docker主机上自动创建jenkins_home卷，该卷在容器停止/重启/删除后仍会保留。

避免将主机目录直接绑定挂载到/data/jenkins_home，这可能导致文件权限问题。如果确实需要绑定挂载，请确保主机目录对容器内的jenkins用户（uid 201）可访问，或使用-u some_other_user参数：

bash
docker run --name myjenkins -p 8080:8080 -p 50000:50000 -v /your/jenkins_home:/data/jenkins_home docker.xuanyuan.run/mcreations/jenkins

数据备份

如果使用卷挂载，只需备份jenkins_home目录即可。建议将jenkins_home视为数据库来管理（在Docker中通常将数据库放在卷上）。

如果卷位于容器内，可使用docker cp $ID:/data/jenkins_home命令提取数据。注意某些操作系统上的符号链接可能会被转换为副本（这可能导致Jenkins的lastStableBuild等链接出现问题）。

更多信息请查看Docker文档的https://docs.docker.com/engine/tutorials/dockervolumes/部分。

设置执行器数量

可通过groovy脚本指定Jenkins主实例的执行器数量。默认设置为2个执行器，可扩展镜像修改为所需数量：

创建executors.groovy：

groovy
import jenkins.model.*
Jenkins.instance.setNumExecutors(5)

创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/mcreations/jenkins
COPY executors.groovy /usr/share/jenkins/ref/init.groovy.d/executors.groovy

附加构建执行器

默认情况下，可在主节点上运行构建。

如果需要通过JNLP（Java Web Start）附加构建从节点服务器：确保映射50000端口：-p 50000:50000，该端口用于从节点代理连接。

如果仅使用https://wiki.jenkins-ci.org/display/JENKINS/SSH+Slaves+plugin，则不需要映射此端口。

传递JVM参数

可能需要自定义运行Jenkins的JVM，通常用于传递系统属性或调整堆内存设置。使用JAVA_OPTS环境变量实现：

bash
docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS=-Dhudson.footerURL=http://mycompany.com docker.xuanyuan.run/mcreations/jenkins

配置日志

Jenkins日志可通过属性文件和java.util.logging.config.file Java属性配置。例如：

bash
mkdir data
cat > data/log.properties <<EOF
handlers=java.util.logging.ConsoleHandler
jenkins.level=FINEST
java.util.logging.ConsoleHandler.level=FINEST
EOF
docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS="-Djava.util.logging.config.file=/data/jenkins_home/log.properties" -v `pwd`/data:/data/jenkins_home docker.xuanyuan.run/mcreations/jenkins

配置反向代理

如果要在带有前缀的反向代理后安装Jenkins（例如：mysite.com/jenkins），需添加环境变量JENKINS_OPTS="--prefix=/jenkins"，然后根据使用的Apache或Nginx配置反向代理：

• https://wiki.jenkins-ci.org/display/JENKINS/Running+Jenkins+behind+Apache
• https://wiki.jenkins-ci.org/display/JENKINS/Jenkins+behind+an+NGinX+reverse+proxy

传递Jenkins启动参数

运行Jenkins镜像时传递的参数将被传递给Jenkins启动器，例如：

bash
docker run docker.xuanyuan.run/mcreations/jenkins --version

这将输出Jenkins版本，就像运行可执行war包一样。

也可通过JENKINS_OPTS定义Jenkins参数，这在基于官方镜像自定义派生镜像时特别有用。以下示例Dockerfile使用此选项强制使用HTTPS并包含证书：

dockerfile
FROM docker.xuanyuan.run/mcreations/jenkins:1.565.3

COPY https.pem /var/lib/jenkins/cert
COPY https.key /var/lib/jenkins/pk
ENV JENKINS_OPTS --httpPort=-1 --httpsPort=8083 --httpsCertificate=/var/lib/jenkins/cert --httpsPrivateKey=/var/lib/jenkins/pk
EXPOSE 8083

还可通过定义JENKINS_SLAVE_AGENT_PORT更改默认从节点代理端口：

dockerfile
FROM docker.xuanyuan.run/mcreations/jenkins:1.565.3
ENV JENKINS_SLAVE_AGENT_PORT 50001

或作为docker运行参数：

bash
docker run --name myjenkins -p 8080:8080 -p 50001:50001 --env JENKINS_SLAVE_AGENT_PORT=50001 docker.xuanyuan.run/mcreations/jenkins

安装更多工具

可将容器以root用户运行，通过opkg（OpenWRT默认包管理器）安装工具，或通过Jenkins工具安装器在构建步骤中安装，也可创建自定义Dockerfile：

dockerfile
FROM docker.xuanyuan.run/mcreations/jenkins
USER root
RUN opkg update && opkg install ruby make more-thing-here
# 切换回常规jenkins用户 - 良好实践
USER jenkins

在派生镜像中，可通过/usr/share/jenkins/ref目录定义默认JENKINS_HOME内容：

dockerfile
FROM docker.xuanyuan.run/mcreations/jenkins
COPY custom.groovy /usr/share/jenkins/ref/init.groovy.d/custom.groovy

预安装插件

可使用install-plugins.sh脚本下载插件及其依赖。使用插件 artifact ID（不带-plugin后缀），如需指定版本可添加:版本号。Jenkins war包中已包含的依赖仅在需要更新版本时才会下载。

dockerfile
FROM docker.xuanyuan.run/mcreations/jenkins
RUN /usr/local/bin/install-plugins.sh docker-slaves github-branch-source:1.8

Jenkins容器启动时，会检查JENKINS_HOME是否包含引用内容，必要时复制。不会覆盖现有文件，因此通过UI升级的插件不会在下次启动时被还原。

如需覆盖现有文件，可在引用文件名后添加.override。例如，/usr/share/jenkins/ref/config.xml.override将覆盖JENKINS_HOME中的config.xml。

另请参见https://issues.jenkins-ci.org/browse/JENKINS-24986。

从现有服务器获取插件列表的示例命令：

bash
JENKINS_HOST=username:password@myhost.com:port
curl -sSL "http://$JENKINS_HOST/pluginManager/api/xml?depth=1&xpath=/*/*/shortName|/*/*/version&wrapper=plugins" | perl -pe 's/.*?<shortName>([\w-]+).*?<version>([^<]+)()(<\/\w+>)+/\1 \2\n/g'|sed 's/ /:/'

示例输出：

cucumber-testresult-plugin:0.8.2
pam-auth:1.1
matrix-project:1.4.1
script-security:1.13
...

对于2.x派生镜像，可能需要：

dockerfile
RUN echo 2.0 > /usr/share/jenkins/ref/jenkins.install.UpgradeWizard.state

以指示Jenkins安装已完全配置，否则会显示提示用户安装其他插件的横幅。

升级

所有必要数据都存储在/data/jenkins_home目录中，升级方式取决于数据管理方式。通常，可导出数据，然后执行docker pull获取最新LTS镜像，再使用-v指向该数据目录启动，即可恢复之前的配置。

请确保熟悉Docker的卷管理！

升级插件

默认情况下，如果插件未手动升级且docker镜像中的版本较新，插件将被升级。docker镜像安装的版本通过标记文件跟踪。

从未写入标记文件的docker镜像升级时，默认保留现有插件。如需升级无标记的现有插件，可使用-e TRY_UPGRADE_IF_NO_MARKER=true运行docker镜像，此时将升级为docker镜像提供的较新版本。

构建

使用常规命令构建：

bash
docker build -t jenkins .

测试使用https://github.com/sstephenson/bats编写，位于`tests`目录：

bash
bats tests

在OS X上可通过brew install bats轻松安装Bats。

问题反馈

如有问题，请发送邮件至***或在https://github.com/m-creations/docker-jenkins提交issue。