AccuRev Source Control Block Source control integration for Accurev's source control product (http://www.accurev.com). Version Available from version 1.3 Examples true ActionFilter

ActionFilter The ActionFilter can be used to filter modifications on the basis of the type of modification that was committed. Modification types are specific to each source control provider. Consult each source control provider for the list of actions to filter. Version Available from version 1.0 ...

Alienbrain Source Control Block

Alienbrain Source Control Block Source control integration for the Alienbrain source control product. Version Available from version 1.0 Examples MyServer MyDatabase Username And Condition

Condition Checks that all the child condition pass. Version Available from version 1.6 Examples Artifact Cleanup Publisher

Artifact Cleanup Publisher The artifact CleanUp publisher allows for automatic removal of the buildlogs according to the choosen setting. It relies on the build log folder, so the XML publisher must be specified before this publisher can run. For technical reasons this publisher MUST ...

Assembly Match

Assembly Match A class to represent an assembly. Version Available from version 1.4.3 Examples Configuration Elements Element Description Type Required Default Version expr The name expression of the assembly, e.g. "\.dll". Masks ...

Assembly Version Labeller

Assembly Version Labeller Provides a valid System.Version label for your .NET assemblies that could be used to set the AssemblyVersionAttribute(). It increments the build number on every successful integration and uses the CruiseControl.NET change number, provided by source control systems like Subversion ...

CruiseControl.NET is distributed in 3 formats: Two Installers, one for CruiseControl.NET proper (the Server and Web Dashboard), and a second for the optional CCTray utility. The Installers are conventional Windows installation programs, which perform some useful early setup work for you, such as copying ...

BitKeeper Source Control Block Source control integration for the BitKeeper source control product. Version Available from version 1.0 Examples c:\build\dev1.0 true ..\Source ...

Boolean Parameter This will prompt the user to enter a boolean value when a force build is requested. This parameter can then be used by a dynamic value in a task. Version Available from version 1.5 Examples Target Yes Build Condition Condition

Build Condition Condition Checks if the current build condition matches a value. Version Available from version 1.6 Examples ForceBuild Build Log Build Plugin

buildLogBuildPlugin Configuration Elements Element Description Type Required Default Version excludedProjects The projects to exclude from this plug\in. \\This is currently not implemented. String array No None 1.0 includedProjects The projects to include in this plug\in. \\This is currently not implemented. String array No None 1.0 ...

Build Publisher

Build Publisher The Build Publisher lets you copy any arbitrary files on a successful build. You can set alwaysPublish to true, if you want the copy always to happen. Version Available from version 1.0 Examples This will copy ...

Build Report Build Plugin

buildReportBuildPlugin Configuration Elements Element Description Type Required Default Version excludedProjects The projects to exclude from this plug\in. \\This is currently not implemented. String array No None 1.0 includedProjects The projects to include in this plug\in. \\This is currently not implemented. String array No None 1.0 ...

Building Packages

Building Packages Introduction As part of the 1.4.4 release the concept of packages was introduced to the web dashboard. A package is a ZIP file that contains all the necessary files for a plugin, plus instructions on installing the files. Examples of files that can be in a package are: NVelocity templates XSLT ...

Bugs CCNET1 Email Contains Incorrect Unit Test Information (Brad Wilson) CCNET2 SiteMesh cannot parse and render Html with foreign characters (Dmitry Ponomarenko) CCNET4 faild to display ccnet.log in web interface CCNET5 Comlains of missing XmlLogger ...

Bugs CCNET1 Email Contains Incorrect Unit Test Information (Brad Wilson) CCNET4 faild to display ccnet.log in web interface CCNET5 Comlains of missing XmlLogger when it should not CCNET23 Vss writes labelling message to stderr. CCNET39 ServerLog ...

Bug CCNET70 CCTray balloon misspells successful as succesful. CCNET72 PVCS locks pvcsout.txt file CCNET73 email publishing "clickable" project link (Clayton Harbour) CCNET81 MergeFileTask should not fail if directory does not exist! CCNET86 CCNet log ...

Overview CruiseControl.NET 0.7 is one of our largest single releases so far. If you are upgrading from 0.6.1 or earlier, there are some big changes. Some updates are: Some Source Control plugins can now automatically update your source ...

Overview CruiseControl.NET 0.7 is one of our largest single releases so far. If you are upgrading from 0.6.1 or earlier, there are some big changes. Some updates are: Web Dashboard now has reporting options, allowing one web application ...

Overview CruiseControl.NET 0.8 has the following improvements since 0.7: CruiseControl.NET Server (!) Breaking Change Force Build Interval Trigger and Polling Interval Trigger have been replaced by Interval Trigger, and the Force Build Schedule Trigger and Polling Schedule ...

Overview CruiseControl.NET 0.9 has breaking configuration changes since 0.8. Make sure to read these release notes carefully and then drill down into the documentation as necessary. We recommend that as part of upgrading that you backup your current CCNet directories, and then read ...

Overview Configuration If a tasks included in the section fails then none of the subsequent tasks will be executed. This is useful if you have multiple build or test tasks that you want to execute and you want to halt the build after the first failure. However, if you ...

Overview If you are explicitly using the file state manager configuration block File State Manager in your ccnet.config file, you should be aware that the filename property has now been removed. The filename will be inferred from the project name. If you ...

official 1.0 release for CruiseControl.NET. These release notes show the list of changes since 1.0 RC2. For a list of all of the fixes included in the 1.0 release, please check the jira http://jira.public.thoughtworks.org/browse/CCNET site. Release Notes CruiseControl .NET ...

first Release Candidate for CruiseControl.NET 1.0 . We gratefully welcome any feedback that can improve the final distribution of 1.0, which we hope to release within the next few weeks. As always, if upgrading from a previous version make sure ...

second Release Candidate for CruiseControl.NET 1.0. It incorporates a number of bug fixes and enhancements based on the feedback that we have received after releasing the first release candidate. We welcome futher feedback on this candidate to improve the final distribution of 1.0. Release ...

Release Notes CruiseControl .NET Version 1.0.1 This release fixes a number of key bugs in the 1.0 release. Bug CCNET606 ModificationWriterTask should write xml as UTF8 CCNET608 Cannot download cctray from installed webdashboard virtual directory CCNET609 ...

Highlights of the CCNet 1.1 release Log4Net is used with a rolling logfile appender for logging CCNet build server output. Users can use CCTray to volunteer to fix a broken build. section allows custom tasks to run prior to build ...

Highlights of the CCNet 1.1.1 release The 1.1.1 release is a point release for CCNet 1.1. It contains a few bug fixes and some enhancements. See the list below for more details. Upgrading from CCNet 1.1 CCNet 1.1.1 should be fully backwards ...

Highlights of the CCNet 1.2 release Subversion provider can now automatically checkout source CVS provider can now automatically checkout source (there are configuration changes required for this) CCNet server does a better job of killing child processes when ...

Highlights of the CCNet 1.2.1 release This is a patch release for CCNet 1.2 that fixes a couple of important bugs with the 1.2 release. It should be compatible with the 1.2 release and will not require any modifications to the ccnet.config file or upgrading the version of CCTray. Upgrading from CCNet 1.1 ...

Highlights of the CCNet 1.3 release Integration Queues The biggest feature change to CCNet 1.3 is the addition of Integration Queues to control and manage integration concurrency. Integration queues allow you to control which projects are permitted to build concurrently and to set their relative ...

Highlights of the CCNet 1.4 release Email publisher enhancements The Email Publisher has been significantly enhanced in this release. It is now possible to configure users to receive notification for all possible build results, and to configure build notifications for users who contribute ...

Highlights of the CCNet 1.4.1 release The highlights for 1.4.1 previously said that the reporting graphs now worked in Firefox 3. That was incorrect. The work to update Dojo was not completed for the 1.4.1 release. Apologies for the confusion. Category shown on Dashboard The category element is now used ...

