7.Agent Requirements

Documentation Index

Agent Requirements

Administration > <build configuration> Agent requirements

Use this page to specify the required system properties and environment variables that  build agents 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  Edit Requirement dialog.
delete Click this link to delete selected requirement.
Add requirement Click this link to create a new requirement for a property in the Add Requirement dialog.

Requirements for environment variables

Option Description
edit
Click this link to change selected requirement in the  Edit Requirement dialog.
delete
Click this link to delete selected requirement.
Add requirement
Click this link to create a new requirement for a property in the Add Requirement 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.
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.
  • (since TeamCity 2.1) matches, does not match: This condition will be true if specified property matches/does not match the specified Regular Expression pattern.
Value Is shown for some conditions that require value, e.g. 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 described separately.

Labels