TeamCity 8.0 Help

Configuring VCS Settings

A Version Control System (VCS) is a system for tracking the revisions of the project source files. It is also known as SCM (source code management) or a revision control system. The following VCSs are supported by TeamCity out-of-the-box: ClearCase, CVS, Git (JetBrains), Mercurial, Perforce, StarTeam, Subversion, Team Foundation Server, SourceGear Vault, Visual SourceSafe.

Setting up VCS parameters is one of the mandatory steps during creating a build configuration in TeamCity. On the 2nd page of the build configuration (Version Control Settings page) do the following :

  1. Attach an existing Configuring VCS Roots to your build configuration, or create a new one to be attached. This is the main part of VCS parameters setup; a VCS Root is a description of a version control system where project sources are located. Learn more about VCS Roots and configuration details Configuring VCS Roots.

  2. When VCS root is attached, specify the VCS Checkout Rules for it — specifying checkout rules provides advanced possibilities to control sources checkout. With the rules you can exclude and/or map paths to a different location on the Build Agent during checkout.

  3. Define how project sources reach an agent via VCS Checkout Mode.

  4. Additionally, you can add a label into the version control system for the sources used for a particular build by means of VCS Labeling feature. Since TeamCity 8.1, VCS Labeling can be Adding Build Features.

Last modified: 20 April 2023