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

Agent Requirements

Last modified: 20 April 2023

Administration > <project> Agent requirements

Use this page to specify Basic Concepts to the system properties and environment variables that the Basic Concepts should 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 the list of frequently used requirements in the dialog, where you can select the desired requirements and add them to your list. These requirements apply to the system properties.

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.

Value

Is shown for some conditions that require value, e.g. equals

Save

Preserve changes and close the dialog.

tip

Some notes on how conditions work:

  • equals: if empty value is specified then the condition checks that specified property exists and its value is empty string; if not empty value is specified the condition checks that there exists property with specified value.

  • does not equal: if empty value is specified the condition checks that property exists and is NOT empty; if not empty value is specified the condition checks that property does not exist or its value does not equal the specified value.

  • does not contain: evaluates to true if specified property does not exist or does not contain specified string.

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

  • (since 2.1) matches, does not match: evaluates to true if specified property matches/does not match to specified Regular Expression pattern.

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 Basic Concepts.