【我的项目经验】——CruiseControl.NET

　　从今往后每周都写一篇日志，总结一下自己的经验吧。

　　PM让我搞团队的CruiseControl.NET。什么是CruiseControl.NET呢？简单的说就是团队代码每日构建。它可以自动编译、自动运行单元测试、自动部署、自动打包。1. 对开发来讲可以保证编译通过，不会因为一个组员的代码编译不通过而影响其他人第二天的工作。2. 对PM和Team Leader来说，可以控制代码的质量。代码质量？！恩，你没看错，利用StyleCop等代码规范分析器还有MS unit test 和NUnit，可以保证整个团队的代码规范和质量达到很高的水平！3. 对QA来说，每天都可以测试最新的版本，把测试的任务分配到每天，从而监控开发人员每天的质量。总之，CruiseControl.NET对团队是个很好的工具。

　　既然有帮助，那么我就来介绍一下如何配置吧。

　　首先呢，要下载相关的软件，版本控制软件是必不可少的哦。SVN，VSS都是很流行的版本控制工具。不过VSS要钱的，所以大多数Team都采用SVN。一般CruiseControl.NET都安装在团队的服务器上。这里我推荐一个很好用的SVN集成工具，VisualSVN Server。先安装这个。安装完毕之后，我们需要安装CruiseControl.NET了。从http://sourceforge.net/projects/ccnet/可以下载最新的版本。http://confluence.public.thoughtworks.org/display/CCNET/Welcome+to+CruiseControl.NET是它的官方网址，这里有很多最新的信息。安装CruiseControl.NET需要IIS。安装完毕之后，接下来就是要配置CruiseControl了。

　　我先讲一下文件目录结构：

　　这个是VisualSVN Server 和 CruiseControl.NET安装后的目录

　　进入CruiseControl.NET之后：

　　　　Server目录下是CruiseControl.NET的核心，里面存有配置文件等。Webdashborad目录主要是IIS网站，同时还包含Help文档。

　　CruiseControl.NET有2种监控方式：exe执行文件和Windows Service执行。分别对应ccnet.exe和CuriseControl.NET服务。

　　接下来就是本文的核心了，介绍一下CruiseControl.NET的配置文件。

　　CruiseControl.NET总有4个配置文件：Server目录下的ccnet.config、ccnet.exe.config、ccservice.exe.config和Webdashborad目录下的dashboard.config。

　　ccnet.config是配置项目，SVN路径，Email地址等等的核心配置文件。我们大多数时间是跟它打交道。

　　ccnet.exe.config是ccnet.exe可执行文件的配置文件，当我们选择手动运行ccnet.exe时候，它才起作用。

　　ccservice.exe.config是CruiseControl.NET Service的配置文件。它和ccnet.exe.config主要作用是控制发送Email模板的内容，比如要不要单元测试内容啊，要不要最近更新的内容啊等等。

　　dashboard.config是配置CruiseControl.NET网站的配置文件，主要是网站显示的内容，也是要不要单元测试啊等等。

　　写了这么多，我们来看例子吧，一看例子同学们就懂了。

　　ccnet.config配置文件如下：

 

