TeamCity On-Premises 2021.2 Help

Configuring Agent Requirements

By specifying Agent Requirements for build configuration you can control on which agents the configuration will be run.

To add a requirement, click the corresponding link and specify the following options:

Parameter type

Specify the type of the parameter: system property, environment variable, or configuration parameter. For details on the types of parameters available in TeamCity, refer to this section.

Parameter name

Specify the mandatory property or environment variable name.

Condition

Choose an appropriate condition for the new requirement. See how conditions work in TeamCity.

Value

Is shown for the conditions which require the value to match against (like "equals"). The value supports parameters resolution, but only the parameters which do not originate from the agents are supported in the field.

Note that the Agent Requirements page also displays the list of compatible and incompatible build agents for this build configuration, which is updated each time you modify the list of requirements. Possible reasons why build agent may be incompatible with this build configuration are described separately.

Last modified: 26 April 2022