NAnt Builder

Description/Features

A builder plugin that will allow configuration and execution of build files for .Net/Mono projects,
using NAnt , Msbuild and devenv
and also supports the parsing and displaying of NUnit and MBUnit test results.

The plugin also includes a devenv.com builder. This plugin will allow you to configure a single Bamboo instance handle building both your Java and .Net projects, which is especially useful if you have multi-discipline teams in your organization.

Prerequisites

In order to use the NAnt Builder, you must first install NAnt, which can be obtained from http://nant.sourceforge.net. In addition, you will also need to install an
appropriate version of the .Net framework, which can be downloaded from http://msdn2.microsoft.com/en-us/netframework/aa569263.aspx or the Mono framework, which can be downloaded from http://www.mono-project.com/Downloads.

This plugin has been tested using .Net Framework v2.0 on Windows XP and Mono v1.2 on OS X using both Bamboo v1.2.x and v2.0.x If you encounter any difficulties with this builder on other platforms, please let me know and I'll endeavor to resolve the issue.

Usage

Installation

Copy the nant_builder-2.1.4.jar file into your <BAMBOO_HOME>/webapp/WEB-INF/lib directory and restart Bamboo. Please note that nant_builder-2.X.X.jar supports Bamboo 2.x, and the nant_builder-1.X.X.jar supports Bamboo 1.x.

Make sure that any older versions of the plugin are removed first!

NAnt

1. Create a new NAnt Builder via the Builders tab on the Administration page. You should be able to select NAnt as a builder type, you will need to enter a label and include the location to the path to the NAnt directory.
   
2. Once you have created a NAnt Builder, you can configure a project to use this builder via the Builder Configuration tab of the Configuration page. Here you can specify the name of the build file, the target to execute, NAnt options, environment variables, and the working sub directory.
   

NUnit/MBUnit

1. If your build produces NUnit and/or MBUnit test results, then enter the location of the test result files on the Builder Configuration tab.
   

The builder will run in the same manner as the Ant and Maven builders ie. the build output will be captured by Bamboo and displayed on the Build Log page. A build will be deemed 'successful' (and thereby appear in the shiny green colour) if the NAnt build finishes with a return code of 0 and if the last 5 lines of the NAnt build include the words 'BUILD SUCCEEDED'. In addition, if the build has been configured to run NUnit tests, a build will be deemed successful if all the tests pass. If any of these conditions are not met, then the build will be deemed to have 'failed'.

devenv.com

A devenv.com builder as well, which works in the same sort of way as the NAnt Builder and includes the support for parsing and recording NUnit test results. The devenv.com executable is included as part of Microsoft Visual Studio and allows you to build a Visual Studio Solution from the command line.

You first need to add the Builder via the Administration page

Once the builder has been added, you can use this builder in your build's Configuration.

Msbuild

Similar to the devenv builder, support for Msbuild has also been included.

.NET Script/Command builds

Generic .NET Script and Command builders are included also. These builders allow you to specify a custom command or script to be used as part of a build's execution, but which allow the parsing and displaying of NUnit/MBUnit test results.

NCover

If your build produces NCover coverage files, then enter the location of the coverage result files on the Builder Configuration tab. Bamboo will then parse and display the NCover results when each build runs.

Jira Issues

The following lists the reported defects and enhancements that have been reported. If you encounter a defect, or if there is a feature that you'd like added to the builder, feel free to raise an issue at the Jira site, or drop me an email at piaross@gmail.com.

Atlassian Developer Network JIRA (13 issues)
T	Key	Summary	Reporter	Status
	NANT-13	Rename plugin to reflect generic .NET support	Ross Rowe	Open
	NANT-12	Support Console - Xml - Xsl plug-in mode	Bernardo Heynemann	Open
	NANT-11	NDepend Support	Bernardo Heynemann	Open
	NANT-10	Support NCover to generate Test Coverage results	Bernardo Heynemann	Resolved
	NANT-9	Argument information getting lost for Nunit Command Builder	Ross Rowe	Resolved
	NANT-8	Include msbuild support	Ross Rowe	Resolved
	NANT-7	Include MBUnit support	Ross Rowe	Resolved
	NANT-6	devenv suggestions from BAM-2546	Mark Chaimungkalanont	Open
	NANT-5	NullPointerException when running remote builds	Ross Rowe	Resolved
	NANT-4	The Nant plugin shows incorrect Test Result location.	Ajay Sridhar	Resolved
	NANT-3	NUnit parser can't parse categories	Ajay Sridhar	Resolved
	NANT-2	NAnt command line options get quoted as one single argument	Stephan M�ller	Resolved
	NANT-1	Pass the build label through to NAnt	Ross Rowe	Resolved

Version History

Version 2 (supports Bamboo 2.x)

Version 1 (Supports Bamboo 1.2.x)

Screenshots

Screenshots
Displays the configuration options for the devenv.com builder	Configure a new devenv.com Builder	Displays the configuration options for parsing and recording NUnit reports
Displays the build log for a build using a NAnt builder	Displays the configuration options for the NAnt builder	The NAnt details appearing on the Configuration summary page
Configure a new NAnt Builder	Shows a NAnt build result with 100% succesful NUnit test results	Shows a NAnt build result with NUnit test failures