ccnet.config
<cruisecontrol xmlns:cb="urn:ccnet.config.builder">
  <project name ="MyProject"><!--这个是工程名称-->
    <labeller type="dateLabeller" /><!--这个控制Labeller的类型，这里用日期，当然也可以用数字-->
    <workingDirectory>E:\Program Files\CruiseControl.NET\server\MyProject</workingDirectory><!--这个目录保存源代码-->
    <artifactDirectory>E:\Program Files\CruiseControl.NET\server\Artifacts\MyProject</artifactDirectory><!--这个目录保存每次编译的结果-->
    <triggers>
      <scheduleTrigger time="00:00" name="Scheduled"><!--我现在用时间触发器，每天00：00编译程序-->
        <weekDays><!--星期天休息，就不编译了，唉，每周六要加班啊！-->
          <weekDay>Monday</weekDay>
          <weekDay>Tuesday</weekDay>
          <weekDay>Wednesday</weekDay>
          <weekDay>Thursday</weekDay>
          <weekDay>Friday</weekDay>
          <weekDay>Saturday</weekDay>
        </weekDays>
      </scheduleTrigger>
    </triggers>
    <sourcecontrol type="svn"><!--一般都用SVN了，当然VSS也可以-->
      <trunkUrl>http://10.50.0.20:8001/svn/projects/MyProject/</trunkUrl><!--SVN Code Address-->
      <executable>E:/Program Files/VisualSVN Server/bin/svn.exe</executable><!--这个Visual SVN Server的程序，用它来Download code-->
      <username>username</username>
      <password>password</password>
    </sourcecontrol>
    <tasks>
      <msbuild>
        <executable>D:\WIN2003\Microsoft.NET\Framework\v3.5\MSBuild.exe</executable><!--这个MSBuild的路径-->
        <projectFile>MyProject.sln</projectFile><!--这个Solution Name-->
        <buildArgs>/t:Build /p:Configuration=Release</buildArgs>
      </msbuild>
      <!--<exec>
        <executable>E:\Program Files\CruiseControl.NET\server\MyProject\DelTestResults.bat</executable>
      </exec>
      <exec>
        <executable>E:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\mstest.exe</executable>
        <buildArgs>/resultsfile:.\TestResults\TestResult.trx /runconfig:LocalTestRun.testrunconfig /testmetadata:MyProject.vsmdi /testlist:TestList</buildArgs>
      </exec>-->
    </tasks>
    <publishers>
      <!--to get the test results in the dashboard we have to merge the results XML file 
      the project working directory is used as the base path here-->
      <merge>
        <files>
          <file>E:\Program Files\CruiseControl.NET\server\MyProject\TestResults\TestResult.trx</file><!--这个文件是用于合并UnitTest result-->
        </files>
      </merge>
      <!--this is the line I missed for ages, without it you get strange missing publisher log errors-->
      <xmllogger />
      <email from="lifeizhuhai@163.com" mailhost="pop3.163.com" mailport="25" includeDetails="TRUE"
          mailhostUsername="username" mailhostPassword="password" useSSL="FALSE">
        <users>
          <!--<user name="Prime Li" group="developers" address="lifeizhuhai@163.com"/>-->
          <user name="Group" group="developers" address="group@163.com"/>
        </users>
        <groups>
          <group name="developers" notification="Always"/>
          <group name="manager" notification="Success"/>
        </groups>
        <modifierNotificationTypes>
          <NotificationType>Failed</NotificationType>
          <NotificationType>Fixed</NotificationType>
        </modifierNotificationTypes>
      </email>
      <rss/>
      <modificationHistory />
    </publishers>
    <externalLinks>
      <externalLink name="AMO700" url="http://amo-server/AMO700/" />
    </externalLinks>
  </project>

 

　　主要的配置我都加注释了。如果要控制多个Project，可以并行加多个<Project .../>节点。

　　下面是ccservice.exe.config，ccnet.exe.config跟它类似的，我们一般修改它的Email模板的配置节，其他都是原封不动。　　

