TeamCity
 
3.0
You are viewing the documentation for an earlier version of TeamCity.
  1. TeamCity Documentation
  2. UI Reference
  3. Administration
  4. Create Edit Build Configuration
  5. 3.Build Runners
  6. Maven2

Maven2

Last modified: 20 April 2023

This page contains reference information about the Maven2 Build Runner fields.

Option

Description

Build runner

Select Maven2 from the drop-down list.

Goals

In the Goals field, you need to specify the sequence of Maven goals that you want TeamCity to execute. Some Maven goals can use version control systems, and, thus, they may become incompatible with some VCS checkout modes. If you want TeamCity to execute such goal:

  • Select "Automatically on agent" for the VCS checkout mode on the Version Control Settings page. This makes the version control system available to a goal execution software.

Path to a POM file

Specify path to the POM file relative to the Build Checkout Directory. By default, the property contains a pom.xml file. If you leave this field blank, the same value is put in this field. The path may also point to a subdirectory, and as such <subdirectory>/pom.xml is used.

Maven home path

Use this optional parameter to specify path to the distributive of your custom Maven. You do not need to specify this parameter, if you are going to use the Maven distributive that comes bundled with TeamCity (Maven 2.0.8).

Additional Maven command line parameters

Specify the list of command line parameters. Note that -h, -v, -B, -s, -f are ignored.

Artifact Paths

Use this field to specify directories containing Build Artifact or file names as a comma-separated string. If a directory is specified its contents will be uploaded to the server. In version 3.1 this field is located on the 1.General Settings page.

User Settings Path

The path to an alternative user settings file. It is equivalent to Maven's command line option -s or --settings.

JDK Home Path

The path to JDK Home is read from the *JAVA_HOME* environment variable or *JDK home* specified on the build agent if you leave this field empty. If these two values are not specified as well, TeamCity uses the JDK home on which the build agent process is started.

JVM Command Line Parameters

Specify JVM command line parameters, for example, maximum heap size or parameters enabling remote debugging. These values are passed by the JVM used to run your build. Example:

-Xmx512m -Xms256m

Build Working Directory

Specify the Build Checkout Directory. Note that the build working directory correlates with pom.xml file.