Highlights of the CCNet 1.4.2 release Interaction with Subversion and other external processes fixed The 1.4.1 release had a bug that prevented ccnet from using external processes correctly. Because of a race condition, CCNet would not receive all of the output from ...

Upgrading to CCNet 1.4.3 In earlier versions of CCNet, an empty trigger block was interpreted as an . This is no longer the case. An empty trigger block will produce a project with no triggers that will only build if it is forced. The statistics publisher is improved for speed reasons ...

Highlights of the CCNet 1.4.4 (RC1) release Dashboard administration A new plugin has been added to simplify the maintenance of the dashboard. Dashboard Administration Plugin contains all the details on this new plugin. Note: This plugin is not enabled by default, it will need to be manually configured ...

Highlights of the CCNet 1.4.4 RC2 release This is the second Release Candidate for CruiseControl.NET 1.4.4. It incorporates a number of bug fixes and enhancements based on the feedback that we have received after releasing the first release candidate. We welcome futher feedback on this candidate ...

Upgrading to CCNet 1.4.4 There are no breaking changes for people coming from 1.4.4 RC2, 1.4.4 RC1, or 1.4.3 There is a small issue with msbuild, since the adding of the hotswap, the default logger can not be found anymore automatically. You'll have to specify it's location explicitely ...

Highlights of the CCNet 1.4.4 SP1 release This is mainly an update to the 1.4.4 release to address the issue of the wrong NetReflector version. That gave problems with the existing plugins, also the msbuild logger problem with the hotswap has been fixed. Release Notes CruiseControl ...

nbsp;Read this first This is CTP release of CCNet 1.5. We're doing a CTP release to give you a testable preview of the new features in the upcoming release. Since this is a CTP release, we do not advise to run it in a production environment, but the more tests ...

Highlights of the CCNet 1.5 RC1 release The RC1 is mainly a bug fix of the CTP, which had more than enough new features. Smaller improvements are off course also done. The documentation also got a complete overhaul. Craig wrote ...

Highlights of the CCNet 1.5 release It has taken a lot of time, but here it finally is : the final release of 1.5 :) This release fixes bugs reported on the RC. The email publisher config is NOT compatible with 1.4.4 if you used the group element, check the new configuration ...

Highlights of the 1.6 release This is mainly a bug fix release on the 1.5 version, that one had enough new features :) New items The following features are added : Conditional Task CCNET:Conditional Task FAKE F# Make Task CCNET:FAKE ...

Please note this documentation covers the new version of CCTray included in CruiseControl.NET version 1.0 CCTray is an optional utility for use with the CruiseControl.NET Continuous Integration server. It provides feedback upon build progress, and allows control over some of the server's ...

cctrayDownloadPlugin Configuration Elements There is no configuration for this plugin. Documentation generated on Sunday, 28 Mar 2010 at 7:44:35 PM Using assembly version 1.6.7025.1

Configuration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance"> 5 CCValidator
Channel Security
CodeIt.Right Analysis Task
CommentFilter
Commit Process
Compare Values Condition

administrationPlugin A plugin for administering the dashboard. Configuration Elements Element Description Type Required Default Version password The password to lock down the administration plugin. String No Documentation generated on Monday, 12 Jul 2010 at 11:43:08 AM Using ...

root tag in the Dashboard Configuration file is the {{}} tag. The {{}} tag contains a {{}} Remote Services Configuration Block section and a {{}} Plugins Configuration Block section. Example: . . . . Date Labeller

Date Labeller The Date Labeller is used to generate labels in the format "yyyy.mm.dd.build". Using the Date Labeller makes it easy for the user to identify and communicate the date that a particular build occurred. Version Available from version 1.0 Examples Date Parameter

Date Parameter This will prompt the user to enter a date value when a force build is requested. This parameter can then be used by a dynamic value in a task. Version Available from version 1.5 Examples CutOffDate Default Issue Tracker URL Builder

Default Issue Tracker URL Builder It contains the url of the involved project, with the issue number as a parameter. Version Available from version 1.0 Examples http://jira.public.thoughtworks.org/browse/CCNET Configuration Elements ...

Default Labeller

Default Labeller By default, CCNet uses a plain incrementing build number as a build label. Some source controls (e.g. Perforce Source Control Block) require you to use a different naming scheme if you want CCNet to apply labels ...

Default Manifest Generator

Default Manifest Generator Generate a default manifest for a package. Version Available from version 1.4.4 Examples Configuration Elements Element Description Type Required Default Version type The type of generator. String must be defaultManifestGenerator ...

Default Project Security

Default Project Security The project\specific settings include a list of permissions. These permissions associate the users, roles, etc. from the server\level security with the actions. Version Available from version 1.5 Examples Developer Guidelines

Development Practices Testfirst development. Code without unit tests will not be accepted. Refactor mercilessly; however, notify the list before making large, broadreaching refactorings. Small methods (no more than 15 lines). Long methods will be collected and emailed to the list ...

Developer Registration Process

page describes the steps required for registering a new developer for the CCNet project. If you are interested in becoming a committer on the CCNet project, please contact the CCNet project administrators http://sourceforge.net/projects/ccnet; bestowing of commit rights is generally contingent on having ...

Developing Web Dashboard Plugins

Web Dashboard Plugin API is not yet stabilised. If you do write your own plugins it is recommended that you subscribe to the CCNet Checkins Mailing list http://lists.sourceforge.net/mailman/listinfo/ccnetcheckins and watch for changes to the Dashboard project The Web Dashboard ...

Direct Dynamic Value

Direct Dynamic Value This will replace the value of a property with the value from a parameter. If the user does not enter a parameter value, then the default will be used (when set). This dynamic value does not perform any formatting, it just directly puts the value into the property. Version ...

Documentation

you are reading this documentation online it refers to the most recent development build, and not any specific release\! Introduction to Continuous Integration and CruiseControl.NET What is Continuous Integration? What is CruiseControl.NET? Why CruiseControl.NET? CruiseControl.NET Integration Process For Users Getting Started First ...

Documentation Guidelines

page is meant for committers to the CruiseControl.NET project only (i) This page still needs to be thrashed out, but here are some opening thoughts Configurable blocks should be documented under Configuring the server. The hierarchy under this page mirrors the hierarchy of the Configuration itself ...

Download

Release Distributions CruiseControl.NET release distributions are available from SourceForge http://sourceforge.net/project/showfiles.php?groupid=71179&packageid=83198. If your company does not let you access SourceForge, please download the build number corresponding to the release from ...

Duplicate Finder Task