CCService.exe.config
<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <configSections>
        <section name="xslFiles" type="ThoughtWorks.CruiseControl.Core.Config.XslFilesSectionHandler,ThoughtWorks.CruiseControl.Core"/>
        <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
    </configSections>
    <!-- Specifies the stylesheets that are used to transform the build results when using the EmailPublisher -->
    <xslFiles><!--这个重要，是控制Email发送模板内容的，name后面是对应目录下的excel配置文件-->
        <file name="xsl\header.xsl"/>
        <file name="xsl\compile.xsl"/>
        <!--<file name="xsl\unittests.xsl"/>-->
        <file name="xsl\fit.xsl"/>
    <file name="xsl\compile-msbuild.xsl"/>
    <file name="xsl\MsTestReport2008.xsl"/>
        <file name="xsl\modifications.xsl"/>
        <!--<file name="xsl\fxcop-summary.xsl"/>-->
    </xslFiles>
    <!-- Defines the port and protocol that the ccnet server will use to service remote requests -->
    <system.runtime.remoting>
        <application>
            <channels>
                <channel ref="tcp" port="21234">
                    <serverProviders>
                        <formatter ref="binary" typeFilterLevel="Full"/>
                    </serverProviders>
                </channel>
            </channels>
        </application>
    </system.runtime.remoting>
    <log4net>
        <root>
            <!-- 
                Change the value in the next line to alter the amount of logging generated by CruiseControl.NET.
                The following values are supported: DEBUG, INFO, WARN, ERROR, OFF.
                For more detailed information on how to configure log4net, see http://logging.apache.org/log4net/
                 -->
            <level value="DEBUG"/>
            <appender-ref ref="Console"/>
            <appender-ref ref="RollingFileAppender"/>
        </root>
        <appender name="Console" type="log4net.Appender.ConsoleAppender">
            <layout type="log4net.Layout.PatternLayout">
                <conversionPattern value="[%thread:%level] %message%newline"/>
            </layout>
        </appender>
        <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
            <file value="ccnet.log"/>
            <appendToFile value="true"/>
            <rollingStyle value="Size"/>
            <maxSizeRollBackups value="10"/>
            <maximumFileSize value="10MB"/>
            <staticLogFileName value="true"/>
            <layout type="log4net.Layout.PatternLayout">
                <!-- Note: Core.Logging.ServerLogFileReader depends on having "[%thread" present in the pattern -->
                <conversionPattern value="%date [%thread:%level] %message%newline"/>
            </layout>
        </appender>
    </log4net>
    <appSettings>
        <!-- Without this appSetting ccservice will look for ccnet.config in its own directory. -->
        <!--    <add key="ccnet.config" value="c:\some\path\to\ccnet.config"/> -->
        <add key="service.name" value="CCService"/>
        <add key="remoting" value="on"/>
        <add key="ServerLogFilePath" value="ccnet.log"/>
        <!-- Used by the WebDashboard ServerLog plugin to locate the log file produced by the LogFileTraceListener (above) -->
        <add key="ServerLogFileLines" value="100"/>
        <!-- Used by the WebDashboard ServerLog plugin to determine how many lines from the log file should be read -->
        <add key="WatchConfigFile" value="true"/>
        <!-- Turns on or off the file watcher used to monitor the ccnet.config file -->
    </appSettings>
    <startup>
        <supportedRuntime version="v2.0.50727" />
    </startup>
</configuration>

 

　　最后是dashborad.config，用于配置IIS网站的内容的，这个是插件式网站，网站的内容是可以配出来的，也是我们以后开发的方向哦。多学学吧，插件式网站开发！

 

