CruiseControl.NET学习总结
前些日子，总结了一个NAnt的学习总结。后来就放下了，松散了一阵子。CruiseControl.NET(以下称CC.NET)，是我在学习完NAnt以后才开始看的，当时学起来就是在网上疯狂的找资料。现在就做一个关于CC.NET的总结吧。
CC.NET是一个开源软件，用它来做日构建实在是在好不过了。而且很方便，只需要配置一个配置文件就可以了。
1， 下载：
CruiseControl.NET-1.4.1-Setup.exe（服务器端）
CruiseControl.NET-CCTray-1.4.1-Setup.exe（客户端）
http://sourceforge.net/project/showfiles.php?group_id=71179&package_id=83198
2， 安装：
首先，确保你的电脑上已经安装了IIS（因为CC.NET会在IIS里面建立一个虚拟目录作为Web服务）。
其次，是安装.Net framework 2.0(后面会用到，例如MSBuild)
OK，现在可以安装CruiseControl.NET-1.4.1-Setup.exe（服务器端）了，基本上一路回车就好了。
然后，接着安装CruiseControl.NET-CCTray-1.4.1-Setup.exe（客户端）同上。
安装成功，不要高兴太早。你打开IIS看看你的默认的web站点下面有名为ccnet的虚拟目录吗？
如果有，右键浏览，如图所示：
OK，你安装成功了。如果没有，则表示没有安装成功。
下面我们来看看解决方法：
控制面板->Component Services,展开树形结构：Computers->my computer->COM+ Applications,有问题的话，会弹出出错信息。
com+出问题解决办法： msdtc –uninstall
msdtc –install
aspx文件无法解析问题：
1. 可能是安装顺序有问题，强烈建议按照建议的顺序安装
2. 2.检查IIS下虚拟目录ccnet的default页面，如果有冗余，只保留一个，其他的删除。
3. 3.可能是COM+组件的权限问题。展开上面提到的COM+组件属性结构，查看IIS OUT-of-process pooled Applications 的属性，查看他的identity标签页，勾选为 Ssystem Account
4. IIS的默认权限应设勾选集成WINDOWS验证模式
如果页面出现：failed to access the iis metabase
解决办法是运行aspnet_regiis.exe –i
（上述方法执行后建议重启所有相关服务）解决方案来自：http://blog.csdn.net/hexl84/archive/2008/03/19/2197227.aspx
在此基础上我先配置，然后卸载过之前安装的版本，在重新安装，OK，问题解决。
默认情况下打开CCTray，如图所示：
是什么也没有的。这时，我们可以通过File=》Setting=》Build Projects,弹出窗体：
然后，点击Add，弹出窗体：
在点击Add Server，弹出窗体：
默认是选择“Connection directly using .NET remoting”,点击OK，显示窗体：
这时，我们注意到，在左边的Build Server里面显示了我们的服务器，在右面的Available Projects确实空白。别着急，因为，我们还没有建立Project。
3， 配置：
我们所有的对CC.NET进行的控制，都是通过修改一个配置文件（位于安装目录下的Server里面：C:\Program Files\CruiseControl.NET\server\ccnet.config）进行的。
a) 建立一个Project
打开文件ccnet.config，进行编辑然后保存。
<cruisecontrol>
<project name="Demo">
</project>
</cruisecontrol>
只是，我们通过CCTray进行添加，就会出现
点击OK，这是CCTray显示如图：
这时，我们可以去强制编译，点击“Force Build”，这时，CCTray会有变化，但是，我们的操作是没有意义的。因为，我们还什么都没有做。
到现在为止，我们就添加了一个Project，以下我们的操作都是在这个Project基础上进行的。
b) 获取服务器上的源代码
配置文件中的内容：
<cruisecontrol>
<project name="Demo">
<webURL>http://127.0.0.1/ccnet</webURL>
<artifactDirectory>F:\Test\CITest\Code\Log</artifactDirectory>
<workingDirectory>F:\Test\CITest\Code</workingDirectory>
<sourcecontrol type="vss" autoGetSource="true">
<ssdir>D:\SourceSafe6.0d\TEST1\</ssdir>
<executable>D:\SourceSafe6.0d\VSS\win32\SS.EXE</executable>
<project>$/</project>
<username>cf</username>
<password>****</password>
</sourcecontrol>
</project>
</cruisecontrol>
说明：
webURL:通过web方式访问ccnet项目的地址<webURL>，ccnet提供的dashboard，下文中的dashboard就指用浏览器访问ccnet），远程就把localhost换成装了ccnet的主机地址，目前可以用http://10.0.3.146/ccnet访问这两个测试项目
workingDirectory：是下载的源码将会被保存的目录，如果没有设置，则会自动被保存在安装目录下server子目录下以project name为名称的目录下。当Project和sourcecontrol都含有workingDirectory时，以Project下面的为主。
artifactDirectory：对这个项目的监控过程的日志记录目录。（具体不知是做什么）
type: 使用的源码控制器类型,有人算了说支持18种的源码控制器，真的很强.此例为VSS
autoGetSource：为True时，CC.Net会通过监视VSS中代码的版本变化，自动从版本管理器中获取源代码
ssdir：
个人认为：是vss代码库的共享路径，服务器所在的路径，srcsafe.ini所在的文件夹，此例为本机，一般都是\\192.168.1.100\vss\形式，为网络路径
网络：在ccnet服务器上的一个路径，可以是相对于该ccnet项目的主目录的路径，在需要执行持续集成的时候，用于存放ccnet从版本库中取出的版本，进行编译并执行持续集成
project：是要使用的解决方案在vss中的路径
username：访问vss的用户名
password：访问vss的密码
配置完成后，我们要重新启动服务。方法：打开”运行”，输入“Services.msc”，回车即可。
启动这个服务“CruiseControl.NET Server”。
有时候在启动这个服务的时候会出现一些奇怪的问题，我现在就我遇到的问题给大家总结一下。
1， 就是用户的登陆问题：
我们可以通过右键点击这个服务，然后选择属性弹出窗体如下：
看Log On这个Tab，有两种登陆方式，一个是Local System account和This account。当我没有联机的情况下，我选择默认的方式就可以，也就是Local System account。但是当我在公司，以域的方式登陆的情况下，就必须选择This account，然后，选择我的域账号，登陆才可以。具体原因不清楚，大家遇到问题可以试一下。（了解的人，希望帮忙解释一下）。
2， 当CC.NET中的一些语法错误时，同样会产生错误。
如图：
这时，我们就需要通过事件查看器来看看发生了什么错误。
打开控制面板=>管理工具=>事件查看器。然后选择左面事件查看器下面的Application，在右面的详细列表里面，可以看的一个“Error”，双击，可以查看错误描述。
如图：
从上图，很容易的就看出，我们的配置文件的第2行有问题（我特意将Project写成了Project1）。一般的问题都可以从这里看到并解决。
如果启动服务没有问题，我们打开CCTray，点击强制Build，过一会就会出现下图所示，说明已经编译成功。
c) 编译解决方案
同样，我们获取了代码，接下来的任务就是编译解决方案。在CC.NET里面，我们还是通过MSBuild来编译我们的解决方案的。脚本如下：
<tasks>
<msbuild>
<executable>C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\MSBuild.exe</executable>
<workingDirectory>F:\Test\CITest\Code\TestProject</workingDirectory>
<projectFile>test.sln</projectFile>
<buildArgs>/noconsolelogger /p:Configuration=Debug /v:diag</buildArgs>
<targets>Build;Test</targets>
<timeout>900</timeout>
<logger>F:\Test\CITest\ThoughtWorks.CruiseControl.MSBuild.dll</logger>
</msbuild>
</tasks>
说明：
executable:msbuild所在的路径，一般为系统目录下的Microsoft.NET\Framework\v2.0.50727此例是.net framework 2.0，可能有更高的版本，是你的实际情况而定。
workingDirectory：我们要编译的解决方案所在的路径
projectFile:我们要编译的解决方案名
buildArgs：编译参数(有待了解)
targets:编译的目录类型(有待了解)
timeout：过期时间
logger: 记录编译的详细日志，需要单独下载这个程序集，放在工作目录(workingDirectory)下，下载路径 http://ccnetlive.thoughtworks.com/MSBuildXmlLogger-Builds实验：我们可以先将解决方案中bin\debug中生成的dll删除，然后强制build，就会重新生成一个dll。
这里我们可以在写一个<msbuild/>去编译另一个解决方案，也可以将所有要编译的解决方案放入一个文件夹下面。然后修改projectFile节点如下：<projectFile>Solution"*.sln</projectFile>这样的形式（我没有试过，网上有这样的示例，大家可以试试）。
d) 进行单元测试
编译成功后，当然是进行单元测试了。
脚本如下：
<nunit>
<path>F:\Test\CITest\NUnit-2.4.8-net-2.0\bin\nunit-console.exe</path>
<outputfile>F:\Test\CITest\nunit-results.xml</outputfile>
<assemblies>
<assembly>F:\Test\CITest\Code\TestProject\bin\Debug\test.dll</assembly>
</assemblies>
</nunit>
将脚本添加到tasks节点中，位于msbuild的下面。
说明：
path：nunit-console.exe的路径，位于NUnit文件夹下的bin目录中。
Outputfile：单元测试输出的结果文件（文件名可以修改）
Assembly:要进行单元测试的dll或者exe文件的路径。
脚本编写完后，重启服务，然后强制build，当成功后，会在F:\Test\CITest目录下产生一个名 “nunit-results.xml”的文件。同时，我们双击CCTray右面的Project,就会打开webdashboard，通过它我们就可以浏览刚刚的编译成果。如图：
双击后，弹出窗体：
点击我们的project也就是”Demo”，
然后点击here，
这就是，我们刚刚进行过单元测试的结果。请看框选的部分。如果没有进行单元测试，结果是这样的,如图： 
同时，我们可以点击左面的NUnit Details查看结果，如图：
这样结果就很显然了。
e) NAnt
现在我们已经在tasks节点下配置项目编译工具如msbuild，nunit，我们还可以用nant
脚本如下：
<nant>
<executable>F:\Test\CITest\nant-0.85\bin\nant.exe</executable>
<baseDirectory>F:\Test\CITest</baseDirectory>
<buildArgs></buildArgs>
<nologo>false</nologo>
<buildFile>default.build</buildFile>
<logger></logger>
<targetList>
<target>run</target>
</targetList>
<buildTimeoutSeconds>1200</buildTimeoutSeconds>
</nant>
说明：
Executable：同上
baseDirectory：default.build文件所在的路径
buildArgs：参数（有待了解）
nolog：（有待了解）
buildFile：.build文件
logger：（有待了解）
targe：运行的targetList名称
buildTimeoutSeconds：（有待了解）
这样，我们就成功的用CC.NET调用了NAnt。我们可以在NAnt去做另外的操作。有关NAnt的使用请参阅“NAnt学习总结“。
f) Tasks节点中的exec
使用方法：
<exec>
<executable>C:\Program Files\NCover\NCover.Console.exe</executable>
<baseDirectory>F:\Test\CITest</baseDirectory>
<buildArgs>F:\Test\CITest\NUnit-2.4.8-net-2.0\bin\nunit-console.exe /noshadow F:\Test\CITest\Code\TestProject\bin\Debug\test.dll</buildArgs>
</exec>
说明：
本例就是通过外部的NCover.Console.exe去调用了NUnit-console.exe，然后对test.dll，进行了代码覆盖率的检查。
g) 配置触发器
前面我们都是通过强制build对项目进行的build，现在我们介绍一下触发器。
触发器必须配置在<triggers>中，并且它可以嵌套。
1， Filtertrigger
可以屏蔽其它触发器，使其它触发器不执行。
<filtertrigger startTime=”7:30” endTime=”12:00”表示在每天的上午7:30到12:00都不执行持续集成。
注：嵌套在触发器里面的触发器，格式一定要是这样：<trigger type=”intervaltrigger”/>
例如：
<filterTrigger startTime="23:30" endTime="23:45">
<trigger type="intervalTrigger" seconds="60" />
<weekDays>
<weekDay>Sunday</weekDay>
</weekDays>
</filterTrigger>
说明：
weekDays：可以显式指定在一周的哪些天该触发器有效，默认是一周七天
2， Intervaltrigger
间隔触发器,可以设定两次持续集成之间的间隔，进行定期执行。
<intervaltrigger name=”continuous” seconds=”30” buildCondition=”ForeBuild”/>
说明：
Seconds：两次执行之间的间隔，默认为60秒
buildCondition：可以指定什么条件下该触发器才有效
值为：
IfModificationExists:指当CC.NET请求版本库中有修改的时候才执行。
ForceBuild：无条件执行(默认)
noBuild：不执行.
3， Scheduletrigger
定期触发器，可以设置一天中的一个时间定期的去执行持续集成
<scheduleTrigger time="23:30" buildCondition="ForceBuild" name="Scheduled">
<weekDays>
<weekDay>Monday</weekDay>
</weekDays>
</scheduleTrigger>
说明：
在每周一的23：30分进行无条件的持续集成。
4， Multipletrigger
并列定义多个触发器，用逻辑关系去设定它们。
<multiTrigger operator="And">
<triggers>
<intervalTrigger />
<filteredTrigger startTime="23:30" endTime="23:45" />
</triggers>
</multiTrigger>
说明：
Operator：逻辑关系And 或者 or
有兴趣的朋友可以分别试试这些。
h) Labeler 节点
使用什么样的方式标识每一个自动生成的版本，可以有多种不同的方式。Labeller Blocks
默认不去设置的话，标识为
如果设置成<labeller type="dateLabeller"/>标识如图所示：
如果设置成<labeller type="defaultlabeller">
<prefix>Foo-1-</prefix>
<incrementOnFailure>true</incrementOnFailure>
<labelFormat>00000</labelFormat>
</labeller>
标识如图所示：
i) 邮件通知功能
<email from="buildmaster@mycompany.com" mailhost="smtp.mycompany.com" mailport="25" includeDetails="TRUE"
mailhostUsername="smtpuser" mailhostPassword="smtppassword" useSSL="FALSE">
<users>
<user name="BuildGuru" group="buildmaster" address="buildguru@mycompany.com"/>
<user name="JoeDeveloper" group="developers" address="joedeveloper@thoughtworks.com"/>
</users>
<groups>
<group name="developers" notification="change"/>
<group name="buildmaster" notification="always"/>
</groups>
<converters>
<regexConverter find="$" replace="@TheCompany.com" />
</converters>
<modifierNotificationTypes>
<NotificationType>Failed</NotificationType>
<NotificationType>Fixed</NotificationType>
</modifierNotificationTypes>
</email>
说明：
from:来自哪里
mailhost:CC.NET将要连接的SMTP服务器进行发送邮件
mailport: SMTP服务器的端口
includeDetails：是否发送一个完整的信息，true发送完整的信息。False，仅发送一个简单的状态信息
mailhostUsername：提供SMTP服务器的用户名，此例为buildmaster@mycompany.com这个邮件地址的用户名。
mailhostPassword：提供SMTP服务器的密码.
useSSL:是否用SSL发送邮件
users：定义一系列的user元素，用来发送邮件给他们
user：
name：user的名字，应该与源码控制中的名字匹配（不是很理解）
group：user所在的group。
address：接收邮件的地址
groups：定义一系列的group，根据不同的通知策略进行通知
group：
name：group的名字，与user中的group相对应
notification：但某种情况下发送邮件
type：
Always：只要有build发生就发送
Change：当build的状态发成改变时发送（从“成功”到“失败”）
Failed：当build失败时发送
Success：当build成功是发送
Fixed: 当build的状态发成改变时发送（从“失败”到“成功”）
converters: 一套包含的内容规则创造的电子邮件地址基础上修饰的名称。
转换时将使用的名称修饰是没有设置的用户一节。(不是很了解)
modifierNotificationTypes：同group中的notification一样，但是用法不知道是做什么用的?有知道的朋友告诉我一下。
更多的信息，请参照CC.NET自带的帮助文档。
资料不全，随时补充！
出处：http://www.cnblogs.com/icebutterfly/
版权：本文版权归作者和博客园共有
转载：欢迎转载，为了保存作者的创作热情，请按要求【转载】，谢谢
要求：未经作者同意，必须保留此段声明；必须在文章中给出原文连接；否则必究法律责任
