7.Agent Requirements

Skip to end of metadata
Go to start of metadata
You are viewing documentation of TeamCity 4.x, which is not the most recent released version of TeamCity. Please refer to the listing to choose another version.
Search

Searching TeamCity 4.x Documentation

Table of Contents

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.
  • matches, does not match: This condition will be true if 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: These conditions compare versions of a software. Multiple formats are supported including "."-delimited, leading zeroes, common suffixes like "beta", "EAP".
Value Is shown for some conditions that require value, for example: 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.



See Also:

Labels:

agent agent Delete
requirement requirement Delete
compatible compatible Delete
implicit implicit Delete
ui ui Delete
admin admin Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.