TeamCity
 
4.0
You are viewing the documentation for an earlier version of TeamCity.
  1. TeamCity Documentation
  2. TeamCity Reference
  3. UI Reference
  4. Administration
  5. Create Edit Build Configuration
  6. 7.Agent Requirements

7.Agent Requirements

Last modified: 20 April 2023

Administration > <build configuration> Agent requirements

Use this page to specify the Agent Requirements system properties and environment variables that Build Agent must meet in order to be able to run the builds of the current build configuration.

Option

Description

Frequently used requirements

Click this link to view a dialog with a list of frequently used requirements. You can select the desired requirements and add them to your list.

Requirements for system properties



Option

Description

edit

Click this link to change selected requirement in the dialog.

delete

Click this link to delete selected requirement.

Add requirement

Click this link to create a new requirement for a property in the dialog.

Requirements for environment variables



Option

Description

edit

Click this link to change selected requirement in the dialog.

delete

Click this link to delete selected requirement.

Add requirement

Click this link to create a new requirement for a property in the dialog.

Add / Edit Requirement dialog



Option

Description

Property or environment variable name

Specify the mandatory property or environment variable name.

Condition

Select condition from the drop-down list.

tip

  • equals: This condition will be true if an empty value is specified and the specified property exists and its value is an empty string; or if a value is specified and the property exists with the specified value.

  • does not equal: This condition is true if an empty value is specified and the property exists and its value is NOT empty; or if a specific value is specified and either the property doesn't exist, or the property exists and its value does not equal the specified value.

  • does not contain: This condition will be true if the specified property either does not exist or exists and does not contain the specified string.

  • is more than, is not more than, is less than, is not less than: These conditions only work with numbers.

  • matches, does not match: This condition will be true if specified property matches/does not match the specified Regular Expression pattern.

  • version is more than, version is not more than, version is less than, version is not less than: These conditions compare versions of a software. Multiple formats are supported including "."-delimited, leading zeroes, common suffixes like "beta", "EAP".

Value

Is shown for some conditions that require value, for example: equals

Save

Preserve changes and close the dialog.

Agents compatibility



This section shows the list of compatible and incompatible build agents for this build configuration. Possible reasons why build agent may be incompatible with this build configuration are Agent Requirements.