CruiseControl.NET : Visual Studio Team Foundation Server Plugin
This page last changed on Jun 06, 2006 by martinwoodward.

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 VSTSPlugins project on Sourceforge. The plugin has been recently updated to work with version 1.0 of the Team Foundation Server.

Visual Studio Team Foundation Server (VSTS) Configuration Examples

Minimal example: 

<sourcecontrol type="vsts">
  <server>my_team_foundation_server</server>
  <project>$/Foobar</project>
  <workingDirectory>c:\projects\Foobar</workingDirectory>
</sourcecontrol>

Full example: 

<sourcecontrol type="vsts" autoGetSource="true" applyLabel="true">
  <server>http://my_team_foundation_server:8080</server>
  <username>my_user</username>
  <password>my_password</password>
  <domain>my_domain</domain>
  <project>$/Foobar</project>
  <workingDirectory>c:\projects\Foobar</workingDirectory>
  <cleanCopy>false</cleanCopy>
  <workspace>my_workspace_name</workspace>
  <deleteWorkspace>false</workspace>
</sourcecontrol>

Configuration Elements:

Node Description Type Required Default
server The name or URL of the team foundation server. For example 
http://vstsb3:8080

or 
vstsb3

if it has already been registered on the machine.

string true null
username Username that CCNet should use to authenticate with Team Foundation Server string false * See Below
password Password for the Team Foundation user string false * See Below
domain Domain for the Team Foundation user string false * See Below
autoGetSource Specifies if CCNet should automatically retrieve the latest version of the source from the repository bool false false
applyLabel Specifies if CCNet should apply the build label to the repository bool false false
workingDirectory The root folder where the latest source will retrieved the Team Foundation Server. This path can either be absolute or it can be relative to the CCNet project working directory. string false CCNet project working directory
cleanCopy Determines is the working directory and all its contents should be deleted before the latest version of the source is downloaded bool false false
workspace The name of the Workspace under which the source should be retrieved. This workspace is created at the start of a download, and deleted at the end. You can normally omit the property unless you want to name a workspace to avoid conflicts on the server (i.e. when you have multiple projects on one server talking to a Team Foundation Server) string false "CCNET"
deleteWorkspace Determines if the workspace should be deleted after source is downloaded using the autoGetSource flag. It is much more efficient to leave the workspace because that way the TFS server can remember the state of the files on the CruiseControl.NET server and only send files that have changed or inform the server of deleted / renamed files. bool false false

*: If no credential is supplied in the config, then the credential of the user that the CruiseControl service runs as will be used automatically. This user must have permission to read and label the Team Foundation Server Source Control repository.

Installing the Plugin

For latest instructions see the VSTSPlugins Documentation.

Talking to CodePlex

Microsoft have recently launched CodePlex, a developer community site that uses Team Foundation Server for version control and work item tracking. The following example demonstrates how to configure the source control block to talk to CodePlex. Please note that your username should be suffixed with "_cp".

<sourcecontrol type="vsts" autoGetSource="true" applyLabel="false">
  <server>https://tfs01.codeplex.com</server>
  <username>USERNAME_cp</username>
  <password>PASSWORD</password>
  <domain>SND.RNO.GBL</domain>
  <project>$/Foobar</project>
  <workingDirectory>c:\source\Foobar</workingDirectory>
</sourcecontrol>

NAnt VSTS Tasks

The VSTSPlugins project are working on some NANT tasks for VSTS that will be available at VSTSPlugins.
Document generated by Confluence on Jun 21, 2007 10:33