Using the CodePlex sourcecontrol block for CruiseControl.NET
If you are using CruiseControl.NET for automated builds you may
download and use our sourcecontrol block for CodePlex. CruiseControl.NET uses the sourcecontrol block to determine when a change has occurred and to download the latest version of the source code. For more information on CruiseControl.NET read the
documentation.
Installing the CodePlex sourcecontrol block
Extract the .zip file into your CruiseControl.NET server folder (i.e.
c:\program files\CruiseControl.NET\server). The sourcecontrol block requires the following 3 files:
- CodePlex.WebServices.Client.dll
- CodePlex.WebServices.Client.XmlSerializers.dll
- ccnet.codeplex.plugin.dll
Please Note:
The CodePlex sourcecontrol block requires the Microsoft Visual J# Version 2.0 Redistributable. This is normally installed with Microsoft Visual Studio or can be downloaded and installed from here.
Configuring the CodePlex sourcecontrol block
To use the CodePlex sourcecontrol block you need to add a
<sourcecontrol> block to your
ccnet.config file.
Example
sourcecontrol block:
<sourcecontrol type="codeplex">
<project>MyProjectName</project>
</sourcecontrol>
The sourcecontrol block can also monitor/download a subset of your source code. Use the
projectPath element to specify the path.
Example
sourcecontrol block with
projectPath:
<sourcecontrol type="codeplex">
<project>MyProjectName</project>
<projectPath>/trunk/SourceCode</projectPath>
</sourcecontrol>
Example ccnet.config with CodePlex
sourcecontrol block:
<cruisecontrol>
<project>
<name>MyProject</name>
<triggers>
<intervalTrigger seconds="60"/>
</triggers>
<workingDirectory>C:\Source\MyProject</workingDirectory>
<sourcecontrol type="codeplex">
<project>MyProjectName</project>
<projectPath>/trunk/SourceCode</projectPath>
</sourcecontrol>
<tasks>
<exec>
<executable>build.bat</executable>
<baseDirectory>D:\Source\MyProject</baseDirectory>
<buildArgs>CCNET</buildArgs>
<buildTimeoutSeconds>300</buildTimeoutSeconds>
</exec>
</tasks>
</project>
</cruisecontrol>
Configuration Elements:
Node | Description | Type | Required | Default |
project | The name of the project | string | true | null |
projectPath | The path of the project to monitor/download | string | false | / |
workingDirectory | The root folder where the latest source will be retrieved from CodePlex | string | false | CCNet project working directory |