CruiseControl.NET : Configuring the Server

Outside of writing your build scripts to support Continuous Integration, your main configuration task in getting an instance of CruiseControl.NET running for your project is editting the Server's configuration file.

The configuration file forms a tree of constructs, starting at the root element. The documentation for the rest of this section is reference documentation for each of the types of constructs you can use.

Once you've configured your server, you should have a file that looks something like this:

<cruisecontrol>
  <project name="MyProject">
    <webURL>http://mybuildserver/ccnet/</webURL>
    <triggers>
      <intervalTrigger seconds="60" />
    </triggers>
    <modificationDelaySeconds>10</modificationDelaySeconds>
    <sourcecontrol type="cvs">
      <executable>c:\putty\cvswithplinkrsh.bat</executable>
      <workingDirectory>c:\fromcvs\myrepo</workingDirectory>
      <cvsroot>:ext:mycvsserver:/cvsroot/myrepo</cvsroot>
    </sourcecontrol>
    <tasks>
      <nant>
        <executable>c:\fromcvs\myrepo\myproject\tools\nant\nant.exe</executable>
        <baseDirectory>c:\fromcvs\myrepo\myproject</baseDirectory>
        <buildArgs>-D:cvs.executable=c:\putty\cvswithplinkrsh.bat</buildArgs>
        <buildFile>cruise.build</buildFile>
        <targetList>
          <target>run</target>
        </targetList>
        <buildTimeoutSeconds>300</buildTimeoutSeconds>
      </nant>
    </tasks>
    <publishers>
      <merge>
        <files>
          <file>c:\fromcvs\myrepo\myproject\build\test\unit-test-results.xml</file>
        </files>
      </merge>
      <xmllogger />
    </publishers>
  </project>
  <project name="myOtherProject">
    <!-- Details for another project can go here -->
  </project
</cruisecontrol>

This example is merely a guide. Refer to the reference documentation for exact configuration options.

Example Configuration Files

When you install CruiseControl.NET, you can find an examples folder in the installation directory. This folder contains a number of example ccnet.config files that you can use to get you started.