Icon

You are viewing the documentation of TeamCity 10.x and 2017.x, which is not the most recently released version of TeamCity.
View this page in TeamCity 2018.1 documentation or refer to the listing to choose the documentation corresponding to your TeamCity version.

 
Skip to end of metadata
Go to start of metadata

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

To add a requirement, click 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, please refer to Configuring Build Parameters section.

Parameter Name

Specify the mandatory property or environment variable name.

Condition

Select condition from the drop-down list.

Some notes on how conditions work:

Icon


  • 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.

Value

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


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.



See also:

  • No labels

1 Comment

  1. Some additional details on "version is more than" condition.