[CruiseControl]Build Result JSP

 

一 Build Result JSP

Build Result JSP被设计用来呈现CruiseControl的build loop的结果。页面的左边是关于Cruisecontrol是否正在build你的project，同时也提供先前build的链接。页面的右边是build的结果，包括编译错误，测试结果，从上次build后所修改的文件的列表。

Build Result JSP 如下图：

 

二 Build Result JSP如何工作

JSP使用自定义的tag来处理大部分过程。这使得code和content分离，开发人员只需要修改code不必关心page的设计，设计人员可以集中精力在page的布局上不必知道任何Java code。所有的字体和颜色都使用css文件来控制，以至于所有的样式都可以被容易地集中地配置。

JSP右边的build detail部分是对CruiseControl build loop的xml log使用xsl转化后生成的html。 JSP左边的部分是由CruiseControl的log目录下的log文件的列表生成的html。JSP根据一定的命名规范来区分log所属的project。JSP通过build loop开始和结束时生成特定的text文件来决定当前那个build正在运行。

 

三 Build Result JSP的配置

1）build 参数（从源代码安装时）

我们知道build Result JSP页面需要build loop的结果来生成，所以如果手动从源代码生成JSP时，需要指定参数： ​​user.log.dir​​​, ​​user.build.status.file​​​, 和 ​​cruise.build.artifacts.dir。​​

​​2）系统属性​​

​​系统属性被用来在CruiseControl进程和Report application间传递命令行参数，如下属性：ccname，cruisecontrol.jmxport，cruisecontrol.jmxhost，cruisecontrol.rmiport。​​

​​3）配置web.xml​​

​​JSP reporting程序使用context参数和servlet初始化参数来配置和自定义。这些参数都可以直接在web.xml中修改。​​

​​context参数：​​

cacheRoot 指定目录作为xsl转化的缓存，web context必须对此目录有写权限，如果没有指定 ，缓存会被保存在logdir的子目录called_cache。但是binary安装不指定此值。logDir 指定cruisecontrol的log目录。如果是在单project模式下，log将直接在此目录下。如果是多project模式，将为每个project建立自己的子目录。默认值是build参数user.log.dir，但是对于binary安装时为logs。

singleProject 指定是否cruisecontrol实例只处理一个project。默认为false。

currentBuildStatusFile 指定currentbuildstatuslistener产生的当前build状态文件的名字，且该文件位于projects的log目录。默认地该值为build参数user.build.status.file所指定的值。但是对于binary安装此值为status.txt。

fileServlet.welcomeFiles 当servlet显示浏览的目录时使用的index页面，可以指定空格分隔的多个index页面，默认为index.htm，index.html。

cruisecontrol.jmxhost  指定JMX HttpAdaptor的host。

cruisecontrol.jmxport  指定JMX HttpAdaptor的port。

​​xslt.* 任何以xslt开始的参数都被传递到xsl stylesheets当做xslt参数。​​  

​​servlet参数：​​

​​rootDir 指定build 的binary/master存储的绝对路径。如果没有指定logdir将被使用。默认值为build参数，cruise.build.artifacts.dir。但是binary安装时为artifacts。  ​​

​​4）xslt参数 ​​

​​一些xsl stylesheets能通过xslt参数来配置。这些参数作为context参数来传递，但是有xslt前缀。例如参数xslt.viewcvs.url来配置viewcvs.url。 ​​

​​pmd.warning.threshold pmd优先级高于threshod将被认为是警告且在build result页面上报告数量。
viewcvs.url 指定viewcvs的url，此url将被cvstagdiff.xsl, checkstyle-details.xsl and pmd-details.xsl使用，默认不指定。
cvstagdiff.success.show 指定当build成功时，是否viewcvs的不同报告应该被显示。默认只是显示broken build的修改报告。
checkstyle.hide.warnings 指定是否checkstyle错误或所有的checkstyle错误和警告应该被显示在build results页面。设置为true，表示不显示警告，默认为显示所有的错误和警告。这个默认是不指定的。​​

完！

 

作者：​ ​iTech​​

微信公众号: cicdops

github：​ ​https://github.com/cicdops/cicdops​​