持续集成实践之二 VSS+MsBuild2.0+CC.net

根据实践的需要，为实现VSS+MsBuild2.0+CCnet这种组合的搭配，持续集成服务器（CI服务器）首先需要安装MicrosoftVisual SourceSafe ，Freamwork2.0，IIS；三者缺一不可。

装好以上这些之后，就双击ccnet的安装程序，安装即可。在windows2003上面安装过程正常。安装的时候不要去更改它的默认地址，更改了之后，发现启动不了。安装在默认地址下，启动就正常。我在在windows 2008服务器上安装时提示：ASP设置不了，请安装完成后再去设置，但是后来发现不设置也没有问题。

装好之后，在程序中可以找到，如下图：



使用ccnet工作的前提条件是需要将ccnet.config文件配置正确。CCValidator这个小程序就是用来验证ccnet.config中配置的内容是否有他认识不了的地方。应该是做一个语法的检查。

在CI服务器这个地址C:\ProgramFiles\CruiseControl.NET\server\ccnet.config。

找到ccnetconfig文件，打开你会看到这样一行字<!-- This is yourCruiseControl.NET Server Configuration file. Add your projects below! --> ，就从这里开始吧。

<?xml version="1.0" encoding="utf-8"?>
<cruisecontrol xmlns:cb="urn:ccnet.config.builder">
<!-- This is your CruiseControl.NET Server Configuration file. Add your projects below! -->
<!—持续集成的一个特定项目，一个project之间都是对此项目的设置，一个ccnet.config文件可以配置多个项目-->
<project name="项目1" >
<!—项目1集成的工作目录-->
<workingDirectory>D:\ccnet</workingDirectory>
<!—项目1集成的中间临时文件的存储目录-->
<artifactDirectory>D:\ccnet</artifactDirectory>
<!—给每一次的集成的结果按照时间+流水取名，便于查看-->
<labeller type="dateLabeller" />

<!—1.源码库的配置-->
<!—2.触发器trigger的配置-->
<!—3.MsBuild2.0的配置-->
<!—4.publisher的配置-->
<!—5.其它-->
</project>
</cruisecontrol>

以上是我所使用的ccnet.config文件的块的组成；以下按照编号对各块进行说明。
1.源码库的配置

<!--源码控制类型，此处必填vss-->
<sourcecontrol type="vss">
<!--如果操作系统（中文）与sourcesafe安装的语言（英文）不一样的话就会出现检测不出来源码的变更的情况，加上此设置可以避免此类问题-->
<culture>en-US</culture>
<autoGetSource>true</autoGetSource>
<!--源码库中的项目的地址--> <project>$/*****/*****/版本控制库/代码/项目1</project>
<alwaysGetLatest>true</alwaysGetLatest>
<!--vss用户名-->
<username>user1</username>
<!--vss密码-->
<password>password1</password>
<!--vss服务器所在的路径-->
<ssdir>\\192.168.1.2\vss\项目1</ssdir>
<!--工作目录，可以使用相对目录，以上面的workingDirectory为准-->
<workingDirectory>D:\ECMS</workingDirectory>
</sourcecontrol>

2.触发器trigger的配置

<triggers>
<!--定时任务，可以设置在哪天的那个时间执行构建计划-->

<scheduleTrigger time="21:00" buildCondition="ForceBuild">

<!--以下配置节有指定，则会在指定的时间日期内执行，没有则每天执行，这里没有指定-->

<!--<weekDays>Monday, Tuesday</weekDays>-->

</scheduleTrigger>

<!--每天21:30-23:59以及00:00-08:20不执行-->
<filterTrigger startTime="21:30" endTime="08:20">
<!--每隔多少时间执行一次-->
<!--intervalTrigger触发器的名字叫做 continuous， 每30秒钟去检查一下源代码控制器上面是否有变更，如果有变更就触发一次持续集成，从检查到变更的时间开始静默60秒钟，然后才去源代码服务器上面去拉代码-->
<trigger type = "intervalTrigger" name="continuous" seconds="30" buildCondition="IfModificationExists" initialSeconds="60" /> </filterTrigger> </triggers>

