一 CruiseControl Dashborad是什么
CruiseControl Dashboard是一个强大的工具帮助你可视化你的projects的状态。先前projects的build结果被彩色标记显示,以至于你能立即地获 得你的projects的build结果。builds结果被用来表现当前project的状态的图标来更直接地表现(例如,暂停,队 列,building)。
当把你的鼠标放到用来表示project builds的彩色方块上,你能够看到关于project跟多的信息,例如project的名字,project运行的server和最后一个build发生的时间。
彩色方块的意义:
通常,方块有绿色或红色的背景色,红色表示最后一个build失败,绿色表示最后一个build成功。build保持它的状态越长,它的颜色就越 深。特殊情况是如果一个project上次build成功,当前build时显示为绿色,如果一个project上次build失败,当前build时显 示为橙色。
下面是一些你可能看到的状态的实例,且存在更多的组合情况,但是你应该能够从下面的例子推断他们,
表示一个project的最后的成功的build超过了24小时,且当前正在队列等待build;
表示一个project在过去的24内的最后的build是成功的;
表示一个project的build失败且超过了24小时;
表示一个project在过去的24内的最后的build是失败的,且当前处于暂停状态;
表示一个project的上次build是成功的,且当前正处于build状态;
表示一个project处于非激活或停止状态;
下面是你能够执行的动作的列表:访问project build的RSS feed,使用CCTray或CruiseControl JMX console访问xml feed.
二 Dashborad的Build 页面
这就是build页面,它能使你查看每个project build和build的状态,且能够对project执行下列的动作:
查看所有成功的build;
查看所有的build;
强制启动一个build;
访问每个project的build RSS feed和CruiseControl JMX console;
三 Dashborad的Build 详细页面
1)build详细页面
build详细页面包含了project的build信息,例如最后成功的build,build number,build的间隔和最后25个build。
2)当前build的详细页面
这个是当前build的project的详细页面。build的输出会被实时地显示在这里。
四 Dashborad的administration页面
在这个页面你能够看到dashboard配置的详细信息,例如是哪个build,正在运行的JVM的os和JVM版本信息。通过单击 configuration子tab,可以看到dashboard从哪里读取configuration和configuration的具体信息。
五 Dashboard的限制
如果你移除了project的log文件,Dashborad不能自动地发现且标志project为非激活。你需要refresh页面。如果你删除了project的log文件夹,CruiseControl不会重新创建它知道你重新启动CruiseControl。
如果你移除了project从CruiseControl的config.xml配置文件,Dashborad不能自动地发现且标志project为中止。你需要refresh页面。
尽管build loop能够自动应用对config.xml配置文件的修改,但是Dashborad不能获得dashborad-config.xml配置文件的修改。你需要重新启动Dashborad来使修改生效。
六 Dashborad的配置
有以下三种方法配置Dashborad,如下:
- J2EE server的web.xml。这种方法是不赞成的;
*Dashborad-config.xml 这种是配置Dashborad推荐的方法。默认的dashbord-config.xml随CruiseControl一起发布且与用来配置build loop的config.xml位于相同的位置。
*系统属性(system properties) 你可以使用系统属性来重写配置文件的设置;
系统属性:
管理员可以传递系统属性通过cruisecontrol.sh/cruisecontrol.bat或者web container启动脚本.
Property | Value | Default Value | Description |
---|---|---|---|
cc.config.forcebuild | enabled/disabled | enabled | 是否用户能够从gui来强制启动build |
cc.logdir | String | logs | 用来指定CruiseControl的log的全目录 |
cc.artifacts | String | artifacts | 用来指定build的binary/master的全路径 |
dashboard.config | String | dashboard-config.xml | 用来指定Dashborad配置文件的路径 |
Dashborad配置文件Dashborad-config.xml: