CruiseControl配置说明
CruiseControl是一个持续集成工具,持续集成是一个很好的敏捷实践。在项目中搭建CruiseControl环境,通过执行频繁的项目构建,及时暴露出隐藏的Bug,从而减少定位以及修改Bug的时间和代价。本文介绍了配置CruiseControl的步骤。配置环境为Ubuntu
9.10,CruiseControl
2.8.3 Binary,版本管理工具为SVN。
一.准备工作
1.配置Java环境
calvin@calvin-desktop:~$
sudo gedit /etc/profile
在文件末尾添加Java环境变量:
#set
java environment
export
JAVA_HOME=/home/calvin/development/jdk
export
JRE_HOME=/home/calvin/development/jdk/jre
export
CLASSPATH=$JAVA_HOME/lib:$JRE_HOME/lib:$CLASSPATH
export
PATH=$JAVA_HOME/bin:$JRE_HOME/bin:$PATH
登出再登入生效。
2.解压CruiseControl
解压到CruiseControl-2.8.3-bin.zip
到/home/calvin/development/cruisecontrol/cruisecontrol-bin-2.8.3中,其中三个值得注意的目录是:
目录
内容
projects
存放CruiseControl从源代码仓库中检出的代码。
logs
存放构建报告和日志。
artifacts
存放构建成功后产生的输出文件(如jar包,apk包等)。
3.从SVN仓库中checkout出源码
CruiseControl第一次不支持自动检出代码,所以在构建项目之前要先把项目代码手工checkout到本地。本文假设项目名为sampleproject,SVN源代码仓库位于/home/calvin/development/cruisecontrol/DemoSystem/repositoryserver/svnrepository中。
calvin@calvin-desktop:~$
sudo apt-get install subversion
calvin@calvin-desktop:~/development/cruisecontrol/cruisecontrol-bin-2.8.3/projects$
mkdir sampleproject
calvin@calvin-desktop:~/development/cruisecontrol/cruisecontrol-bin-2.8.3/projects$
svn checkout
file:////home/calvin/development/cruisecontrol/DemoSystem/repositoryserver/svnrepository
sampleproject
二.配置config.xml
cruisecontrol根据config.xml中配置的项目信息执行构建。
<cruisecontrol>
<!--
这里的name应该和projects目录下的项目名一致
-->
<project
name="sampleproject">
<!--监听项目状态的变化
-->
<listeners>
<currentbuildstatuslistener
file="logs/${project.name}/status.txt"/>
</listeners>
<!--
build之前从svn服务器上更新本地代码
-->
<bootstrappers>
<svnbootstrapper
localWorkingCopy="projects/${project.name}/trunk" />
</bootstrappers>
<modificationset
quietperiod="30">
<svn
localWorkingCopy="projects/${project.name}/trunk" />
</modificationset>
<!--
设定每隔interval秒,CruiseControl去检查并执行一次构建
-->
<schedule
interval="60">
<ant
anthome="apache-ant-1.7.0"
buildfile="projects/${project.name}/trunk/build.xml"
target="all"/>
</schedule>
<!--
发布构建结果
-->
<publishers>
<onsuccess>
<!--
将构建的结果(如jar包,apk包等)发布到指定的位置
-->
<artifactspublisher
dir="projects/${project.name}/trunk/dist"
dest="../logs/SampleCCProject"
/>
</onsuccess>
<!--htmlemail
buildresultsurl="http://211.94.155.199:8080/cruisecontrol/buildresults/mobiletv
mailhost="localhost" returnname="CruiseControl
result" returnaddress="localhost@localhost"-->
<!--failure
address="caojie@cienet.com.cn" />
<success
address="${mail.address.mobiletv" />
</htmlemail
<htmlemail>
<success
address="${mail.address.mobiletv}"/>
<failure
address="caojie@cienet.com.cn"/>
</htmlemail>-->
<email
mailhost="smtp.263xmail.com"
returnaddress="calvinlee@cienet.com.cn"
skipusers="true"
reportsuccess="fixes"
subjectprefix="[CruiseControl]"
buildresultsurl="http://buildserver:8080/cruisecontrol/buildresults">
<failure
address="calvinlee@cienet.com.cn" />
<success
address="calvinlee@cienet.com.cn" />
</email>
</publishers>
</project>
</cruisecontrol>
三.配置cruisecontrol.sh
cruisecontrol.sh是cruisecontrol的启动脚本,通过这个脚本中初始化一些环境变量,开始执行build
loop,并开启jetty服务器。
打开cruisecontrol.sh,在文件末尾找到
$JAVA_HOME/bin/java
$CC_OPTS
-Djavax.management.builder.initial=mx4j.server.MX4JMBeanServerBuilder
"-Dcc.library.dir=$LIBDIR" "-Djetty.logs=$JETTY_LOGS"
-jar "$LAUNCHER" $@ -jmxport 8000 -webport 8080 -rmiport
1099 &
去掉
&
符号,这样启动cruisecontrol时,阻止将其放到后台执行,要关闭cruisecontrol时,按下
Ctrl+C
即可。
修改-jmxport、-webport、-rmiport等参数可以自定义项目构建结果的发布端口。
PS:
如果项目的log文件比较大,或者构建时使用内存较多,可以在cruisecontrol.sh中增加JAVA命令行参数,扩大JVM的内存,以免出现OutOfMemory错误:
CC_OPTS="-Xms128m
-Xmx256m"
四.配置dashboard-config.xml
dashboard用来显示cruisecontrol管理的所有项目的构建状态信息。
dashboard-config.xml用来配置dashboard的显示,其中,配置<features
allowforcebuild="true"/>,那么在每个项目的右侧有一个按钮,单击该按钮将强迫该项目进行构建,而不必等到其下一次检查,也不必等到它有版本变化。
<dashboard>
<buildloop
logsdir=""
artifactsdir=""
/>
<features
allowforcebuild="true"/>
<trackingtool
projectname="" baseurl="" keywords=""/>
<subtabs>
<subtab
class="net.sourceforge.cruisecontrol.dashboard.widgets.ErrorsAndWarningsMessagesWidget"
/>
</subtabs>
</dashboard>
五.运行cruisecontrol
1.给cruisecontrol.sh
添加执行权限
calvin@calvin-desktop:~/development/cruisecontrol/cruisecontrol-bin-2.8.3$
sudo chmod +x cruisecontrol.sh
2.运行
cruisecontrol.sh
脚本
calvin@calvin-desktop:~/development/cruisecontrol/cruisecontrol-bin-2.8.3$
./cruisecontrol.sh
六.查看项目构建结果
1.通过http://localhost:8080/dashboard/
访问项目构建结果。
其中,项目有三种状态:
Discontinued:表示CruiseControl可以找到该项目的日志文件,但在config.xml中并没有配置该项目,这种情况下CruiseControl不会去构建它。
Inactive:表示在config.xml中配置了该项目,但是没有发现关于这个项目的Log信息,即在CruiseControl的日志目录中还没有该项目的日志文件,或日志文件被人为删除了。CruiseControl会根据配置信息对这个项目进行检查新版本并进行构建。
Active:表示CruiseControl即可以找到该项目的日志文件,又在config.xml中可以发现它。此时,这个项目可能是构建成功,也可能是构建失败,还可能是构建中。
2.通过http://localhost:8080/cruisecontrol/
查看项目构建计划