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

Create Maven Build Configuration

Last modified: 20 April 2023

Administration > <project> > Create Maven build configuration

Create Maven build configuration dialog allows creating new build configuration automatically from the specified POM.xml file.

From the provided POM file TeamCity reads the name and the VCS root URL parameters for the new build configuration. For non-Maven projects, if there's no VCS root URL provided in the pom.xml, then the process will be aborted with error.

Create maven configuration

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

View 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