1.General Settings

Name

Edit the name of the build configuration. The build configuration name should not contain special characters.

Description

Enter an optional description.

Build number format

Specify the Build Numbering format.

Build counter

Specify the counter to be used in the build numbering. Each build increases the build counter by 1.

Reset counter

Specify the starting number. Use the Reset counter link to reset counter value to 1.

Artifact paths

Use this field to specify directories containing artifacts or file names as a comma-separated string. If a directory is specified its contents will be uploaded to the server.

Fail build if

Specify how TeamCity should fail builds. The possible options are:

• build process exit code is not zero: Check this option to mark the build as failed if the build process doesn't exit successfully.

• at least one test failed: Check this option to mark the build as failed if the build fails at least one test. If this option is not checked, the build can be marked successful even if it fails to pass a number of tests.

• an error message is logged by build runner: Check this option to mark the build as failed if the build runner reports an error while building.

• it runs longer than ... minutes: Check this option and enter a value in minutes to enable time control on the build. If the specified amount of time is exceeded, the build is automatically canceled. This option helps to deal with builds that hang and maintains agent efficiency.

Build options

Specify additional options for the builds of this build configuration. The available options are:

• Enable hanging build detection:

• Enable status widget: Check this option to enable retrieving the status of the latest build to an external web page. See Enabling the Status Widget for Build Configurations.

• Limit the number of simultaneously running builds: Specify the number of builds of the same configuration that can run simultaneously on all agents. This option helps avoid the situation, when all of the agents are busy with the builds of a single project. Enter 0 to allow an unlimited number of builds to run simultaneously.