Duplicate Finder Task Check for duplicates using dupfinder (http://duplicatefinder.codeplex.com/). Version Available from version 1.5 Examples .cs Code .cs False ...

Dynamic Parameters

Dynamic Parameters Starting with CruiseControl.NET 1.5.0, it is possible to define dynamic parameters for a project. These parameters are values that are set at build time, as opposed to being hardcoded within the configuration file. Defining Parameters Parameters are defined at the projectlevel. Each parameter must be defined ...

Dynamic Values

following dynamic values are defined

EMail Converters Email converters will convert a username into an email address. The following converters are available

Email Group Defines a group of users to receive e\mails. Version Available from version 1.3 Examples Failed Fixed Configuration Elements Element Description ...

Email Publisher Publishes results of integrations via email. This implementation supports plain\text, and Html email formats. Rules regarding who receives email are configurable. The email publisher can be used to send email to any number of users. It is common ...

Email Subject This element allows to set specific subject messages according to the state of the build. When a certain state is not specified, a default will be entered. Version Available from version 1.0 Examples Email User

Email User Defines a user who will receive e\mails. Version Available from version 1.0 Examples Configuration Elements Element Description Type Required Default Version address ...

Encrypted Messages Channel

Encrypted Messages Channel Messages will be encrypted using this channel. Version Available from version 1.5 Configuration Elements Element Description Type Required Default Version Documentation generated on Monday, 14 Dec 2009 at 2:01:23 AM

Enterprise Continuous Integration with Binary Dependencies example

example shows how to use CruiseControl.NET to automate 'Enterprise' (or crossproject) Continuous Integration (ECI). The particular flavour of ECI works by splitting up 1 project into 2 and introducing a 'binary' (or DLL) dependency between the 2. An ECI build is used ...

Environment Variable

Environment Variable An environment variable. Version Available from version 1.0 Examples Configuration Elements Element Description Type Required Default Version name The name of the environment variable. String Yes ...

Examples

Executable Task

Executable Task The Executable Task lets you invoke any command line executable. It doesn't offer as much specific integration as (for example) the NAnt Task, but does allow you to hook almost anything up as a build process to CCNet. CCNet ...

External File Server Security

External File Server Security Defines a security manager implementation that implements security with configuration in external files. Version Available from version 1.5 Examples users.xml ...

External Links

External Links The section can contain any number of sub\sections. Each of these are used to display project related links on the project report page of the Web Dashboard, and are meant as a convenient shortcut to project\related web sites outside ...

External Source Control

External Source Control Configuration A source control implementation for use when the source control system doesn't integrate directly with CCNet. Version Available from version 1.3 Examples path to commandline application

FAKE F# Make Task Runs a FAKE \ F# Make script. "FAKE \ F# Make" is a build automation system. Due to its integration in F#, all benets of the .NET Framework and functional programming can be used, including the extensive class ...

CruiseControl.NET Frequently Asked Questions (FAQ) This FAQ is not meant to be a complete reference to CruiseControl.NET, but does provide some quick ideas about how to get various things done. If you want to add questions, answers, or both, please use the ccnetuser ...

farmReportFarmPlugin Configuration Elements Element Description Type Required Default Version defaultSort The default column to sort by. String No successBar Gets or sets the success indicator bar location. String one of: None Top Bottom TopAndBottom No categories Boolean No Documentation ...

FBVariable Defines a variable to pass to FinalBuilder. Version Available from version 1.3 Examples Configuration Elements Element Description Type Required Default Version name The name of the variable. String Yes n ...

File Based Security Cache Provides an in\memory cache for sessions that is backed by a store on disk. This cache will store the sessions details in memory for quick\access. Whenever a session is changed it also writes a copy of the details to a file on the disk. Then when the security ...

File Exists Condition Checks if a file exists. Version Available from version 1.6 Examples readme.txt File Labeller

File Labeller The File Labeller is used to generate labels based on the content of a disk file. The labeller is configured with the location of the file, and it reads the file content to generate the label for CCNet. The file is read just before the first pre\build task is executed ...

File Merge Task

File Merge Task Merges external files into the build log. Most build processes interact with external tools that write their output to file (e.g. NUnit, FxCop, or NCover). To make the output of these tools available to CruiseControl.NET to be used in the build process or displayed ...

File State Manager

File State Manager The File State Manager is a State Manager that saves the state for one project to a file. The filename should be stored in either the working directory for the project or in the explicitly specified directory. The filename will match the project name, but will have the extension .state ...

Filesystem Source Control Block

Filesystem Source Control Block Use the 'Filesystem' Source Control plugin to check for modifications on a directory accessible by the build server. A file is considered modified if the file's modified time stamp is more recent than the last time CruiseControl.Net checked for modifications ...

Filter Trigger

Filter Trigger The Filter Trigger allows you to prevent builds from occurring at certain times or on certain days (such as when your source control repository is undergoing backup). It is used to decorate an existing trigger. For example, if you have set ...

Filtered Source Control Block

Filtered Source Control Block The FilteredSourceControl allows you to filter out modifications that are used to trigger a build. If for example, you have certain files (such as web pages or document files) under source control that you don't want to have trigger ...

FinalBuilder Task

FinalBuilder Task The FinalBuilder Task allows you to invoke FinalBuilder build projects as part of a CruiseControl.NET integration project. FinalBuilder is a commercial build and release management solution for Windows software developers and SCM professionals, developed and marketed by VSoft Technologies (http ...

FirstMatch

FirstMatch A statistic that extracts the first item that matches the specifed XML XPath. Version Available from version 1.0 Configuration Elements Element Description Type Required Default Version generateGraph Should a graph be generated for this statistic? Boolean No false 1.3 ...

Folder Exists Condition

Folder Exists Condition Checks if a folder exists. Version Available from version 1.6 Examples documentation ForceBuildPublisher

Force Builder Publisher The ForceBuildPublisher forces a build on a local or remote build server. It uses .NET Remoting to invoke a forced build on the CruiseControl.NET server at the specified URI. The forced build runs asynchronously, i.e. the ForceBuildPublisher does not wait for the forced build ...

FTP Source control

FTP Source control The Ftp Soure control block allows to detect new and changed files at an Ftp site. Deleted files are NOT detected. Version Available from version 1.4.4 Examples ftp.isp.com Ftp task - Publisher

FTP Task / Publisher The ftp task / publisher allows to download or upload files/ folders, for example, uploading a new version of a web page to ftp site of an ISP. Version Available from version 1.5 Examples ftp.isp.com ...

Gendarme Task Gendarme is a extensible rule\based tool to find problems in .NET applications and libraries. Gendarme inspects programs and libraries that contain code in ECMA CIL format (Mono and .NET) and looks for common problems with the code, problems that compiler do ...

General Security The following are general security items, or elements that can be used at both the server and project levels

General Security Permissions The following are the general security permissions: Element Description Type Required Version defaultRight This is the permission that will be used if no other permission has been specified. See notes below for how this works. Permission No 1.5.0 forceBuild The force/abort ...

Git Source Control Block Source Control Plugin for CruiseControl.NET that talks to git. Version Available from version 1.5 Examples git://github.com/rails/rails.git

Sometimes (eg: if you want to build a list of projects in sequence) it can be convenient to trigger builds from a NAnt script. For that purpose one can use the launchccnetbuild NAnt task (source available here: LaunchCruiseControlBuildTask.cs). Example: HTML Report Plugin

HTML Report Plugin A generic plug\in to display a report from an HTML file. Version Available from version 1.5 Examples HTTP Request Header

HTTP Request Header A header for an HTTP request. Version Available from version 1.5 Examples

Configuration Elements Element Description Type Required Default Version name Gets or sets the name ...

HTTP Settings

HTTP Settings The settings for an HTTP request. Version Available from version 1.5 Examples http://somewhere.com GET http://somewhere.com/ false HTTP Status Task

HTTP Status Task Sends an HTTP request to the specified URL. Version Available from version 1.5 Examples http://somewhere.com False

Impersonation Defines the details to use for impersonating another user account. Version Available from version 1.5 Configuration Elements Element Description Type Required Default Version domain The name of the domain to use. String Yes n/a 1.5 password ...

Memory Security Cache Provides an in\memory cache for sessions. Version Available from version 1.5 Examples Configuration Elements Element Description Type Required Default Version type ...

Inherited Project Security Inherit the security settings for a project from the server settings. Version Available from version 1.5 Examples Configuration Elements Element Description Type Required Default Version type The type of the project ...

CruiseControl.NET Server To get CruiseControl.NET server up and running, you need to have the following environments set up and installed: Microsoft.NET Framework Version 2.0 (download http://www.microsoft.com/downloads/details.aspx?FamilyID=0856EACB43624B0D8EDDAAB15C5E04F5&displaylang=en) CruiseControl.NET Web ...

Previous versions (0.8 and earlier) of the Dashboard required you to setup a {{projectcache}} folder with certain privileges. This is no longer necessary. If you have earlier versions of the Dashboard installer you should delete that folder and revert all custom privileges. Simple Installation ...

Label Description Example Version CCNetBuildCondition The condition used to trigger the build, indicating if the build was triggered by new modifications or if it was forced. Legal values are: "IfModificationExists" or "ForceBuild" ForceBuild CCNetIntegrationStatus The status of the current integration. Could be Success, Failure, Exception or Unknown Success ...

Integration Queues Concurrent and Serialised Builds The default behaviour of CruiseControl.Net is that each project defined in the configuration is given its own integration thread, thereby allowing differently named projects to build concurrently. Note however that a single project can never ...

Internal Server Security Defines a security manager implementation that implements security internally \ the security settings are stored in the same configuration file. Version Available from version 1.5 Examples Interval Trigger

Interval Trigger The Interval Trigger is used to specify that an integration should be run periodically, after a certain amount of time. By default, an integration will only be triggered if modifications have been detected since the last integration. The trigger can also ...

Issues

We track CCNet issues using Jira here http://jira.public.thoughtworks.org/secure/BrowseProject.jspa?id=10000 Here's a list of the current outstanding issues

IssueUrlBuilder

addition to the sourcecontrol provider allows easy linking with an issue tracking system like Jira, Gemini, Bugzilla, ... The issueUrlBuilder will try to convert the comment (or parts from it) into an url pointing to the issue for this build. These are the items that will have the comment transformed into an ...

Iteration Labeller

Iteration Labeller The Iteration Labeller is similar to the Default Labeller; however, it maintains a revision number that is incremented by one for each iteration from the release start date. For example, if the release start date was June 1, 2005 and the iteration duration was 2 weeks ...

Labellers are used to generate the label that CCNet uses to identify the specific build. The label generated by CCNet can be used to version your assemblies or label your version control system with each build. Types of Labeller Block

Last Build Status Condition Checks if the status of the last build matches a value. If no previous build exists any specified status will return false. Version Available from version 1.6 Examples Last Build Time Condition

Last Build Time Condition Checks if the last build started at least a certain time period ago. Version Available from version 1.6 Examples 5 Last Change Labeller

Last Change Labeller Some source control systems (e.g., AccuRev) have a concept of a "change number", which the Last Change Labeller can use to build a label. The following configuration would prefix all labels with the string 'Foo\1 ...

Latest Build Report Project Plugin

latestBuildReportProjectPlugin Configuration Elements There is no configuration for this plugin. Documentation generated on Sunday, 28 Mar 2010 at 8:03:20 PM Using assembly version 1.6.7027.1

LDAP Email Converter

LDAP Email Converter Looks up the email address via LDAP. Version Available from version 1.4.1 Examples This will search the LDAP for source control userid "js" , using default settings. This will search ...

LDAP User Authentication

LDAP User Authentication Stores a user name \ authentication will come from Active Directory. Version Available from version 1.5 Examples Configuration Elements Element Description ...

License

ThoughtWorks Open Source Software License, Version 1.0 Copyright (c) 2003 ThoughtWorks, Inc. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: # Redistributions of source code ...

We use Google Groups http://groups.google.com to host public mailing lists. To subscribe to lists, or read their archives, click the appropriate link below. You will need a (free) Google account to subscribe to these lists, and you must subscribe if you wish ...

Manifest Generators Manifest generators generate a "manifest" to be included in a package. A manifest contains additional details on the package, both at a general level and at a file level, and can be used by external systems. The following generators are available

Manifest Importer Imports a manifest from an existing file. Version Available from version 1.4.4 Examples Configuration Elements Element Description Type Required Default Version type The type of generator ...

Mercurial Issue Tracker URL Builder Build a Mercurial URL. Version Available from version 1.5 Examples http://hg.mycompany.com/hgwebdir.cgi/myproject/ Configuration Elements Element Description Type Required ...

Mercurial Source Control Block Provides support for Mercurial repositories. Checking for changes, checking out or updating sources, committing build modifications and untracked files, tagging, pushing to the remote repository, reverting modifications and purging untracked and ignored files are supported ...

Merge File Details on a file to merge. Version Available from version 1.0 Examples Configuration Elements Element Description Type Required Default ...

MKS Source Integrity Source Control Block MKS Source Integrity Source Control Block. Version Available from version 1.0 Examples C:\MKS\bin\si.exe CCNetUser Modification Filters

Modification Filters Modification filters allow filtering the source control modifications

Modification Reader Task

Modification Reader Task This tasks makes it possible to read back modifications made by the Modification Writer Task. Version Available from version 1.4 Examples true lastmods.xml modspath Modification Writer Task

Modification Writer Task This task writes the detected modifications for the current integration to a file as XML. This enables the modifications to be used by external programs, such as within a NAnt build script. Version Available from version 1.0 Examples mods.xml ...

ModificationHistory Publisher

Modification History Publisher This publisher logs all modifications for each build in a file. These modifications can be viewed in the Dashboard with the modificationHistoryProjectPlugin plugin enabled. Version Available from version 1.3 Examples Configuration Elements Element ...

modificationHistoryProjectPlugin

plugin shows all the modifications of a project. The newest builds are shown first. The project must use the ModificationHistory Publisher to get results to show up. Minimal Configuration  < modificationHistoryProjectPlugin /> .... This is available from build 1.3.0.2981 onwards Full Configuration ...

MsBuild Task

MSBuild Task The task is used to execute MsBuild projects, which are the default project format for Visual Studio 2005 projects and can also be compiled by using the MSBuild application that ships with the .NET 2 Framework. In order to work with the results of MsBuild ...

Multi Issue Tracker URL Builder

Multi Issue Tracker URL Builder This issue tracker allows a combination of the other issuetrackers. Version Available from version 1.0 Examples http://jira.public.thoughtworks.org/browse/CCNET Multi Source Control Block

Multi Source Control Block You can use the 'Multi' Source Control plugin to check for modifications from any number of source control repositories. You may want to do this if (for example) you want to build if the source for your project ...

Multiple Projects

CruiseControl.NET server can be configured to manage the integration requirements for several projects concurrently. To do this, simply include the configuration for the different projects consecutively in the ccnet.config file. ... ... If you ...

Multiple Trigger

Multiple Trigger The Multiple Trigger is used to support the execution of multiple nested triggers. Each trigger will be executed sequentially in the order specified in the configuration file. By default, if any of the triggers specify that a build should occur then a build will be triggered. The build condition will be ForceBuild ...

Multiple XSL Report Build Plugin

The Multiple XSL Report Build Plugin shows detailed output for a specific build. This report is generated by applying a list of XSL transforms to the build's log file. It also allows for end users create build reports that combine existing XSL ...

Named Value A value with an associated name. This is a generic configuration item that is used in other configuration elements. Version Available from version 1.4.4 Examples Configuration Elements Element Description Type Required ...

NAnt Task Runs a NAnt script. See Using CruiseControl.NET with NAnt for more information on working with NAnt and CruiseControl.Net. To see build progress information in the CCNet 1.5 WebDashboard remove any listener arguments from and leave the property ...

NCover Profiler Task Perform a code coverage profile using NCover. NCover is a commerical application that will profile code while unit tests are running. The tool is available from http://www.ncover.com/. CruiseControl.NET only supports NCover 3.x currently. Version ...

NCover Report Task Generate a code coverage report using NCover. NCover is a commerical application that will profile code while unit tests are running. The tool is available from http://www.ncover.com/. CruiseControl.NET only supports NCover 3.x currently. Version ...

NDepend Task Runs an NDepend analysis. NDepend is a tool that simplifies managing a complex .NET code base. Architects and developers can analyze code structure, specify design rules, plan massive refactoring, do effective code reviews ...

NetReflector is the xml binding framework used by CCNet to handle the deserialisation of the configuration data into the objects used by the application. You can find out more about NetReflector on the confluence site http://confluence.public.thoughtworks.org/display/NetReflector. The NetReflector project is hosted on SourceForge ...

CCNet Blog

Null Project Security This element turns off security at the project level. A project with this security will give all rights to all users. Version Available from version 1.5 Examples Configuration Elements Element Description Type ...

Null Server Security A default implementation of a security manager where there is no security (e.g. every right is allowed); Version Available from version 1.5 Examples Configuration Elements Element Description Type Required Default Version Documentation generated ...

Null Source Control Block Use the Null Source Control if you don't want to check a Source Control repository for changes. In this instance you would always want to either use a 'Force Build' Trigger or always manually start builds ...

Null Task The Null Task is a task that doesn't do anything \ it simply returns successfully. This is useful for projects that simply monitor the source control system for changes but don't need to do anything. Version Available from version 1.0 Examples Numeric Parameter

Numeric Parameter This will prompt the user to enter a numeric value when a force build is requested. This parameter can then be used by a dynamic value in a task. Version Available from version 1.5 Examples MaxAllowedErrors NUnit Task

NUnit Task See Using CruiseControl.NET with NUnit for more details. This task enables you to instruct CCNet to run the unit tests contained within a collection of assemblies. The results of the unit tests will be automatically included in the CCNet build results. This can be useful ...

Ohloh Stats Display Plugin Display Ohloh stats for a project. Version Available from version 1.5 Examples Configuration Elements There is no configuration for this plugin. Notes Configuration is done in ccnet.config via the linkedSites property This can be installed using the "Ohloh ...

Condition Checks that at least one child condition matches. Version Available from version 1.6 Examples

Package Publisher Generates a ZIP file package containing the specified files. This will generate a "package" of files in a compressed format. The files must be specified, plus an optional manifest can be included. This publisher also allows the generation of a "manifest" to include in the package ...

Some points for saving time : Create the release notes a few days before the actual release, giving other devs also the chance to complete it, read it over, ... Prepare the mail to be sent to the dev and user list in advance, and save it as a draft. So ...

Parallel Task Runs a set of child tasks in parallel. Each task will run at the same time as the other tasks. To run a set of tasks in sequential order within this task, use the Sequential Task. Version Available from version 1.5 Examples ...

Parameter Trigger Trigger to add build parameters to an integration request. Like all triggers, the parameterTrigger must be enclosed within a triggers element in the appropriate Project Configuration Block. As shown below, the configuration of the nested trigger is not the same as when using ...

following parameters are defined

PathFilter The PathFilter can be used to filter modifications on the basis of their file path. Version Available from version 1.0 Examples $/Kunigunda/ServiceLocator/Sources/Kunigunda.ServiceLocator/AssemblyInfo.cs Configuration Elements Element Description Type Required ...

Using the PathFilter: PathFilter supports following wildcards: Wildcard Used as Matches Example \" part of the path none or exactly one subfolder Pattern "/Kunigunda//Sources/." matches "/Kunigunda/Sources/.", "/Kunigunda/Service/Sources/.", and "/Kunigunda/Web/Sources/." "" part of the folder ...

Perforce Source Control Block Perforce source control block. Version Available from version 1.0 Examples //projects/myproject/... //projects/ccnet/...,//tools/nant ...

PlasticSCM Source Control Block This supports Códice Software's Plastic SCM source control system. Version Available from version 1.3 Examples c:\workspace br:/main Plugins Configuration Block
PowerShell Task
Project Configurable Build Plugin
Project Configuration Block

Queues in CruiseControl.NET Queues can be defined in one of two ways: # Implicitly: When a queue is defined in a project element, a queue will be automatically created. This will have the default settings for a queue. # Explicitly: This is when a queue element is added to the configuration. Note: projects still ...

Queue Status Server Plugin The Queue Status Server Plugin displays the status of the queues on the specified server. Version Available from version 1.4.3 Examples Configuration Elements There is no configuration for this plugin. Notes This can be installed using the "Queue Status ...

Rake Task Executes Rake. Version Available from version 1.4 Examples c:\ruby\bin\rake.bat c:\fromcvs\myrepo\myproject additionalargument Rakefile Rational ClearCase Source Control Block

Rational ClearCase Source Control Block Rational ClearCase source control block. Version Available from version 1.0 Examples C:\PATH\TO\SOURCE true Regex Issue Tracker URL Builder

Regex Issue Tracker URL Builder This will use regular expressions to convert the comment into an url. Version Available from version 1.0 Examples .(CCNET.?\d).$ http://jira.public.thoughtworks.org/browse/$1 ...

Regular Expression Email Converter

Regular Expression Email Converter Matches the username against a regular expression pattern and modifies it according to a specified replacement. Uses the .NET regular expression language. The find attribute contains a regular expression that is matched against the source control userid. The replace ...

Remote Project Labeller

Remote Project Labeller This labeller retrieves the last successful integration label for a project on a remote server. You can use this labeller if you have split your build across multiple projects on different servers and you want to use a consistent ...

Remote Services Configuration Block

time the {{}} tag just contains a {{}} Servers Configuration Block section. This section contains all the build servers that the Dashboard will visualize. Example: . . Replacement Dynamic Value

Replacement Dynamic Value This will replace any number of parameters into a format string. The format string can also include formats for each parameter. Version Available from version 1.5 Examples t:Help Resources

Useful links CruiseControl.NET Community Site CCNETCOMM: Report a bug or request a feature (JIRA) http://jira.public.thoughtworks.org/secure/BrowseProject.jspa?id=10000 CCNet Sourceforge Project Page http://www.sf.net/projects/ccnet/ CCNetLive http://ccnetlive.thoughtworks.com/ CruiseControl for Java ...

Roadmap

Current plans for new features in CruiseControl.Net. What's Coming? This page is currently a work in progress. We are still in the process of looking at what to add in future releases. Here are some of the things that we are planning for upcoming releases of CruiseControl.Net. Release 1.5 Version ...

RoboCopy Source Control Block

RoboCopy Source Control Block Uses RoboCopy as Source Control. Version Available from version 1.4.4 Examples C:\Somewhere Configuration Elements Element Description Type Required Default Version ...

Role Permission

Role Permission Defines the permissions for a role (a group of users). Version Available from version 1.5 Examples Roll-up Trigger

Rollup Trigger A trigger that will "roll\up" multiple changes into a single trigger. This trigger can be used to reduce the load on a build server for in very active development environment. Version Available from version 1.6 Examples RSS Publisher

RSS Publisher This publisher generates an RSS file reporting the latest results for a Project. The RSS feed is available via the Dasboard in the Project Report. There needs to be 1 build done with this publisher for the icon to show up. Version Available from version ...

RSSFeedProjectPlugin

publisher generates an RSS feed reporting the builds for a project. The project must use the RSS Publisher to produce the data for the feed. This is available from build 1.3.0.3011 onwards. The RSS icon will be displayed on the project page, whenever a build is done with the RSS ...

Small Inhouse Development Team Scenario #1: Small Inhouse Development Team Background The company is Acme Insurance, the company that provides development insurance for software houses. Bob leads a team of six people three developers, a business analyst (BA ...

Full Example Here is the full configuration for the example. I have omitted the duplicate projects since this scenario is focusing on the security: Scenario 2

Large Inhouse Development Team Scenario #2: Large Inhouse Development Team Background The company Acme Banking, a large multinational bank. Lu is the manager of the lending application software development department and has a staff of 19 people working for him ...

Scenario 2 - Full Example

Full Example Here is the full configuration for the example. I have omitted the duplicate projects since this scenario is focusing on the security: Scenario 3

Open Source Project Scenario #3: Open Source Project Background Petros has been working on an open source project called Midas for about a year now. This project is hosted on SourceForge, and he is the only administrator. However recently ...

Scenario 3 - Full Example

Full Example Here is the full configuration for the example: Schedule Trigger

Schedule Trigger The Schedule Trigger is used to specify that an integration should be run at a certain time on certain days. By default, an integration will only be triggered if modifications have been detected since the last integration. The trigger can be configured to force ...

SCM Policy

page describes Source Control, Build Management and Issue Tracking policy for the CruiseControl.NET project. (!) This is how CruiseControl.NET manages itself as a project in development. If you are just using CruiseControl.NET you of course do not need to follow these same guidelines, but you might ...

Seapine Surround Source Control Block

Seapine Surround Source Control Block Source Controller for Seapine Surround SCM The Seapine Surround provider is designed to work with Surround 4.1. It may not work with earlier versions of Surround. Version Available from version 1.0 Examples Security

Security Starting with CruiseControl.NET 1.5.0, it is possible to add security to a CruiseControl.NET instance. This page provides an overview of security for CruiseControl.Net on the server side. It includes how security works and why it might be needed. This includes defining the different parts of security and how ...

Security Audit Loggers

Security Audit Loggers A security audit logger will log audit events to a log. There can be multiple audit loggers for a server, but there can only be one primary audit log. The primary audit log is the log that is read and used for retrieving records for a client ...

Security Audit Readers

Security Audit Readers A security audit reader will read the primary audit log and return the audit records. While there can be multiple audit logs, there can only be one primary log. It is called the primary log because it is the source of information for any ...

Security Caches

Security Caches A security cache is used to hold the session details. When a user is authenticated a new session token will be generated and returned to the client. All future requests then use this token to validate the user. The security cache is what holds these tokens and allows ...

Security Configuration

Security Configuration This section defines how to configure the security at both a server and a project level

Security Extension Points

Security Extension Points Nearly every item in security can be extended or replaced. This page will cover some of the key points for extending security. Server Extensions Security at the server level implements {{ISecurityManager}} . This interface handles the core functionality of security including ...

Security Permissions

following permission types are allowed

Security Scenarios

Security Scenarios These scenarios describe some ways of using security. They include a fictional scenario with some requirements, an analysis of the security requirements and a description of how to apply security to satisfy the requirements

Security Users

Security Users In order for security to be usable, one or more users must be defined. Currently, the following types of users can be defined

Select Parameter

Select Parameter This will prompt the user to select a value from a list of values when a force build is requested. This parameter can then be used by a dynamic value in a task. Version Available from version 1.5 Examples Target Sequential Task

Sequential Task Runs a set of child tasks in order. This task is primarily designed for scenarios where execution can take more than more path (e.g. Parallel Task). This is normally not required for tasks directly under the prebuild, tasks or publishers ...

Server Application Config File

Various aspects of the CruiseControl.NET Server are configured in the application configuration file. The name of this file depends on how you are running the server: If you are running the Console Application, the application config file is called {{ccnet.exe.config}}. If you are running the Windows Service Application, the application ...

Server Audit History Project Plugin

Server Audit History Project Plugin The Server Audit History Project Plugin displays the audit log from the server. server is running. Version Available from version 1.5 Examples Configuration Elements There is no configuration for this plugin. Notes This requires ...

Server Audit History Server Plugin

Server Audit History Server Plugin The Server Audit History Server Plugin displays the audit log from the server. server is running. Version Available from version 1.5 Examples Configuration Elements There is no configuration for this plugin. Notes This requires ...

Server Extensions

Server Extensions This documentation is in the process of being developed. As such it may omit details or be incomplete in areas. Introduction As of release 1.4.4, it is possible to build server extensions for both the console and the Windows service. An extension is different from a plugin. A plugin must be referenced ...

Server Information Server Plugin

Server Information Server Plugin The Server Information Server Plugin gives you information about a build server, for example the version of CruiseControl.NET the build server is running. Version Available from version 1.4.4 Examples Server Level Security

Server Level Security The following elements are defined at the server level for security

Server Log Project Plugin

Server Log Project Plugin The Server Log Project Plugin shows you recent activity that has been output to the server log for a specific project. Version Available from version 1.0 Examples Configuration Elements There is no configuration for this plugin ...

Server Log Server Plugin

Server Log Server Plugin The Server Log Server Plugin shows you recent activity that has been output to the server log for a specific build server. Version Available from version 1.0 Examples Configuration Elements There is no configuration ...

Server Report Server Plugin

Server Report Server Plugin The Server Report Server Plugin shows you status information for all projects on a specific server. If the Dashboard cannot connect to the server then an errors table is shown detailing the problem.. Version Available from version ...

Server Security Configuration Project Plugin

Server Security Configuration Project Plugin Displays the security configuration for a project on a build server. Version Available from version 1.5 Examples Configuration Elements There is no configuration for this plugin. Notes This can be installed using the "Security Configuration Display" package ...

Server Security Configuration Server Plugin

Server Security Configuration Server Plugin Displays the security configuration for a build server. Version Available from version 1.5 Examples Configuration Elements There is no configuration for this plugin. Notes This can be installed using the "Security Configuration Display" package. Documentation ...

Servers Configuration Block

Dashboard needs to connect over the network to each of Build Servers you want to report on. If you have changed any of the remoting configuration for your servers, you'll need those details now. (See Server Application Config File for more ...

Setting up from scratch Part 01

We'll be setting it up step by step, so this will be a real step by step approach. The reason is you can see what the benefits are of the setups used in this document. The first parts will seem overdone for users who used CCNet before, but it is intended for the real ...

Simple Security Plugin

Simple Security Plugin Allows the user to send a user name and password to the server for authentication. Version Available from version 1.5 Examples Configuration Elements Element Description Type Required Default Version hidePassword ...

Site Index

Site Index for the CruiseControl.NET Space

Solution Structure

Here is a dependency graph of the assemblies contained within the CCNet project. This graph is in the SVG format, so you will need to download an SVG Viewer http://www.adobe.com/svg/viewer/install/main.html. ccnet.svg

Source Control Blocks

Source Control Blocks Source Control Feature Matrix This matrix represents the source control provider capabilities as of the current CCNet release. Source Control Detect Modifications Update Source Checkout Source Label Modification Urls AccuRev (/) (/) (/) (/) (x) Alienbrain ...

SourceAnywhere Standalone Source Control Block

Because the plugin is developed using SourceAnywhere Standalone SDK, it is available as a standalone plugin at the Dynamsoft SourceAnywhere Standalone Download Site http://www.dynamsoft.com/Downloads/SAWStandaloneDownload.aspx. SourceAnywhere Standalone (SAWS) Configuration Examples Minimal example: SourceGear Vault Source Control Block

SourceGear Vault Source Control Block SourceGear Vault Source Control Block. Version Available from version 1.0 Examples c:\program files ...

Splitting the build

your codebase grows and your build starts to take an increasingly long time, it often makes sense to think about splitting your build process into a set of dependent builds (check out my paper "Scaling Continuous ...

StarTeam Source Control Block

StarTeam Source Control Block Source Controller for StarTeam SCM. Version Available from version 1.0 Examples c:\starteam\stcmd.exe ccnet buildguy buildguypw ...

State File Labeller

State File Labeller This labeller retrieves the last successful integration label for a project using the project's state file. You can use this labeller if you have split your build across multiple projects and you want to use a consistent ...

State Manager Blocks

CruiseControl.NET needs to store state about a project. This is data such as the last build label, the time of the last build, and the outcome of the build, etc. The State Manager allows you to specify how and where this data is stored. Types of State Manager Block

Statistic

Statistic A generic statistic. Version Available from version 1.0 Configuration Elements Element Description Type Required Default Version generateGraph Should a graph be generated for this statistic? Boolean No false 1.3 include Should this statistic be collected and published? Boolean ...

Statistics

following types of statistics are available: Statistic FirstMatch

Statistics Publisher

Statistics Publisher The publisher can be used to collect and update statistics for each build in a file. Some of the statistics which would be collected are build durations and test count. At the minimal, the publisher can be configured with just an empty element in the publishers ...

Status Condition

Status Condition Checks if the current status matches a value. Version Available from version 1.6 Examples Failure Subversion Source Control Block

Subversion Source Control Block CruiseControl.NET provides basic support for Subversion repositories. Checking for changes, checking out or updating sources, and tagging\by\copying are supported, but more advanced features such as using Subversion revision numbers are not yet supported. Subversion support ...

Support

CruiseControl.NET is not a commercial piece of software, so we cannot guarantee support. However, we do have some ways to help you with issues you may have: If you subscribe to the CCNetuser mailing list Mailing Lists, and post any ...

Synchronisation Context Task

Synchronisation Context Task A sychronisation context across multiple tasks or projects. Only one task can be in a synchronisation context at any time. This provides a mechanism for locking, either within a project or inbetween projects. Version Available from version 1.5 ...

Synergy Client Session

Synergy Client Session A CM Synergy client session. Version Available from version 1.0 Examples myserver \\myserver\share\mydatabase %CCMUSER% Synergy Issue Tracker URL Builder

Synergy Issue Tracker URL Builder A URL builder to link each modification to the ChangeSynergy task details form. Version Available from version 1.0 Examples User http://myserver:8060 Synergy Project

Synergy Project A CM Synergy project (which is similar to a "view" in other SCM packages). Version Available from version 1.0 Examples Product/1.0 Product1 1234 false

Task Blocks are the action elements of CruiseControl.Net. They're the elements that do things, like executing a program, running tests, or send email results. Task blocks must appear in the {{}} section, the {{}} section or the {{}} section. The {{}} section is always ...

Task Condition Blocks These are the various conditions that can be used in the Conditional Task task

Telelogic Synergy Source Control Block CruiseControl.NET SCM plugin for CM Synergy. Detection of modifications is entirely task based rather than object based, which may present problems for pre\6.3 lifecycles. Successful integration may be published ...

Text Parameter This will prompt the user to enter a text value when a force build is requested. This parameter can then be used by a dynamic value in a task. Version Available from version 1.5 Examples Target The CruiseControl Configuration Block

root tag in the Server Configuration file is the {{}} tag. The {{}} tag can contain 1 or many Project Configuration Blocks as sub tags. Read the Multiple Projects page if you'd like to have more than 1 project section ...

The Server Console Application

You can launch the CruiseControl.NET server by executing the {{{}ccnet.exe{}}} file, which is located in the {{{}server{}}} folder of the extracted distribution. Before doing this, make sure to setup the Server Application Config File. Executing the server using the {{\help{}}} flag (eg. {{ccnet.exe ...

The Server Service Application

Installing CCService CCService is a Windows Service that can be used to launch the CCNet server. If you used the CruiseControl.NET Installer to setup CCNet on your machine, the CCNet service should already be configured. Look in the Services section of the Control Panel on your machine ...

ThoughtWorks

CruiseControl.NET is developed by ThoughtWorks. We are a world leading Systems Integrator, specializing in Agile Development Techniques. You can read more about us at http://www.thoughtworks.com (i) We are currently recruiting around the world check out our career ...

Timeout Configuration

Timeout Configuration Most source control blocks allow you to specify a timeout for operations (see the documentation for the specific source control block to be certain). By default you specify the timeout in milliseconds. If you specify the timout as an element, it can be set ...

Trigger Blocks

Trigger blocks allow you to specify when CruiseControl.NET will start a new integration cycle. For CI you'll want to use an Interval Trigger. Also useful is the Schedule Trigger for implementing daily builds. Use the Filter Trigger to prevent builds ...

document describes two approaches to upgrading CCNet: a quick upgrade process (optimistic) and a slower, safer upgrade process that allows for quickly rolling back to the earlier install if required (pessimistic). Optimistic Approach: # Stop the CCNet server (either by closing the console ...

URL Header Value Condition Checks if a URL returns a specified header. Version Available from version 1.6 Examples http://somewhere.com URL Ping Condition

URL Ping Condition Checks if a URL can be pinged. Version Available from version 1.6 Examples http://somewhere.com Url Trigger

URL Trigger The Url Trigger is used to trigger a CCNet build when the page at a particular url changes. The Url Trigger will poll the specified url according to a configured polling interval to detect if the last modified date of the page has changed since ...

User List Project Plugin

User List Project Plugin Displays all the users in the system, plus the security rights they have for the project. Version Available from version 1.5 Examples Configuration Elements There is no configuration for this plugin. Notes This can be installed using the "User List ...

User List Server Plugin

User List Server Plugin Displays all the users in the system, plus the security rights they have on the server. Version Available from version 1.5 Examples Configuration Elements Element Description Type Required Default ...

User Name

User Name The name of a user. Version Available from version 1.5 Examples Configuration Elements Element Description Type Required Default Version name The name of the user. String Yes n/a 1.5 Documentation generated ...

User Name Authentication

User Name Authentication User name authentication checks that the user name is valid. Version Available from version 1.5 Examples The following example shows how this user definition ...

User Password Authentication

User Password Authentication User password authentication checks that the user name and password combination is valid. Version Available from version 1.5 Examples The following example shows how ...

User Permission

User Permission Defines the permissions for a user. Version Available from version 1.5 Examples Configuration Elements Element Description Type ...

UserFilter

UserFilter The UserFilter can be used to filter modifications on the basis of the username that committed the changes. Version Available from version 1.0 Configuration Elements Element Description Type Required Default Version names The user names to filter. String array Yes ...

Using CruiseControl.NET with AccuRev

Using CruiseControl.NET with AccuRev CruiseControl.NET has the following integration with AccuRev, Inc.'s http://www.accurev.com AccuRev http://www.accurev.com/accurev.html source control system: (/) Modification Checking via polling (/) Automatic Source Updates (/) Automatic labelling on success Setting up ...

Using CruiseControl.NET with Alienbrain

See Alienbrain Source Control Block

Using CruiseControl.NET with Ant

following sections show you how to setup CruiseControl.NET to build a project using Ant http://ant.apache.org/ as its build tool. This page was written testing against Ant version 1.6.5 . Setting up the Build Server At the present time, CruiseControl.NET ...

Using CruiseControl.NET with CppUnit

Maybe it is not "correct way". But for me it really works. I used CppUnit 1.12.0 First Server... Server Tasks In and .bat file for launching tests. It is required that this but file first delete privious results. Than launch tests and using XmlOutputter ...

Using CruiseControl.NET with CVS

CruiseControl.NET has the following integration with CVS: (/) Modification Checking via polling (/) Automatic Source Updates (/) Automatic Source Checkout (/) Automatic labelling on success (/) Web Integration with ViewCVS Setting up a CVS project for use with CruiseControl.NET Make a note of the full ...

Using CruiseControl.NET with FitNesse

Running FitNesse http://fitnesse.org tests as part of your build process Use the TestRunner http://fitnesse.org/FitNesse.DotNet.DotNetTestRunner which comes as part of the standard fitnesse distribution to run all the fitnesse tests and generate the results. You will need to use the Using CruiseControl.NET with FxCop

Run FxCop as part of your integration Run FxCop as part of your NAnt build In order to get the results of FxCop included in the CruiseControl.NET build results, you will need to include a call to FxCopCmd.exe in your NAnt build file. We recommend ...

Using CruiseControl.NET with Gendarme

Run Mono's Gendarme as part of your integration Gendarme is a extensible rulebased tool to find problems in .NET applications and libraries. Gendarme inspects programs and libraries that contain code in ECMA CIL format (Mono and .NET) and looks for common problems with the code ...

Using CruiseControl.NET with Git

See Git Source Control Block

Using CruiseControl.NET with InstallShield

From the perspective of CruiseControl.NET, InstallShield is just another application, which can be run directly with the exec task or indirectly via NAnt or MSBuild. For many people, the hard part is just learning how to invoke InstallShield from the command line. The following ...

Using CruiseControl.NET with MBUnit

process of getting MBUnit working with CCNet is similar to that of the other external tools. Check out the Simian Using CruiseControl.NET with Simian page for an example. Check Andrew Stopford's blog for more info: http://weblogs.asp.net/astopford

Using CruiseControl.NET with MKS Source Integrity

See MKS Source Integrity Source Control Block for details on integrating CruiseControl.NET with MKS Source Integrity

Using CruiseControl.NET with Mono

CruiseControl.NET 1.1 and later works with recent versions of Mono (1.1.x). There are currently a couple of path separator issues (described in this issue http://jira.public.thoughtworks.org/browse/CCNET583) that will be resolved before the next release. Attached momaoutput.html is a copy of the Mono Migration Analyzer http://www.monoproject.com ...

Using CruiseControl.NET with MSBuild

CruiseControl.NET includes an MSBuild Task to integrate MSBuild (.NET 2.0) projects. The MSBuild Task page is the reference for the task, so that will always contain the most uptodate documentation, but this page acts as a tutorial. Decide what to build Normally, you'll want ...

Using CruiseControl.NET with MSTest

Integrating MSTest into your build You can use MSTest.exe to execute your MSTest unit tests from the commandline. You can find a list of the MSTest.exe commandline options here http://msdn2.microsoft.com/enus/library/ms182489. You will need to using ...

Using CruiseControl.NET with NAnt

See the NAnt Task for common use. You may also want to know How to force a CCNet build from a NAnt script

Using CruiseControl.NET with NCover

page shows how you can integrate NCover, a code coverage tool, with NUnit into your CruiseControl .NET build for test coverage purpose. NCover is a code coverage analysis tool and it is designed to work with compiled shipping code. There are several different ...

Using CruiseControl.NET with NDepend

Run NDepend as part of your integration Initial NDepend setup In order to get the results of NDepend included in the CruiseControl.NET build results, you will need to setup a NDepend project file that includes information about which Assemblies to analyse and which types ...

Using CruiseControl.NET with NUnit

Integrating NUnit into your build in the CruiseControl.NET Server The typical way to integrate the CruiseControl.NET Server with NUnit is to run NUnit as part of your Build Process Builder Blocks. This is the recommended mechanism since it means developers are using a build process closer to the integration ...

Using CruiseControl.NET with other applications

CruiseControl.NET is designed to work with a variety applications in several groups. The following pages tell you how to do this. Source Control Systems Using CruiseControl.NET with AccuRev Using CruiseControl.NET with Alienbrain Using CruiseControl.NET with CVS Using CruiseControl.NET with Subversion Using CruiseControl.NET ...

Using CruiseControl.NET with Other Build Tools

See Executable Task

Using CruiseControl.NET with PartCover

What is PartCover? PartCover is a tool to calculate unit test code coverage. Sure many people knows NCover, which has been extensively used to calculate code coverage in combination with cruisecontrol.net, PartCover does just the same with the only difference ...

Using CruiseControl.NET with Perforce

See Perforce Source Control Block

Using CruiseControl.NET with PVCS

See PVCS Source Control Block

Using CruiseControl.NET with Rational ClearCase

See Rational ClearCase Source Control Block

Using CruiseControl.NET with Seapine Surround

See Seapine Surround Source Control Block

Using CruiseControl.NET with Simian

Run Simian as part of your integration Run Simian as part of your NAnt build In order to get the results of Simian included in the CruiseControl.NET build results, you will need to include a call to simian.exe in your NAnt build file. We recommend ...

Using CruiseControl.NET with SourceGear Vault

See SourceGear Vault Source Control Block

Using CruiseControl.NET with StarTeam

See StarTeam Source Control Block

Using CruiseControl.NET with Subversion

See Subversion Source Control Block

Using CruiseControl.NET with Telelogic Synergy

See the Telelogic Synergy source control configuration block

Using CruiseControl.NET with Vil

page shows how you can integrate Vil http://www.1bot.com/, a code metrics tool, into your CruiseControl .NET build. This update was provided by Wojciech Zimirski. Run Vil as part of your integration After downloading and installing VIL, you ...

Using CruiseControl.NET with Visual Source Safe

See Visual Source Safe Source Control Block

Using CruiseControl.NET with Visual Studio .NET

See Visual Studio Task

Using the Web Dashboard

Assuming you've set everything up OK, you should be able to view the default page in the Virtual Directory you setup for your web application. The default page on CCNetLive is at http://ccnetlive.thoughtworks.com/ccnet/, and you should see something similar ...

View All Builds Project Plugin The View All Builds Project Plugin lists all available builds for a project. Version Available from version 1.0 Examples Configuration Elements There is no configuration for this plugin. Documentation generated on Friday, 8 ...

View Configuration Project Plugin The View Configuration Project Plugin shows the configuration for a project. Version Available from version 1.3.0 Examples Configuration Elements Element Description Type Required Default Version hidePasswords ...

ViewCVS URL Builder Generates a URL for ViewCVS. Version Available from version 1.0 Examples http://jira.public.thoughtworks.org/browse/CCNET Configuration Elements Element Description Type Required Default Version ...

plugin shows the current state of the queues on the build server. Example Configuration Elements There is no configuration for this plugin

VSS Configuration Example For Visual Source Safe you must specify the executable, project, username and password. You may also specify the SSDIR. If SSDIR is not set the default or the SSDIR environment variable will be used. Version Available from version 1.0 ...

Visual Studio Task Most complex build processes use NAnt Task or MSBuild Task to script the build. However, for simple projects that just need to build a Visual Studio.NET solution, the Visual Studio task provides an easier ...

Because of dependencies on Team Foundation assemblies which cannot be shipped with the Cruise Control source, this plugin is available as a standalone plugin from the TFS CCNET Plugin http://www.codeplex.com/TFSCCNetPlugin/ project on CodePlex. The plugin works with Team Foundation Server 2005 ...

VSTS Team Foundation Server Source Control Block Source Control Plugin for CruiseControl.NET that talks to VSTS Team Foundation Server. Version Available from version 1.5 Examples http://vstsb2:8080

CCNet Web Dashboard Application is used for reporting a wide range of information. At one end of the scale it reports summary details of all projects in your organisation and at the other it can give specific metric output for any specific build. Features of the Web ...

WebSVN URL Builder Generates a URL for WebSVN. Version Available from version 1.4 Examples http://jira.public.thoughtworks.org/browse/CCNET Configuration Elements Element Description Type Required Default Version ...

Download Documentation FAQ Examples Support Project Details ThoughtWorks Site Index Issues http://jira.public.thoughtworks.org/browse/CCNET CruiseControl.NET is an Automated Continuous Integration server, implemented using the Microsoft .NET Framework. \\ If you're new to CruiseControl.NET, you ...

practice of continuous integration represents a fundamental shift in the process of building software. It takes integration, commonly an infrequent and painful exercise, and makes it a simple, core part of a developer's daily activities. Integrating continuously makes integration a part of the natural rhythm ...

CruiseControl.NET Server CruiseControl.NET (CCNet) consists of a suite of applications, but at its core is the CruiseControl.NET Server which is an automated integration server. The Server automates the integration process by monitoring the team's source control repository directly. Every time a developer commits ...

CruiseControl.NET is based on the original Java implementation of CruiseControl http://cruisecontrol.sourceforge.net, we are frequently asked why we bothered to reimplement it for the .NET platform. Surely, it would be easier to just use the NAnt builder in CruiseControl to handle the build process for .NET projects ...

Wildcards in User Names It is possible to use wild cards for the user name. To use a wild card simply use an ''. Wild cards can either be the whole name (in which case everything will be matched) or just part of a name. Some examples ...

XML File Audit Logger Sends audit logging information to a file. The information will be stored in an XML format. Version Available from version 1.5 Examples Configuration Elements Element Description Type ...

XML File Audit Reader Reads audit logging information from a file. The information must be stored in an XML format. This reader handles reading audit information that has been written by the XML File Audit Logger. Version Available ...

XML Log Publisher The Xml Log Publisher is used to create the log files used by the CruiseControl.NET Web Dashboard, so if you don't define an section the Dashboard will not function correctly. You should place the in the section ...

XSL Transforms are used by the Web Dashboard to generate reports from build log files, for example using the Build Report Build Plugin or XSL Report Build Plugin. The following XSL Transforms are available, saved in the file {{xsl}}/{{transformName}}{{.xsl ...

Xsl Report Build Plugin shows detailed output for a specific build using a configured XSL Transform. See XSL Files for a list of available XSL transforms and how to use your own transforms. This is a Project Configurable Build Plugin. Example ...

CCNET packaged plugin. All required info could be found at CCNETCOMM XSL Report Project http://confluence.public.thoughtworks.org/display/CCNETCOMM/XSLReportProject