1.
认识CruiseControl
认识CruiseControl
CruiseControl
是
CI
服务器的老者，诞生已是多年，在许多方面，
CruiseControl
服务器已经成为持续集成实践的同义词。而现在，
CruiseControl
已发展成为一个家族式系统，包括
CruiseControl.java
、
CruiseControl.net
、
CruiseControl.ruby
等适应不同语言环境的实现，其强大的插件和扩展能力也是诸多同类系统无法比你的。而在这里，我只介绍该家族的本家
CruiseControl.java
，即
CruiseControl
。
是
CI
服务器的老者，诞生已是多年，在许多方面，
CruiseControl
服务器已经成为持续集成实践的同义词。而现在，
CruiseControl
已发展成为一个家族式系统，包括
CruiseControl.java
、
CruiseControl.net
、
CruiseControl.ruby
等适应不同语言环境的实现，其强大的插件和扩展能力也是诸多同类系统无法比你的。而在这里，我只介绍该家族的本家
CruiseControl.java
，即
CruiseControl
。
下图是
CruiseControl
系统的架构图：
CruiseControl
系统的架构图：
CruiseControl系统架构图
图中我们可以看到，
CruiseControl
系统的主体是
Build Loop
机制，它采用了
Source Code
轮询机制，对持续集成环境的状态进行定时检测，并根据
config.xml
配置信息做出相应处理。
CruiseControl
服务器则使用
HTTP
和
RMI
机制将持续集成服务公开到
Reporting
模块，同时使用
XML
数据格式对每次集成的数据进行归档。同时
CruiseControl
还可以集成了
RSS
、
IM
、
E-MAIL
等信息发布机制，最大程度将信息广播到团队的每个成员。
CruiseControl
系统的主体是
Build Loop
机制，它采用了
Source Code
轮询机制，对持续集成环境的状态进行定时检测，并根据
config.xml
配置信息做出相应处理。
CruiseControl
服务器则使用
HTTP
和
RMI
机制将持续集成服务公开到
Reporting
模块，同时使用
XML
数据格式对每次集成的数据进行归档。同时
CruiseControl
还可以集成了
RSS
、
IM
、
等信息发布机制，最大程度将信息广播到团队的每个成员。
CruiseControl
系统集成循环的流程图见下图，图中显示了
CruiseControl
使用轮询机制对版本库进行检测，并对发生变更的代码进行预定操作的流程：
系统集成循环的流程图见下图，图中显示了
CruiseControl
使用轮询机制对版本库进行检测，并对发生变更的代码进行预定操作的流程：
CruiseControl系统运行流程图
2.
CruiseControl的安装
CruiseControl的安装
CruiseControl
的安装有许多方式。例如，如果使用
Windows
，会发现最简单的方式是下载二进制可执行文件，然后运行它。不用担心，还可以下载源代码。
的安装有许多方式。例如，如果使用
Windows
，会发现最简单的方式是下载二进制可执行文件，然后运行它。不用担心，还可以下载源代码。
安装之后，
CruiseControl
预先配置了一个配置文件，轮询
CVS
（或其它版本控制系统）存储库并执行
ANT
构建脚本。服务环境不需要安装
Web
服务器，
CruiseControl
已经内嵌了
Jetty web
服务程序。
CruiseControl
预先配置了一个配置文件，轮询
CVS
（或其它版本控制系统）存储库并执行
ANT
构建脚本。服务环境不需要安装
Web
服务器，
CruiseControl
已经内嵌了
Jetty web
服务程序。
3.
CruiseControl的配置
CruiseControl的配置
当
CruiseControl
服务器启动时，会自动检测配置信息中的任务信息，并对其进行校验和初始化，之后所有的工作，都是依据该配置信息进行的。
CruiseControl
服务器启动时，会自动检测配置信息中的任务信息，并对其进行校验和初始化，之后所有的工作，都是依据该配置信息进行的。
CruiseControl
的配置使用了其安装目录下的
config.xml
文件，我们可以通过任一文本编辑器打开该配置文件，编辑各种配置信息。配置信息的定义遵循了标准
XML
文件格式，同时遵循了
ANT
自动构建配置信息的规则，因此建立一个普通工程的配置信息并非难事。
的配置使用了其安装目录下的
config.xml
文件，我们可以通过任一文本编辑器打开该配置文件，编辑各种配置信息。配置信息的定义遵循了标准
XML
文件格式，同时遵循了
ANT
自动构建配置信息的规则，因此建立一个普通工程的配置信息并非难事。
一个典型的配置文件如下所示：
|
<cruisecontrol>
<project name="BMSAssess">
<listeners>
<currentbuildstatuslistener file="logs/${project.name}/status.txt"/>
</listeners>
<bootstrappers>
<svnbootstrapper localWorkingCopy="projects/BMS/${project.name}" />
</bootstrappers>
<modificationset quietperiod="30">
<svn localWorkingCopy="projects/BMS/${project.name}/src/${project.name}"/>
</modificationset>
<schedule interval="300">
<ant anthome="apache-ant-1.6.5" buildfile="projects/BMS/${project.name}/src/${project.name}/build.xml"/>
</schedule>
<log>
<merge dir="projects/BMS/log/${project.name}/target/test-results"/>
</log>
</project>
</cruisecontrol>
|
配置文件有一个
cruisecontrol
根结点，其下则是代表一个项目的
project
子节点，再下层是项目的具体配置，在此示例中，存在了
listeners
、
bootstrappers
、
modificationset
、
schedule
、
log
几个节点，分别代表了监听器、本地目录、变更目录、构建任务、日志工作。
cruisecontrol
根结点，其下则是代表一个项目的
project
子节点，再下层是项目的具体配置，在此示例中，存在了
listeners
、
bootstrappers
、
modificationset
、
schedule
、
log
几个节点，分别代表了监听器、本地目录、变更目录、构建任务、日志工作。
3.1.
创建一个项目
创建一个项目
|
<project name="BMSAssess">
<listeners>
<currentbuildstatuslistener file="logs/${project.name}/status.txt"/>
</listeners>
……………
</project>
|
一个持续集成项目是从
project
节点开始的，可以对该项目进行的操作都会作为子节点存在与该节点之下。对于每一个
project
节点，
CruiseControl
系统都会将其当作一个处理单元，并在最初建立该项目的时候进行初始化操作。
project
节点开始的，可以对该项目进行的操作都会作为子节点存在与该节点之下。对于每一个
project
节点，
CruiseControl
系统都会将其当作一个处理单元，并在最初建立该项目的时候进行初始化操作。
name
是
project
节点常用的属性，也是必设且值唯一的属性，该属性的值会在整个
CruiseControl
系统使用，包括配置文件的
${project.name}
变量值。
是
project
节点常用的属性，也是必设且值唯一的属性，该属性的值会在整个
CruiseControl
系统使用，包括配置文件的
${project.name}
变量值。
在一个项目节点中，我们可以定义监听器、本地目录位置、变更轮询目录位置、轮询间隔、任务执行、单元测试、日志记录等多种项目操作，同时
CruiseControl
系统支持插件扩展功能，这些扩展插件可以直接在一个项目中使用。
CruiseControl
系统支持插件扩展功能，这些扩展插件可以直接在一个项目中使用。
3.2.
轮询版本控制系统
轮询版本控制系统
版本库轮询机制是使用
modificationset
进行配置的。
CruiseControl
系统内置的轮询模块会根据设定的时间段对版本库进行检测，一旦发现版本库发生变更，就会调用
Check Out
à
Build
à
Test
à
Publish
等一系列的操作，对最新的代码进行集成，并运行一系列预先设定的任务。
modificationset
进行配置的。
CruiseControl
系统内置的轮询模块会根据设定的时间段对版本库进行检测，一旦发现版本库发生变更，就会调用
Check Out
à
Build
à
Test
à
Publish
等一系列的操作，对最新的代码进行集成，并运行一系列预先设定的任务。
CruiseControl
支持十多种版本控制系统，比如
CVS
、
SVN
、
Starteam
、
VSS
等，对这些版本控制系统的调用，只需要配置相应的节点名称即可。本文以
SVN
版本管理系统为例。
支持十多种版本控制系统，比如
CVS
、
SVN
、
Starteam
、
VSS
等，对这些版本控制系统的调用，只需要配置相应的节点名称即可。本文以
SVN
版本管理系统为例。
在
modificationset
节中，我们看到唯一的一个子节点：
modificationset
节中，我们看到唯一的一个子节点：
|
<svn localWorkingCopy="projects/BMS/${project.name}/src/${project.name}"/>
|
该节点使用了
svn
关键字，表示当前工程使用的版本控制系统是
SVN
，
localWorkingCopy
属性的值是告诉
CruiseControl
本地的拷贝目录（拷贝目录概念详见
SVN
官方文档），其余的工作则由
CruiseControl
内置的操作模块进行。
svn
关键字，表示当前工程使用的版本控制系统是
SVN
，
localWorkingCopy
属性的值是告诉
CruiseControl
本地的拷贝目录（拷贝目录概念详见
SVN
官方文档），其余的工作则由
CruiseControl
内置的操作模块进行。
3.3.
执行构建脚本
执行构建脚本
实质上，执行构建脚本也是
CruiseControl
的一个可定制任务，但由于自动构建是持续集成的一个重要组成部分，因此在此单独提出。
CruiseControl
的一个可定制任务，但由于自动构建是持续集成的一个重要组成部分，因此在此单独提出。
CruiseControl
的自动构建是使用
ANT
工具来进行的，当然我们也可以使用其它的自动构建工具来替代（比如
Maven
），这些的工具仅仅是体现在一个任务配置语句上，在此，以
ANT
工具为例。
的自动构建是使用
ANT
工具来进行的，当然我们也可以使用其它的自动构建工具来替代（比如
Maven
），这些的工具仅仅是体现在一个任务配置语句上，在此，以
ANT
工具为例。
在
schedule
节，我们同样使用了一个子节点来描述自动构建工作：
schedule
节，我们同样使用了一个子节点来描述自动构建工作：
|
<ant anthome="ant6" buildfile="projects/BMS/${project.name}/src/${project.name}/build.xml"/>
|
该节点使用了
ant
关键字，表示该任务使用了
ant
来进行自动构建任务，
anthome
属性则指定了
ANT
工具的具体位置，
buildfile
属性则指定了
ANT
进行自动构建所使用的配置文件
Build.xml
文件的路径。
ant
关键字，表示该任务使用了
ant
来进行自动构建任务，
anthome
属性则指定了
ANT
工具的具体位置，
buildfile
属性则指定了
ANT
进行自动构建所使用的配置文件
Build.xml
文件的路径。
这样，在
CruiseControl
决定进行自动构建任务时，会根据设定找到执行所使用到的信息。
CruiseControl
决定进行自动构建任务时，会根据设定找到执行所使用到的信息。
3.4.
执行单元测试
执行单元测试
CruiseControl
可以自动侦测自动构建配置文件中单元测试的任务，并在代码集成完毕将执行结果反馈到相应的模块。
可以自动侦测自动构建配置文件中单元测试的任务，并在代码集成完毕将执行结果反馈到相应的模块。
ANT
支持
xUnit
系列的单元测试框架，只需要在配置文件中加入一个
target
节，即可在自动构建完成之后，进行单元测试工作，有关的详细配置，请参阅
ANT
官方文档。
支持
xUnit
系列的单元测试框架，只需要在配置文件中加入一个
target
节，即可在自动构建完成之后，进行单元测试工作，有关的详细配置，请参阅
ANT
官方文档。
4.
CruiseControl的使用
CruiseControl的使用
4.1.
启动CruiseControl服务器
启动CruiseControl服务器
通过上一节的配置，
CruiseControl
系统已经可以正常运行并管理项目了。我们可以通过执行其安装目录下的
cruisecontrol.bat
文件来启动
CruiseControl
。控制台显示“
BuildQueue – BuildQueue started
”，则说明
CruiseControl
服务器已成功启动，如下图：
CruiseControl
系统已经可以正常运行并管理项目了。我们可以通过执行其安装目录下的
cruisecontrol.bat
文件来启动
CruiseControl
。控制台显示“
BuildQueue – BuildQueue started
”，则说明
CruiseControl
服务器已成功启动，如下图：
CruiseControl服务器已成功启动
在启动服务器之前，我们可以打开
cruisecontrol.bat
文件并修改倒数第三行相应功能的端口数值来指定服务器占用的系统端口，在本例中我们将
-webport
指定到了
8082
端口。
cruisecontrol.bat
文件并修改倒数第三行相应功能的端口数值来指定服务器占用的系统端口，在本例中我们将
-webport
指定到了
8082
端口。
4.2.
管理工程
管理工程
服务器启动之后，我们便可以使用
http://IP:8082/
来访问
CruiseControl
的
Web
服务器（注：将
IP
替换成
CruiseControl
服务器所在主机的
IP
地址）。如下图所示：
http://IP:8082/
来访问
CruiseControl
的
Web
服务器（注：将
IP
替换成
CruiseControl
服务器所在主机的
IP
地址）。如下图所示：
CruiseControl服务器主界面
上图中我们可以看到，当前
CruiseControl
系统存在
5
个工程，列表中显示了各个工程的相关信息，包括当前状态、上次失败时间、上次成功时间、构建次数等信息，同时
Build
按钮可以让
CruiseControl
立即检测工程状态。
CruiseControl
系统存在
5
个工程，列表中显示了各个工程的相关信息，包括当前状态、上次失败时间、上次成功时间、构建次数等信息，同时
Build
按钮可以让
CruiseControl
立即检测工程状态。
点击相应工程名称，则可以进入该工程的详细页面首页，我们在这里以
BMSViewer
工程为例，点击进入，如下图所示：
BMSViewer
工程为例，点击进入，如下图所示：
BMSViewer工程详细信息首页
BMSViewer
工程详细信息首页清晰明了，主要包括了构建历史信息、最近构建结果、最近构建版本库信息等，该页面可以让我们对当前工程的集成信息一目了然，便于我们对不同的集成结果做出相应的处理。
工程详细信息首页清晰明了，主要包括了构建历史信息、最近构建结果、最近构建版本库信息等，该页面可以让我们对当前工程的集成信息一目了然，便于我们对不同的集成结果做出相应的处理。
页面上部的导航按钮可以让我们进入不同信息的查看界面，包括测试结果、
XML
详细日志文件、状态统计等信息。这些导航按钮根据工程设置的不同扩展任务而有所不同。
XML
详细日志文件、状态统计等信息。这些导航按钮根据工程设置的不同扩展任务而有所不同。
4.3.
工程状态统计图
工程状态统计图
通过工程首页可以清晰的看到当前工程代码级别的集成信息，但对于更加上层的统计图示信息，我们就需要进入
Metrics
页面，查看其构建衰减图、代码违背图，如图所示：
Metrics
页面，查看其构建衰减图、代码违背图，如图所示：
BMSViewer的工程状态统计图
图中主要显示了构建衰减图的比例图示和时间动态分布图，便于我们对工程的集成工作进行统一的控制和调配。
4.4.
使用publish扩展
使用publish扩展
在
CruiseControl
的主界面和工程的详细界面，我们都可以看到一个
RSS
的图标，该图标表示了当前
CruiseControl
系统提供了
RSS
新闻聚合功能，对于工程的构建结果，我们便可以使用
RSS
阅读器来获得，而不必登录
Web
服务器，如图所示：
CruiseControl
的主界面和工程的详细界面，我们都可以看到一个
RSS
的图标，该图标表示了当前
CruiseControl
系统提供了
RSS
新闻聚合功能，对于工程的构建结果，我们便可以使用
RSS
阅读器来获得，而不必登录
Web
服务器，如图所示：
工程详细页面的RSS按钮
下图则为使用
Foxmail
读取
RSS
聚合信息的截图：
Foxmail
读取
RSS
聚合信息的截图：
Foxmail读取RSS聚合信息
5.
总结
总结
持续集成为我们带来诸多好处，大量降低集成时间的同时，更重要的是它可以迅速对我们的工作做出反馈，增加了我们的勇气和信心，保证了项目的质量。持续集成已经不像以前只存在于理论的名词，只要你愿意你都可以实施持续集成。
当然这些好处是建立在制度的遵循和详尽的单元测试的基础上的，持续集成系统仅仅是我们项目过程中的一个工具而已，正如
scm
工具、单元测试一样。工具就是工具，而真正默默起作用的则是团队制度的完善，这也正体现了
XP
开发模式的原则――以人为本，快速反馈。
scm
工具、单元测试一样。工具就是工具，而真正默默起作用的则是团队制度的完善，这也正体现了
XP
开发模式的原则――以人为本，快速反馈。
