在.NET环境中实现每日构建(Daily Build)--ccnet,MSBuild篇

每日构建，对我们团队来说一个全新的概念。随着项目开发的进展，在开发过程需要及时反馈一些BUG和功能要求的处理情况。而在这种情况下每天或隔一段时间Build一个版本，工作量还是比较大的，所以就特别有必要引入每日构建。关于每日构建，在园里有已经有很多的文章了，特别是摩诘的《在.NET环境中实现每日构建(Daily Build)--NAnt篇》更是从概念上和实践上手把手地介绍如果在.NET环境下实现每日构建。但很遗憾，在我实现每日构建之前没有看到这篇文章，错失了一次快速入门的机会，不过感到庆幸的是，经过一天的研究和学习，把自己在学习配置过程中遇到的一些问题总结一下，算是对每日构建实现方法的一个补充吧。

我是在Windows 2003中做每日构建的，使用CruiseControl.Net自动从VSS服务器中检测并下载最新的源代码，然后用MsBuild对解决方案自动编译。利用CCTray可以对每日构建的情况进行监控，了解CruiseControl.Net的工作情况。

下载安装完ccnet后，最重要的工作就是配置ccnet.config了。在安装目录下的server子目录里可以找到这个文件。虽然有帮助文件的支持，并且在Examples目录下有一个示例的配置文件，但是要想正确地配置这个文件也不是很容易的。在Ccnet.config里可以创建多个要监控项目的配置信息配置信息。包括：每个版本的标识方式，使用的源码库类型和登录信息，项目状态管理，每次构建要执行的任务，执行周期。以下是我的一个配置文件：

<cruisecontrol>   

     <project name="ccnetProject" webURL="Http://192.168.1.1/ccnet" publishExceptions="true">

         <!--工作目录，下载的源码将会被保存在这个目录下，如没有设置则会自被保存在安装目录下server子目录以project name为名称的目录下-->

         <workingDirectory>e:/ccnet</workingDirectory>

         <!--对这个项目的监控过程的日志记录目录-->

         <artifactDirectory>e:/ccnet</artifactDirectory>

         <!--使用什么样的方式标识每一个自动生成的版本，可以有多种不同的方式。Labeller Blocks -->

         <labeller type="dateLabeller" />

         <!--使用的源码控制器类型，我算了一下，它支持18种的源码控制器，强吧？这里使用的是VSS-->

         <sourcecontrol type="vss" autoGetSource="true">

              <!--源码库中的项目名称-->

              <project>$/ </project>

              <!--vss用户名-->

              <username>ccnet</username>

              <!--vss密码-->

              <password>dailybuild</password>

              <!--vss服务器所在的路径-->

              <ssdir>//192.168.*.*/Vss Server</ssdir>

              <!--工作目录，可以使用相对目录，以上面的workingDirectory为准-->

              <workingDirectory>e:/ccnet</workingDirectory>

         </sourcecontrol>

 

         <!--执行周期-->

         <triggers>

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

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

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

                   <!--<weekDays>

                       <weekDay>Monday</weekDay>

                   </weekDays>-->

              </scheduleTrigger>

              <!--每隔多少时间执行一次-->

              <!--<intervalTrigger seconds="30" buildCondition="ForceBuild"/>-->

         </triggers>

 

         <!--每次下载完代码后要执行的任务,可以有

         * Build Publisher

 

         * Email Publisher

 

         * Executable Task

 

         * File Merge Task

 

         * ForceBuildPublisher

 

         * Modification Writer Task

 

         * MsBuild Task

 

         * NAnt Task

 

         * Null Task

 

         * NUnit Task

 

         * Visual Studio Task

 

         * Xml Log Publisher

        -->

         <tasks>

              <!--msbuild 自动编译任务-->

              <msbuild>

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

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

                   <workingDirectory></workingDirectory>

                   <!--解决方案文件，相对project 的workingDirectory，MSBuild会找到这个文件，并对它进行编译-->

                   <projectFile>code/*.sln</projectFile>

                   <!--编译参数-->

                   <buildArgs></buildArgs>

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

                   <targets></targets>

                   <!--过期时间-->

                   <timeout>60</timeout>

                   <!--记录编译的详细日志，需要单独下载这个程序集，放在工作目录(workingDirectory)下，下载路径 http://ccnetlive.thoughtworks.com/MSBuildXmlLogger%2DBuilds/-->

                   <logger>ThoughtWorks.CruiseControl.MsBuild.XmlLogger,ThoughtWorks.CruiseControl.MsBuild.dll</logger>

              </msbuild>

         </tasks>

         <!--发布和部署配置-->

         <publishers>

              <!--下面的配置，会自将我源文件夹下的文件copy到指定的目录的版本标识(上面配置的labeller)的子目录下 如：e:/ccnet/publish/Shop/1/ e:/ccnet/publish/Shop/2/ 每一次生成都会递增-->

              <buildpublisher>

                   <sourceDir>e:/ccnet/code/Shop</sourceDir>

                   <publishDir>e:/ccnet/publish/Shop</publishDir>

              </buildpublisher>

              <buildpublisher>

                   <sourceDir>e:/ccnet/code/Manager</sourceDir>

                   <publishDir>e:/ccnet/publish/Manager</publishDir>

              </buildpublisher>

         </publishers>

     </project>

</cruisecontrol>

以上是对一个项目的进行监控的配置，当然也可以创建多个不同的项目。然后运行ccnet.exe每日构建就开始工作了，ccnet.exe.config文件是对当前的ccnet服务器工作环境的配置，不用进行修改就可以工作了，如果愿意可以配置监听端口号等等。

在webdashboard目录，通过WEB的方式对当前的ccnet的工作情况进行反馈。不知道是不是我配置的问题，我只看到了一条错误信息。但是通过CCTray可以更加方便的监视和管理构建过程。安装完CCTray后，打开Setting配置卡File>Settings

<!--[if !vml]-->
<!--[endif]-->

单击右边的Add按钮，添加一个要监视的服务器。在这里可以设置构建，成功，失败等各种声音。

<!--[if !vml]-->
<!--[endif]-->

在下边的文本框中输入要监视的服务器，如果是默认端口号则不用输入端口号，否则需要“:”隔开输入端口号。如果添加成功，则会在右边的Project列表框中出现在当前ccnet服务器中存在的项目。OK返回到主窗口。

<!--[if !vml]-->
<!--[endif]-->

在主窗体中有显示当前的服务器状态，最后一个编译时间，最后一次版本号，下一次生成时间等。点下面的Force Build按钮还可以强制马上进行生成。

最后说明一点，MsBuild会根据当前的项目文件或解决方案文件对项目自动进行编译，而不需要写任何的配置文件。而在asp.net 2.0中Web工程默认是一种新的Web Site模式，这样可能就会对编译造成Web工程产生一定的影响。所以推荐使用VS 2005的Web Application Project Web工程模型。

CruiseControl.Net官方地址：

http://confluence.public.thoughtworks.org/display/CCNET/Welcome+to+CruiseControl.NET

Web Application Web 请参阅：http://dflying.cnblogs.com/archive/2006/04/06/368203.html

关于MSBuild的更多介绍请查阅相关资料，或查看MSDN。