[CruiseControl]Build Dashboard
一 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：
<buildloop> tag用来指定cruisecontrol build loop相关的属性logsdir和artifactsdir。
<features> tag 包含了自定义Dashborad的属性allforcebuild。
<trackingtool> tag 包含属性projectname,baseurl和keywords，用来创建project管理工具的提交注解的链接。你的projects可以有零个或一个<trackingtool> tag。Dashborad将解析提交消息来发现指定关键字后面的story number，然后用指定的baseurl和story number来产生链接。例如如果你提交source code且提交消息为 "I fixed bug #425" 且定义<trackingtool>像 <trackingtool projectname="cc" baseurl="http://mingle05/projects/ccee/cards/" keywords="#,build"/>，那么Dashborad会为你的提交消息产生链接 "<a href=http://mingle05/projects/ccee/cards/425>I fixed bug #425</a>" 。
<subtabs> tag 被用来为build 详细页面指定widget plugin，你可以有零个或一个subtabs tags，其中一个subtabs可以包含多个subtab tags。
完！
