CruiseControl.Net学习记录

一、下载

官网

 

二、安装

本文版本：1.8.5.0

运行安装程序，按照提示"下一步”，直到完成即可。

 

安装完毕之后，

生成一个windows服务，CruiseControl.NET Server ；

生成一个webdashboard网站(可自行在IIS中配置）。

三、启动

在服务管理控制台，启动服务CruiseControl.NET Server；也可以不启动windows服务，而采用ccnet.exe控制台程序，需以管理员身份运行。

在IIS中配置启动webdashboard站点。

 

四、配置

在server目录中的ccnet.config文件中进行项目配置。

 github(git协议)

<cruisecontrol xmlns:cb="urn:ccnet.config.builder">

  <project name="ccnet.test" description="ccnet.test">
    <!--项目编译状态信息的保存位置-->
    <state type="state" directory="E:\CCNet\State" />
    <!--对这个项目的监控过程的日志记录目录-->
    <artifactDirectory>E:\CCNet\BuildArtifacts\ccnet.test</artifactDirectory>
    <!--源代码控制系统-->
    <sourcecontrol type="git">
      <repository>git://github.com/shashoutian/ccnet.test.git</repository>
      <branch>master</branch>
      <executable>E:\ProgramFiles\Git\cmd\git.exe</executable>
      <committerName>shashoutian</committerName>
      <committerEMail>shashoutian2008@126.com</committerEMail>
      <workingDirectory>D:\Projects\GitProjects\ccnet.test</workingDirectory>
    </sourcecontrol>
    <!--配置具体执行的任务-->
    <tasks>
      <exec>
        <!-- if you want the task to fail, ping an unknown server -->
        <executable>ping.exe</executable>
        <buildArgs>localhost</buildArgs>
        <buildTimeoutSeconds>15</buildTimeoutSeconds>
        <description>Pinging a server</description>
      </exec>

      <!--msbuild任务配置，用来编译项目-->
      <msbuild>
        <!--MSBuild.exe的路径-->
        <executable>C:\Windows\Microsoft.NET\Framework\v4.0.30319\MSBuild.exe</executable>
        <!--源代码的存放位置，不配置的时候为默认值 -->
        <workingDirectory>D:\Projects\GitProjects\ccnet.test\CCNet.Test</workingDirectory>
        <!--要编译的项目名称 -->
        <projectFile>CCNet.Test.sln</projectFile>
        <!-- MSBuild编译时的参数，具体参数信息可以查看MSDN上的说明-->
        <buildArgs>/p:VisualStudioVersion=14.0;Configuration=Debug;OutputPath=E:\Publish\ccnet.test /v:diag</buildArgs>
        <!--编译目标-->
        <targets>Build</targets>
        <!--超时时间-->
        <timeout>900</timeout>
        <!--日志记录模块-->
        <logger>E:\ProgramFiles\CCNet\CruiseControl.NET\server\ThoughtWorks.CruiseControl.MsBuild.dll</logger>
      </msbuild>

      <!--发布和部署配置-->
      <buildpublisher>
        <sourceDir>E:\Publish\ccnet.test\_PublishedWebsites\CCNet.Test</sourceDir>
        <publishDir>E:\Publish\ccnet.test\_PublishedWebsites\CCNet.Test</publishDir>
        <useLabelSubDirectory>false</useLabelSubDirectory>
        <alwaysPublish>false</alwaysPublish>
      </buildpublisher>
    </tasks>
  </project>

</cruisecontrol>

 

gitlab(ssh协议)

<cruisecontrol xmlns:cb="urn:ccnet.config.builder">
  <!-- This is your CruiseControl.NET Server Configuration file. 
       Add your projects below! -->
  <project name="Disney" description="Disney ManageWeb">
    <!--分类-->
    <category>后台系统</category>
    <!--日志目录-->
    <state type="state" directory="C:\CCNet\State" />
    <artifactDirectory>C:\CCNet\BuildArtifacts\Disney</artifactDirectory>
    <!--源码控制-->
    <sourcecontrol type="git">
      <repository>git@gitlab.mtime-dev.com:partner/disney-mw.git</repository>
      <branch>develop</branch>
      <executable>C:\Program Files (x86)\Git\cmd\git.exe</executable>
      <workingDirectory>D:\GitProjects\partner\abc</workingDirectory>
    </sourcecontrol>
    <!--任务-->
    <tasks>
      <exec>
        <!-- if you want the task to fail, ping an unknown server -->
        <executable>ping.exe</executable>
        <buildArgs>localhost</buildArgs>
        <buildTimeoutSeconds>15</buildTimeoutSeconds>
        <description>Pinging a server</description>
      </exec>
      <!--编译项目-->
      <msbuild>
        <executable>C:\Windows\Microsoft.NET\Framework64\v4.0.30319\MSBuild.exe</executable>
        <workingDirectory>D:\GitProjects\partner\abc\Disney.Manage.Web</workingDirectory>
        <projectFile>Disney.Manage.Web.csproj</projectFile>
        <logger>E:\ccnet\CruiseControl.NET\server\ThoughtWorks.CruiseControl.MSBuild.dll</logger>
        <targets>Build</targets>
        <timeout>900</timeout>
        <!--/p 最后一对属性值后面不需要分号（切记）-->
        <buildArgs>/p:OutputPath=E:\BuildOutput\disney;Configuration=Release;Platform=AnyCPU</buildArgs>
      </msbuild>
      <!--发布到站点-->
      <buildpublisher>
        <sourceDir>E:\BuildOutput\disney</sourceDir>
        <publishDir>E:\websites\disney\</publishDir>
        <useLabelSubDirectory>false</useLabelSubDirectory>
      </buildpublisher>
    </tasks>
    <publishers>
      <xmllogger />
      <artifactcleanup cleanUpMethod="KeepLastXBuilds" cleanUpValue="50" />
    </publishers>
  </project>  
</cruisecontrol>

五、配置节点详解

六、需要注意的问题

1、ccnet的webdashboard站点基于.net2.0运行；

2、ccnet通过git控制源代码时，需要首先确保在cmd命令行中可以执行git的各个命令，即需要配置环境变量Path：安装目录\Git\cmd，如 E:\ProgramFiles\Git\cmd；

3、使用github时，在ccnet.config中sourcecontrol节点的repository需采用git协议，而不是http协议和ssh协议，并且git协议获取的文件是只读的(待确认）；如

<repository>git://github.com/shashoutian/ccnet.test.git</repository>

 七、参考资料

使用CruiseControl.Net全面实现持续集成

.NET环境下每日集成系列

使用CruiseControl.NET进行自动化构建总结

每日集成CruiseControl.NET + SVN + Msbuild + NAnt

项目管理实践三、每日构建【Daily Build Using CruiseControl.NET and MSBuild】