jenkins的基本使用——解决html样式问题
一. jenkins未展示css样式的原理
官方解释:https://stackoverflow.com/questions/35783964/jenkins-html-publisher-plugin-no-css-is-displayed-when-report-is-viewed-in-j
简单来说,就是jenkins出于安全考虑,禁止了css和js的加载
详细原因:
Jenkins中配置的CSP(Content Security Policy)
这是Jenkins的一个安全策略,默认会设置了默认的权限权限集:sandbox; default-src 'none'; img-src 'self'; style-src 'self';
防止Jenkins用户在workspace、/userContent、archived artifacts中受到恶意HTML/JS文件的攻击。
在该配置下,只允许加载:
- Jenkins服务器上托管的CSS文件
- Jenkins服务器上托管的图片文件
而如下形式的内容都会被禁止:
- JavaScript
- plugins (object/embed)
- HTML中的内联样式表(Inline style sheets),以及引用的外站CSS文件
- HTML中的内联图片(Inline image definitions),以及外站引用的图片文件
- frames
- web fonts
- XHR/AJAX
- etc.
二. 解决方案
1. 临时方案1:
官网中也写明了解决方案,不过这个解决方案是临时的,jenkins重启后就失效了
翻译成中文就是:进入Jenkins》Manage Jenkins》Script Console》输入如下命令,点击运行,重新构建项目后的报告就可以展示样式了
System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")
2. 临时方案2
如果Jenkins为war包,也就是部署到tomcat上这种,可以通过java命令运行解决
关闭jenkins,命令行直接运行:java -Dhudson.model.DirectoryBrowserSupport.CSP= -jar D:\Jenkins\jenkins.war,路径根据自己的jenkins.war路径修改
不过这个方案也是临时的,tomcat重启后就不生效了
3. 永久解决方案1
修改catalina.bat文件,找到tomcat/bin下的catalina.bat文件,直接在文件中添加如下命令:
set CATALINA_OPTS="-Dhudson.model.DirectoryBrowserSupport.CSP=\"\""
添加完成后,需要重启tomcat,这样就可以永久有效了
4. 永久解决方案2
1)安装插件startup-trigger-plugin和Groovy,安装方式参考文档:https://www.cnblogs.com/leslie12956/p/13186158.html
2)新建一个job,该job专门用于Jenkins启动时执行的配置命令;每次jenkins启动都会自动执行该job
3)在构建触发器模块下,勾选Build when job nodes start;
4)在增加构建步骤,增加Execute system Groovy script,输入命令:System.setProperty("hudson.model.DirectoryBrowserSupport.CSP","")
注意: 我们的方法中,都是把安全策略设置为空,这样其实是有安全隐患的,实际应用中,可以根据自己的项目需要进行设置,详细的配置可参考:https://content-security-policy.com