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:
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 Configuring Build Parameters section.
Specify the mandatory property or environment variable name.
Select condition from the drop-down menu.
Some notes on how conditions work:
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 the 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: compares versions of a software. Multiple formats are supported including "."-delimited, leading zeroes, common suffixes like "beta", "EAP". If the version number contains alphabetic characters, they are compared as well, for instance, 1.1e < 1.1g.
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: 28 April 2020