CC.NET是一个开源软件,用它来做日构建实在是在好不过了。而且很方便,只需要配置一个配置文件就可以了。
CruiseControl.NET-1.4.1-Setup.exe(服务器端)
CruiseControl.NET-CCTray-1.4.1-Setup.exe(客户端)
首先,确保你的电脑上已经安装了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的虚拟目录吗?
如果有,右键浏览,如图所示:
下面我们来看看解决方法:
控制面板->Component Services,展开树形结构:Computers->my computer->COM+ Applications,有问题的话,会弹出出错信息。
msdtc –install
可能是安装顺序有问题,强烈建议按照建议的顺序安装
2.检查IIS下虚拟目录ccnet的default页面,如果有冗余,只保留一个,其他的删除。
3.可能是COM+组件的权限问题。展开上面提到的COM+组件属性结构,查看IIS OUT-of-process pooled Applications 的属性,查看他的identity标签页,勾选为 Ssystem Account
IIS的默认权限应设勾选集成WINDOWS验证模式
如果页面出现:failed to access the iis metabase
在此基础上我先配置,然后卸载过之前安装的版本,在重新安装,OK,问题解决。
是什么也没有的。这时,我们可以通过File=》Setting=》Build Projects,弹出窗体:
默认是选择“Connection directly using .NET remoting”,点击OK,显示窗体:
这时,我们注意到,在左边的Build Server里面显示了我们的服务器,在右面的Available Projects确实空白。别着急,因为,我们还没有建立Project。
我们所有的对CC.NET进行的控制,都是通过修改一个配置文件(位于安装目录下的Server里面:C:\Program Files\CruiseControl.NET\server\ccnet.config)进行的。
<cruisecontrol>
<project >
</project>
</cruisecontrol>
只是,我们通过CCTray进行添加,就会出现
点击OK,这是CCTray显示如图:
这时,我们可以去强制编译,点击“Force Build”,这时,CCTray会有变化,但是,我们的操作是没有意义的。因为,我们还什么都没有做。
到现在为止,我们就添加了一个Project,以下我们的操作都是在这个Project基础上进行的。
配置文件中的内容:
<cruisecontrol>
<project >
<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:对这个项目的监控过程的日志记录目录。(具体不知是做什么)
autoGetSource:为True时,CC.Net会通过监视VSS中代码的版本变化,自动从版本管理器中获取源代码
个人认为:服务器所在的路径,srcsafe.ini所在的文件夹,此例为本机,一般都是形式,为网络路径
网络:在ccnet服务器上的一个路径,可以是相对于该ccnet项目的主目录的路径,在需要执行持续集成的时候,用于存放ccnet从版本库中取出的版本,进行编译并执行持续集成
配置完成后,我们要重新启动服务。方法:打开”运行”,输入“Services.msc”,回车即可。
启动这个服务“CruiseControl.NET Server”。
有时候在启动这个服务的时候会出现一些奇怪的问题,我现在就我遇到的问题给大家总结一下。
我们可以通过右键点击这个服务,然后选择属性弹出窗体如下:
看Log On这个Tab,有两种登陆方式,一个是Local System account和This account。当我没有联机的情况下,我选择默认的方式就可以,也就是Local System account。但是当我在公司,以域的方式登陆的情况下,就必须选择This account,然后,选择我的域账号,登陆才可以。具体原因不清楚,大家遇到问题可以试一下。(了解的人,希望帮忙解释一下)。
当CC.NET中的一些语法错误时,同样会产生错误。
如图:
这时,我们就需要通过事件查看器来看看发生了什么错误。
打开控制面板=>管理工具=>事件查看器。然后选择左面事件查看器下面的Application,在右面的详细列表里面,可以看的一个“Error”,双击,可以查看错误描述。
如图:
从上图,很容易的就看出,我们的配置文件的第2行有问题(我特意将Project写成了Project1)。一般的问题都可以从这里看到并解决。
如果启动服务没有问题,我们打开CCTray,点击强制Build,过一会就会出现下图所示,说明已经编译成功。
同样,我们获取了代码,接下来的任务就是编译解决方案。在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:我们要编译的解决方案名
logger: 记录编译的详细日志,需要单独下载这个程序集,放在工作目录(workingDirectory)下,下载路径 http://ccnetlive.thoughtworks.com/MSBuildXmlLogger-Builds实验:我们可以先将解决方案中bin\debug中生成的dll删除,然后强制build,就会重新生成一个dll。
这里我们可以在写一个<msbuild/>去编译另一个解决方案,也可以将所有要编译的解决方案放入一个文件夹下面。然后修改projectFile节点如下:<projectFile>Solution"*.sln</projectFile>这样的形式(我没有试过,网上有这样的示例,大家可以试试)。
编译成功后,当然是进行单元测试了。
脚本如下:
<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,通过它我们就可以浏览刚刚的编译成果。如图:
双击后,弹出窗体:
然后点击here,
这就是,我们刚刚进行过单元测试的结果。请看框选的部分。如果没有进行单元测试,结果是这样的,如图:
这样结果就很显然了。
现在我们已经在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>
说明:
baseDirectory:default.build文件所在的路径
buildArgs
nolog
logger
targetargetList名称
buildTimeoutSeconds
这样,我们就成功的用CC.NET调用了NAnt。我们可以在NAnt去做另外的操作。有关NAnt的使用请参阅““。
使用方法:
<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,进行了代码覆盖率的检查。
前面我们都是通过强制build对项目进行的build,现在我们介绍一下触发器。
触发器必须配置在<triggers>中,并且它可以嵌套。
可以屏蔽其它触发器,使其它触发器不执行。
<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" />
<weekDay>Sunday</weekDay>
</filterTrigger>
说明:
weekDays:可以显式指定在一周的哪些天该触发器有效,默认是一周七天
<intervaltrigger seconds=”30” buildCondition=”ForeBuild”/>
说明:
Seconds:两次执行之间的间隔,默认为60秒
buildCondition:可以指定什么条件下该触发器才有效
IfModificationExists:指当CC.NET请求版本库中有修改的时候才执行。
定期触发器,可以设置一天中的一个时间定期的去执行持续集成
<scheduleTrigger time="23:30" buildCondition="ForceBuild" >
<weekDay>Monday</weekDay>
</scheduleTrigger>
说明:
并列定义多个触发器,用逻辑关系去设定它们。
<multiTrigger operator="And">
<intervalTrigger />
<filteredTrigger startTime="23:30" endTime="23:45" />
</multiTrigger>
说明:
有兴趣的朋友可以分别试试这些。
使用什么样的方式标识每一个自动生成的版本,可以有多种不同的方式。Labeller Blocks
如果设置成<labeller type="defaultlabeller">
<prefix>Foo-1-</prefix>
<incrementOnFailure>true</incrementOnFailure>
<labelFormat>00000</labelFormat>
</labeller>
mailhostUsername="smtpuser" mailhostPassword="smtppassword" useSSL="FALSE">
<group notification="change"/>
<group notification="always"/>
<modifierNotificationTypes>
<NotificationType>Failed</NotificationType>
<NotificationType>Fixed</NotificationType>
</modifierNotificationTypes>
</email>
说明:
mailhost:CC.NET将要连接的SMTP服务器进行发送邮件
mailport: SMTP服务器的端口
includeDetails:是否发送一个完整的信息,true发送完整的信息。False,仅发送一个简单的状态信息
mailhostUsername这个邮件地址的用户名。
mailhostPassword:提供SMTP服务器的密码.
useSSL:是否用SSL发送邮件
users:定义一系列的user元素,用来发送邮件给他们
user:
groups:定义一系列的group,根据不同的通知策略进行通知
group:
name:group的名字,与user中的group相对应
notification:但某种情况下发送邮件
type:
Always:只要有build发生就发送
Change:当build的状态发成改变时发送(从“成功”到“失败”)
Failed:当build失败时发送
Success:当build成功是发送
Fixed: 当build的状态发成改变时发送(从“失败”到“成功”)
converters: 一套包含的内容规则创造的电子邮件地址基础上修饰的名称。
转换时将使用的名称修饰是没有设置的用户一节。(不是很了解)
modifierNotificationTypes:同group中的notification一样,但是用法不知道是做什么用的?有知道的朋友告诉我一下。
资料不全,随时补充!
作者:冰碟
出处:http://www.cnblogs.com/icebutterfly/
版权:本文版权归作者和博客园共有
转载:欢迎转载,为了保存作者的创作热情,请按要求【转载】,谢谢
要求:未经作者同意,必须保留此段声明;必须在文章中给出原文连接;否则必究法律责任