DashBoard.config
<?xml version="1.0" encoding="utf-8" ?>
<dashboard>
  <remoteServices>
    <servers>
      <!-- Update this list to include all the servers you want to connect to. NB - each server name must be unique -->
      <server name="local" url="tcp://localhost:21234/CruiseManager.rem" allowForceBuild="true" allowStartStopBuild="true" />
    </servers>
  </remoteServices>
  <plugins>
    <farmPlugins>
      <farmReportFarmPlugin />
      <cctrayDownloadPlugin />
    </farmPlugins>
    <serverPlugins>
      <serverReportServerPlugin />
      <serverLogServerPlugin />
      <serverInformationServerPlugin />
      <queueStatusServerPlugin />
      <projectConfigurationServerPlugin />
    </serverPlugins>
    <projectPlugins>
      <projectReportProjectPlugin />
      <latestBuildReportProjectPlugin />
      <viewAllBuildsProjectPlugin />
      <projectStatisticsPlugin xslFileName="xsl\StatisticsGraphs.xsl" />
      <serverLogProjectPlugin />
      <viewConfigurationProjectPlugin />
      <modificationHistoryProjectPlugin />
    </projectPlugins>
    <buildPlugins>
      <buildReportBuildPlugin>
        <xslFileNames><!--修改这里，是控制显示哪些详细的编译内容-->
          <xslFile>xsl\header.xsl</xslFile>
          <xslFile>xsl\compile.xsl</xslFile>
          <xslFile>xsl\compile-msbuild.xsl</xslFile>
          <!--<xslFile>xsl\unittests.xsl</xslFile>-->
          <xslFile>xsl\fxcop-summary.xsl</xslFile>
          <xslFile>xsl\NCoverSummary.xsl</xslFile>
          <xslFile>xsl\SimianSummary.xsl</xslFile>
          <xslFile>xsl\MsTestReport2008.xsl</xslFile>
          <xslFile>xsl\modifications.xsl</xslFile>
          <!--<xslFile>xsl\MsTestReport2008.xsl</xslFile>
                  <xslFile>xsl\MsTestReport.xsl</xslFile>-->
          <!--<xslFile>xsl\MsTestSummary.xsl</xslFile>-->
          <xslFile>xsl\fitnesse.xsl</xslFile>
        </xslFileNames>
      </buildReportBuildPlugin>
      <buildLogBuildPlugin />
      <xslReportBuildPlugin description="NUnit Details" actionName="NUnitDetailsBuildReport" xslFileName="xsl\tests.xsl" /><!--这里是CruiseControl.NET提供的插件-->
      <xslReportBuildPlugin description="NUnit Timings" actionName="NUnitTimingsBuildReport" xslFileName="xsl\timing.xsl" />
      <xslReportBuildPlugin description="NAnt Output" actionName="NAntOutputBuildReport" xslFileName="xsl\NAnt.xsl" />
      <xslReportBuildPlugin description="NAnt Timings" actionName="NAntTimingsBuildReport" xslFileName="xsl\NAntTiming.xsl" />
      <xslReportBuildPlugin description="FxCop Report" actionName="FxCopBuildReport" xslFileName="xsl\FxCopReport.xsl" />
      <xslReportBuildPlugin description="NCover Report" actionName="NCoverBuildReport" xslFileName="xsl\NCover.xsl" />
      <xslReportBuildPlugin description="Simian Report" actionName="SimianBuildReport" xslFileName="xsl\SimianReport.xsl"/>
      <xslReportBuildPlugin description="Fitnesse Report" actionName="FitnesseBuildReport" xslFileName="xsl\FitnesseReport.xsl"/>
      <xslReportBuildPlugin description="MSBuild Report" actionName="MSBuildBuildReport" xslFileName="xsl\msbuild.xsl"/>
      <xslReportBuildPlugin description="MSTest Report" actionName="MSTESTReport" xslFileName="xsl\MsTestReport2008.xsl"/>
      <!-- This is an example of using Project-specific build plugins
            <xslReportBuildPlugin description="My Report" actionName="MyReport" xslFileName="xsl\MyReport.xsl">
                <includedProjects>
                    <projectName>My Project</projectName>
                </includedProjects>
            </xslReportBuildPlugin>
            <xslReportBuildPlugin description="My Other Report" actionName="MyOtherReport" xslFileName="xsl\MyOtherReport.xsl">
                <excludedProjects>
                    <projectName>My Project</projectName>
                </excludedProjects>
            </xslReportBuildPlugin>
            -->
    </buildPlugins>
  </plugins>
</dashboard>

 

 

 

　　好了，大功告成了，最后呢，我再教大家一招，用变量来控制节点。我们可以把这些变量统一放在文件头来管理，这样很方便维护。

 

用变量来维护配置文件
<cruisecontrol xmlns:cb="urn:ccnet.config.builder">  
  <cb:define MyProjectName="ILoveYou"/>
  <project name =$(MyProjectName)>
  <>
  </project
</cruisecontrol>

 

　　OK，同学们，下课！

　　PS: 好累哇~~~以后我会给大家带来《如何控制团队代码规范》的课程，希望大家喜欢~~~

 

转载于:https://www.cnblogs.com/prime/archive/2009/05/24/CruiseControl.html