TeamCity 7.0 Help

Ant

Support for Running Parallel Tests

By using the <parallel> tag in your Ant script it is possible to have the JUnit and TestNG tasks run in parallel. TeamCity supports this and should concurrently log the parallel processes correctly.

Ant Runner Settings

Ant Parameters

Option

Description

Path to build.xml file

If you choose the option, you can type the path to a Ant build script file of the project. The path is relative to the project root directory.

Build file content

If you choose this option, click the link Type build file content, and type source code of your custom build file in the text area. Note that the text area is resizeable. Use Hide link to close the text area.

Working directory

Specify the Build Working Directory.

Targets

Use this text field to specify valid Ant targets as a list of space-separated strings. If this field is left empty, default target specified in the build script file will be run.

Ant home path

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

Additional Ant command line parameters

Optionally, specify additional command line parameters as a space-separated list.

Java Parameters

Option

Description

JDK home path

Use this field to specify the path to JDK which should be used to run the build (launch Ant). If the field is left blank, the the value of JAVA_HOME environment variable is used. (Which can come from Build Configuration settings or agent environment or properties). If JAVA_HOME is not found, TeamCity uses Java home of the build agent process itself.

References to parameters can generate an Agent Requirements.

JVM command line parameters

You can specify such JVM command line parameters as, 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

Test parameters

Tests reordering works the following way: TeamCity provides tests that should be run first (test classes), after that when a JUnit task starts, it checks whether it includes these tests. If at least one test is included, TeamCity generates a new fileset containing included tests only and processes it before all other filesets. It also patches other filesets to exclude tests added to the automatically generated fileset. After that JUnit starts and runs as usual.

Option

Description

Reduce test failure feedback time:

Use following two options to instruct TeamCity to run some tests before others.

Run recently failed tests first

If checked, in the first place TeamCity will run tests failed in previous finished or running builds as well as tests having high failure rate (a so called blinking tests)

Run new and modified tests first

If checked, before any other test, TeamCity will run tests added or modified in change lists included in the running build.

Code Coverage

To learn about configuring code coverage options, please refer to the Configuring Java Code Coverage page.

Last modified: 20 April 2023