CruiseControl.Net持续集成平台搭建总结
最近公司准备启动一个新的项目，预计会投入20-30个开发人员，应该还算一个不小的项目，为了更加科学化的管理，在这个项目里面，打算采用一些XP和敏捷开发的理念，同时也会结合自身的实际情况。为此，我受命着手研究持续集成相关的工具，通过几天的努力，整个持续集成平台初步搭建起来，基本上能够实现自动获取最新代码、自动构建、自动测试以及自动发送报告。此篇文章作为最近几天的一个学习总结，某些地方不一定正确，请大家不吝赐教，将来也许随着应用的深入，我也会持续更新相关的内容。
一、什么是持续集成
- 什么是持续集成（Continuous Integration）
作为极限编程的十二个实践之一，可以让团队在持续的基础上收到反馈并进行改进，不必等到开发周期后期才寻找和修复缺陷。通俗一点说，就是指对于开发人员的每一次代码提交，都自动把代码库中所有代码Check Out到一个目录，并自动进行编译，和部署，并且自动运行所有的Test case，以及一些诸如代码检查、测试覆盖率等自动化任务，如果成功则接受这次提交，否则告诉所有人，这是一个失败的revision。 - 相关工具
CruiseControl、Anthill、Bamboo、TeamCity
CruiseControl作为业界最具知名度和口碑的集成工具而被广泛使用，而在.Net环境下也有CruiseControl.Net版本 ，本文以CruiseControl.Net作为持续集成平台，简称CC.Net。 - 示意图
二、为什么要持续集成
- 持续集成的价值
减小风险、减少手动过程、生成构建结果、安全感 - 持续集成的自动化
自动化运行测试、自动产生可部署的成品、自动将成品部署到近似环境、自动运行回归测试、自动生成度量报告
三、如何部署
首先确定安装CC.NET的服务器，一般位于局域网内，然后安装以下工具。当然CC.NET的能力也不限于此，应该是可以扩展很多其他的功能。
- CC.Net
1.6
由ThoughtWorks开发并开源，目前最新的版本是1.6，本次实验也是以此版本为基础，其他版本未经过验证。
下载地址：http://confluence.public.thoughtworks.org/display/CCNET/Download - 版本管理工具
本次选用SVN，同时CC.NET也支持VSS、TFS、CVS等。注意：如果CC.NET Server和SVN Server不在一台机器上，也需要在CC.NET Server上安装SVN的程序文件。 - 代码构建工具
MSBUILD，如果安装了.Net Framework，就会自带这个工具。 - 单元测试工具
NUnit 2.6，大名鼎鼎的XUnit家族成员，顺便提一下TestDriven.Net （plug-in for IDE） ，这个在CC.NET SERVER上不是必须，但作为IDE的插件，非常适合开发人员使用。 - 代码检查工具
FxCop，由微软开发，CC.NET不能直接支持FxCop，需要使用task下的exec来调用bat文件。 - 代码覆盖率分析工具
NCover 3.1，个人版本是免费的，其余已经商业化，可以使用task下的exec来调用bat文件，看官方文档好像也支持直接在config文件里面配置<ncoverProfile />，但未实验成功。
以上工具的安装无须多言，关键在于CC.NET的配置，是一个比较复杂的事情，而CruiseControl.Net的中文资料也不是很多（在这点上，JAVA的CruiseControl情况好很多），很多东西都是参考官方网站的英文文档，因本人水平有限，很多配置也许不是最佳实践。
下面就以我最终的一个配置文件为例，来说明具体的配置过程：
<cruisecontrol xmlns:cb="urn:ccnet.config.builder">
<project name="CruiseControlDemo" queue="Q1" queuePriority="1">
<triggers>
<!--自动运行build任务的间隔时间，单位：秒-->
<intervalTrigger seconds="30"/>
</triggers>
<workingDirectory>D:\QiuliangTest\DailyBuild</workingDirectory>
<artifactDirectory>D:\QiuliangTest\DailyBuild\log</artifactDirectory>
<!--Web Dashboard的URL-->
<webURL>http://172.16.82.176:8080/ViewFarmReport.aspx</webURL>
<modificationDelaySeconds>2</modificationDelaySeconds>
<maxSourceControlRetries>5</maxSourceControlRetries>
<initialState>Stopped</initialState>
<startupMode>UseInitialState</startupMode>
<!--版本控制的配置，以SVN为例，其他版本控制工具请参考官网-->
<sourcecontrol type="svn">
<trunkUrl>https://172.16.82.178:444/svn/Wanda-Phase2/CCDemo</trunkUrl>
<executable>C:\Program Files (x86)\VisualSVN Server\bin/svn.exe</executable>
<workingDirectory>D:\QiuliangTest\src</workingDirectory>
<username>qiuliang</username>
<password>qiuliang</password>
</sourcecontrol>
<tasks>
<!--自动构建工具配置，以MSBUILD为例，其他自动构建工具（例如NAnt）请参考官网-->
<msbuild>
<executable>C:\Windows\Microsoft.NET\Framework\v4.0.30319\MSBuild.exe</executable>
<workingDirectory>D:\QiuliangTest\src</workingDirectory>
<projectFile>CCDemo.sln</projectFile>
<buildArgs>/p:Configuration=Debug /v:diag</buildArgs>
<targets>Build</targets>
<timeout>900</timeout>
<logger>C:\Program Files (x86)\CruiseControl.NET\server\ThoughtWorks.CruiseControl.MsBuild.dll</logger>
</msbuild>
<!--单元测试配置-->
<nunit>
<path>C:\Program Files (x86)\NUnit 2.6\bin\nunit-console.exe</path>
<assemblies>
<assembly>D:\QiuliangTest\src\CC.Test\bin\Debug\CC.Test.dll</assembly>
</assemblies>
<excludedCategories>
<excludedCategory>LongRunning</excludedCategory>
</excludedCategories>
<outputfile>D:\QiuliangTest\DailyBuild\nunit\nunit-results.xml</outputfile>
</nunit>
<!--NCover配置，其中bat文件需要自己写-->
<exec executable="D:\QiuliangTest\ncover.bat" />
<!--FxCop配置，其中bat文件需要自己写-->
<exec executable="D:\QiuliangTest\fxcop.bat" />
<!--将相关的报告合并-->
<merge>
<files>
<file>D:\QiuliangTest\DailyBuild\fxcop\*.xml</file>
<file>D:\QiuliangTest\DailyBuild\ncover\output\coverage.xml</file>
<!-- Other files to merge for your build would also be included here -->
</files>
</merge>
</tasks>
<publishers>
<statistics />
<xmllogger />
<email mailport="25" includeDetails="TRUE" mailhostUsername="userName" mailhostPassword="password" useSSL="FALSE">
<from>yours@email.com</from>
<mailhost>smtp.email.com</mailhost>
<users>
<user name="qiuliang" group="buildmaster" address="yours@email.com" />
</users>
<groups>
<group name="developers">
<notifications>
<notificationType>Failed</notificationType>
<notificationType>Fixed</notificationType>
</notifications>
</group>
<group name="buildmaster">
<notifications>
<notificationType>Always</notificationType>
</notifications>
</group>
</groups>
<converters>
<regexConverter find="$" replace="@TheCompany.com" />
</converters>
<!--失败的邮件标题-->
<subjectSettings>
<subject buildResult="StillBroken" value="Build is still broken for {CCNetProject}" />
</subjectSettings>
</email>
</publishers>
</project>
</cruisecontrol>
fxcop的bat文件：
cd C:\Program Files (x86)\Microsoft FxCop 1.36
c:
FxCopCmd /project:D:\QiuliangTest\FxCop\default.FxCop /out:D:\QiuliangTest\DailyBuild\FxCop\DailyBuild.FxCop.xml /q /gac
ncover的bat文件：
cd C:\Program Files\NCover
ncover.console.exe "C:\Program Files (x86)\NUnit 2.6\bin\nunit-console.exe" /noshadow "D:\QiuliangTest\src\CC.Test\bin\Debug\CC.Test.dll" //at ncover\output\Trends.trend //p "CCDemo-NCover" //x ncover\output\coverage.xml
目前只是初步完成了CC.NET的搭建，使用的效果如何，还有很多其他需要考虑的因素，总的来说，我感觉CC.NET是一款不错的持续集成工具，如果在接下来的项目中能很好的利用起来，相信能为提高整体的管理水平和生产力带来一些帮助，如果有对这方面很熟悉的朋友，也希望能交流交流。
