使用Jenkins持续集成的一些经验总结！

01、Performance插件兼容性问题

自由风格项目中，有使用 Performance 插件收集构建产物，但是截至到目前最新版本（Jenkins v2.298，Performance：v3.19），此插件和Jenkins都存在有兼容性问题，会导致项目配置页面table，div错位，而导致无法保存配置，这个问题已经存在了好长时间了（至少半年），插件作者一直没有修复，目前在项目中要想使用这个插件，有以下三种解决办法：

将自由风格项目切换为流水线风格
服务器上手动修改项目的config.xml文件以达到保存配置的效果

Jenkins版本降级，经过测试，此插件在v2.263.4 LTS上可以正常使用，降级前做好备份工作，以及考虑其他插件的兼容性问题

02、修改Jenkins 安全策略（CSP）

场景：

借助 Robot Framework Plugin，可将Robot Framework项目更好的集成到Jenkins中，但是直接在Jenkins 项目中点击预览测试报告，会出现 Opening Robot Framework log failed 的错误，这是由于Jenkins为了避免受到恶意HTML/JS文件的攻击，会默认将安全策略CSP设置为：

sandbox; default-src 'none'; img-src 'self'; style-src 'self';

在此配置下，只允许加载Jenkins服务器上托管的CSS文件和图片文件。解决办法需要借助 Startup Trigger 和 Groovy plugin 两个插件，具体步骤如下：

Jenkins中新建一个Job，该Job专用Jenkins启动时执行的配置命令；
在“构建触发器”模块，选择“Build when job nodes start”选项，Restricted node Label保持空白，Quiet period设置为0；
在“构建”模块，选择“Execute system Groovy ”，执行如下Groovy命令:

System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")

重启Jenkins服务器进行测试，会发现等待所有节点连接成功后此项目会立即自动触发构建。再去触发Robot项目构建，等待完成后点击访问测试报告页面，会发现已经可以正常访问了；

03、自定义Jenkins相对访问路径

场景：

nginx 为Jenkins做目录代理，同时站点下还代理了很多其他的应用，这里需要自定义Jenkins相对访问路径。

本机访问Jenkins的路径为：http://localhost:29908，需要改为：http://localhost:29908/jenkins

方法如下：

在Jenkins安装根目录下找到 jenkins.xml文件
找到service节点下的 arguements 子节点，并在最后面添加--prefix参数：
--prefix="/jenkins"，其中 /jenkins 是自定义的访问路径
重启Jenkins服务，此时本机已经可以通过http://localhost:29908/jenkins进行访问
测试目录代理访问

注意：

如果在目录代理之前，子节点和主节点之间就已经通过JNLP的方式连接好了，则需要找到子节点根目录下的 jenkins-slave.xml 文件，将service.arguements节点-jnlpUrl 参数值修改为正确的值。

04、git clone失败 : Killed by signal 15

场景：

jenkins项目clone代码时，出现任务被kill掉的情况，导致出现以下错误信息：

通过查看控制台的输出日志，可以看出原因是因为超时了。如果在限制时间内代码都没有clone完成，那么就任务就会被强制杀死：

解决方法：

当所需要clone的版本库过大或服务器网速较差时，clone的时间会超过默认的10分钟。因此需要修改 clone 的超时时间。

设置方法如下：

Jenkins:Build step 'Execute Windows batch command' marked build as failure

场景：

使用Jenkins定时跑接口测试用例，明明所有的用例都执行成功了，但是还是会触发执行失败时的邮件通知，查看Jenkins控制台日志，发现是由于上面截图的原因导致的。

解决方法：

在bat脚本(shell同样适用)最后一行加上exit 0，表示正常运行程序并退出程序。

Jenkins运行在Tomcat容器中，替换jar包的方法

背景：jenkins.war中引用的 commons-fileupload-1.3.1-jenkins-2.jar 被扫出来有安全隐患，需要替换到最新的1.4版本，因为扫描的时候是根据版本来的，如果直接采用覆盖并重命名的方法，还是会被扫出来，目前采取的方法是创建软连接。

先下载最新的commons-fileupload-1.4.jar
创建软链接(管理员权限)，Linux系统下同理。

mklink webapps\jenkins\WEB-INF\lib\commons-fileupload-1.3.1-jenkins-2.jar webapps\jenkins\WEB-INF\lib\commons-fileupload-1.4.jar

把旧的commons-fileupload-1.3.1-jenkins-2.jar删除
重启tomcat

05、Windows节点机无法运行jnlp文件

在节点机双击jnlp文件没有反应时，可以尝试用命令行方式运行此文件，cmd进入jnlp文件目录下，运行 javaws slave-agent.jnlp，可以查看具体的错误提示，如下：

上图中这种情况，只需要修改下java安全配置即可解决，其他情况再具体分析。

06、关闭CSRF防护

Jenkins v2.204.6之前的版本，要想关闭CSRF防护，只需要在全局安全配置中禁用相关配置即可，但是较高版本的 Jenkins 默认均开启CSRF防护且删除了禁用的入口。要想禁用CSRF防护，只能通过配置参数的方式。

Jenkins若是跑在Tomcat下，只需在tomcat启动脚本中加入配置如下：

-Dhudson.security.csrf.GlobalCrumbIssuerConfiguration.DISABLE_CSRF_PROTECTION=true

若是以jar包形式部署的，只需在启动时加上配置参数即可。

07、修改 JVM 的内存配置

无论是以 Jdk Jar 方式运行Jenkins，还是将 War 包放在 Tomcat等容器下运行，都会存在一个问题：默认 JVM 内存分配太少，这导致启动或者运行一段时间后内存溢出报错java.lang.OutOfMemoryError: PermGen spac

所以，需要在启动前修改配置文件中的JVM 内存配置

set JAVA_OPTS=

-server

-Xms5000M

-Xmx5000M

-Xss512k

-XX:+AggressiveOpts

-XX:+UseBiasedLocking

-XX:PermSize=256M

-XX:MaxPermSize=512M

-XX:+DisableExplicitGC

-XX:MaxTenuringThreshold=31 -XX:+UseConcMarkSweepGC

-XX:+UseParNewGC

-XX:+CMSParallelRemarkEnabled -XX:+UseCMSCompactAtFullCollection -XX:LargePageSizeInBytes=128m -XX:+UseFastAccessorMethods -XX:+UseCMSInitiatingOccupancyOnly -Djava.awt.headless=true

这里的几个 JVM 参数含义如下：