3.MsBuild2.0的配置

<tasks>

<msbuild>

<!--msbuild的路径，一般在系统目录下-->

<executable>C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\MSBuild.exe</executable>

<workingDirectory>D:\项目1\workingDirectory</workingDirectory>

<!--MSBuild会找到文件，并对它进行编译；一般使用解决方案文件，但是这个项目有点特别，所以使用了项目文件-->

<projectFile>D:\项目1\UI\cctest\cctest.csproj</projectFile>

<!--编译参数-->
<!--<buildArgs>/p:Configuration=Release /v:diag</buildArgs>-->

<!--<buildArgs></buildArgs>-->

<!--编译的目录类型-->

<!--<targets></targets>-->

<!--过期时间-->
<!--项目太大的时候，这个过期时间一定要设到足够长，否则编译不完，ccnet就把它杀死了，导致编译不能成功-->
<timeout>1800</timeout>

<!--记录编译的详细日志，需要单独下载这个程序集，放在工作目录(workingDirectory)下，我一直没搞清楚要放在哪个工作目录，总之每个都放一个好了，放好了之后，就能记录编译的详细日志了-->

<logger>C:\Program Files\CruiseControl.NET\server\ThoughtWorks.CruiseControl.MsBuild.dll</logger>

</msbuild>

</tasks>

4.publisher的配置

publisher块一定不能放到<tasks></tasks>块中去，一定要放在<tasks></tasks>的外面才可以正确的发送邮件出来。只要将发送服务器地址，smpt的地址，收件人的地址设置正确就可以了

<publishers>
<xmllogger logDir="D:\ccnet\buildlogs" />
<email mailport="25" includeDetails="TRUE" mailhostUsername="ci_ccnet@****.com" mailhostPassword="password" useSSL="FALSE">
<from>ci_ccnet@****.com</from>
<mailhost>smtp.****.com</mailhost>
<users>
<user name="danqueen" group="buildmaster" address="danqueen@****.com" />
<user name="developer" group="developers" address="developer@****.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="{1}quot; replace="@TheCompany.com" />
</converters>-->
<modifierNotificationTypes>
<NotificationType>Failed</NotificationType>
<NotificationType>Fixed</NotificationType>
</modifierNotificationTypes>
<subjectSettings>
<subject buildResult="StillBroken" value="Build is still broken for ${CCNetProject},the fix failed." />
<subject buildResult="Broken" value="${CCNetProject} broke at ${CCNetBuildDate} ${CCNetBuildTime} , last checkin(s) by ${CCNetFailureUsers}" />
<subject buildResult="Exception" value="Serious problem for ${CCNetProject}, it is now in Exception! Check status of network / sourcecontrol" />
<subject buildResult="Fixed" value="${CCNetProject} is fixed now! last checkin(s) by ${CCNetFailureUsers}. Well done!" />
</subjectSettings>
<xslFiles>
<file>xsl\header.xsl</file>
<file>xsl\compile.xsl</file>
<file>xsl\unittests.xsl</file>
<file>xsl\modifications.xsl</file>

<!--下面这行默认没有加进去，需要手动将其写进来，目的是将编译结果添加在要发送的邮件中-->
<xslFile>xsl\compile-msbuild.xsl</xslFile>
</xslFiles>
<!--
<attachments>
<file>C:\Data\AFile.txt</file>
<file>Relative.txt</file>
</attachments>
-->
</email>
</publishers>

5.其它
添加外部链接，可以将jemeter等工作用需要用到的外部的链接，也加载到ccnet的窗口中来

<externalLinks>
<externalLink name="Future" url="http://*******/login.jsp" />
</externalLinks>

其它还有很多，可以参见官网的说明文档，此处仅抛砖引玉。

需要说明的是，ccnet可以从程序打开，也可以通过服务运行。调试时建议从程序打开。调试好了就用服务去运行更好。通过服务运行时，需要等给它windows的登录方式进行运行才可以正常从服务运行。如下图：



打开后，如果没有其它特别的问题，ccnet就可以开始持续的集成了。

ccnet在工作中的截图如下：