TeamCity
 
You are viewing the documentation for an earlier version of TeamCity.

Creating and Editing Build Configurations

Last modified: 20 April 2023

To learn more about build configurations in TeamCity, refer to the Build Configuration page. TeamCity provides several ways to create new build configuration for a project. You can:

Creating New Build Configuration



  1. On the Administration page, locate the desired project in the list and click Create build configuration link which is available right after the list of project's configurations. Alternatively, you can find this link on the project settings page.

  2. Specify Configuring General Settings for the build configuration, then click the VCS settings button.

  3. Configuring VCS Settings, then click the Add Build Step button.

  4. On the New Build Step page, configure first build step - select the desired build runner from the drop-down list, and Configuring Build Steps. Click Save. You can add as many build steps as you need within one build configuration. Note, that they will be executed sequentially. In the end, the build gets merged status and the output goes into the same build log. If some step fails, the rest are not executed.

  5. Additionally, configure Configuring Build Triggers, Configuring Dependencies, Configuring Build Parameters and Configuring Agent Requirements.

Creating Build Configuration Template



To learn more about build configuration templates, refer to the Build Configuration Template page. Creating a build configuration template is similar to creating a new configuration. On the Project settings page click the Create template link and proceed with configuring Configuring General Settings, Configuring VCS Settings and Configuring Build Steps.

Creating Build Configuration From Template



To create a build configuration based on the template, on the Project settings page locate the desired template and click Edit. Then, click the Create Build Configuration From Template button and specify the name for new configuration. The settings set up in the template cannot be edited in a configuration created from this template. If you want to change them, modify them in the template's settings. However, note that this will affect all configurations based on this template.

Creating Maven Build Configuration



To create new build configuration automatically from the POM.xml file, on the Project settings page click the Create Maven build configuration link and specify the following options:

When the new Maven configuration is created, any further configuring is similar to editing an ordinary build configuration.

Refer to Maven documentation on the SCM Implementation for the following supported version control systems:

Maven SCM URL Format



The general format for a SCM Url is

scm:<scm_provider><delimiter><provider_specific_part>

As delimiter you can use either colon ':' or, if you use a colon for one of the variables (for example, a windows path), you can use a pipe '|'.

For more information, please refer to the official Maven SCM documentation page.

In TeamCity you can use simplified SCM URL format:

  • If the protocol defined in the provider-specific part unambiguously identifies the SCM-provider, then the scm:<scm_provider>: prefix of the URL can be omitted. For instance, the "scm:starteam:starteam://host.com/trunk/pom.xml" URL will valid in the "starteam://host.com/trunk/pom.xml" format. In any other case, for example if HTTP protocol is used for SVN repository, then the SCM-provider must be specified explicitly: svn:http://svn.host.com/trunk/project/pom.xml

  • The scm prefix can be omitted, or can be replaced with vcs prefix.

Examples of the SCM URL for Supported SCM Providers



The following URLs will be considered as equal:

  • Subversion: scm:svn:svn://svn.company.com/project/trunk/pom.xml or vcs:svn:svn://svn.company.com/project/trunk/pom.xml or svn:svn://svn.company.com/project/trunk/pom.xml or svn://svn.company.com/project/trunk/pom.xml

    note

  • StarTeam: scm:starteam:starteam://host.com/project/view/pom.xml or starteam:starteam://host.com/project/view/pom.xml or starteam://host.com/project/view/pom.xml

  • Perforce: scm:perforce:user@//main/myproject/pom.xml or perforce:user@//main/myproject/pom.xml