NAnt Task¶

Runs a NAnt script.

tip

See Using CruiseControl.NET with NAnt for more information on working with NAnt and CruiseControl.Net.

tip

To see build progress information in the CCNet 1.5 WebDashboard remove any listener arguments from <buildArgs> and leave the <listener> property on the default value.

Version¶

Available from version 1.0

Examples¶

Minimalist example

1<nant />

Full example

 1<nant>
 2  <executable>c:\fromcvs\myrepo\myproject\tools\nant\nant.exe</executable>
 3  <baseDirectory>c:\fromcvs\myrepo\myproject</baseDirectory>
 4  <buildArgs>-D:cvs.executable=c:\putty\cvswithplinkrsh.bat</buildArgs>
 5  <nologo>false</nologo>
 6  <buildFile>cruise.build</buildFile>
 7  <logger>My.Other.XmlLogger</logger>
 8  <targetList>
 9    <target>run</target>
10  </targetList>
11  <buildTimeoutSeconds>1200</buildTimeoutSeconds>
12</nant>

Configuration Elements¶

1<variable name="name" value="value" />

* Normal
* Idle
* High
* RealTime
* BelowNormal
* AboveNormal

Notes¶

NAnt output in Xml¶

CruiseControl.NET expects NAnt to generate its output as Xml so that the build results can be parsed and rendered appropriately. To accomplish this, CruiseControl.NET will, by default, launch NAnt using the "-logger:NAnt.Core.XmlLogger" argument. If you want to override this behaviour, specify the logger property in the NAntBuilder configuration in the ccnet.config file. If this element is specified but is empty then NAnt will be started with the default logger (though this may cause some problems for CCNet). It is also possible to instruct NAnt to log its output to an Xml file and then merge the file into the build using the File Merge Task.

warning

The configuration of which NAnt logger to use was orginally specified in the ccnet.exe.config file. This has now been deprecated, and the "NAnt.Logger" element in the <appSettings> section can now be removed.

NUnit and NAnt¶

CruiseControl.NET uses xsl to process the build log and produce html for display on the web page. Since xml is so easy to parse the nunit2 task in NAnt can produce xml output. The tasks must be configured to do that in order for test results to show up on the web page. Typically this is done by adding a formatter element to the nunit2 task and setting the type to be "Xml". Additionally the usefile flag of the formatter element must be set to "false". If it isn't the nunit2 task will try and save the output to a file and not write it out to the build log.

Integration Properties¶

1<target name="test.unit" depends="compile" description="runs unit tests">
2  <nunit2>
3    <formatter type="Xml" usefile="false" />
4    <test assemblyname="${build.dir}\${core.dll}" fork="true" />
5    <test assemblyname="${build.dir}\${console.exe}" fork="true" />
6  </nunit2>
7</target>

It would be pretty tedious for developers to read the xml output when they run the build locally. Define a property for the build output type and set it to "Plain" and use the property in the formatter element..

1<build>
2  <property name="outputType" value="Plain" />
3  <!-- ... -->
4  <formatter type="${outputType}" usefile="false" />
5  <!-- ... -->
6</build>

Then in the ccnet.config file pass in a different value for outputType.

1<nant>
2  <!-- ... -->
3  <buildArgs>"-DoutputType=Xml"</buildArgs>
4  <!-- ... -->
5</nant>

Accessing CruiseControl.NET build labels in NAnt¶

CCNet will pass the current build label to NAnt via the NAnt property CCNetLabel. This means that you can access use this property to, for example, archive the newly built assemblies in a folder with the same name as the build label (this is what we do on CCNetLive. Here's an example NAnt script demonstrating how to do this:

 1<target name="dist.publish" depends="dist">
 2  <ifnot propertyexists="CCNetLabel">
 3    <fail message="CCNetLabel property not set, so can't create labelled distribution files" />
 4  </ifnot>
 5  <property name="publish.dir" value="D:\download-area\CCNet-Builds\${CCNetLabel}" />
 6  <mkdir dir="${publish.dir}" />
 7  <copy todir="${publish.dir}">
 8    <fileset basedir="dist">
 9      <includes name="*" />
10    </fileset>
11  </copy>
12</target>

Automatically Generated¶

Documentation generated on Monday, 26 May 2014 at 7:18:04 AM