Agent Pools

Skip to end of metadata
Go to start of metadata
Search

Searching TeamCity 7.x Documentation

Table of Contents

Instead of having one common set of agents you can break it into separate groups called agent pools. A pool is a named set of agents to which you can assign projects:

  • An agent can belong to one pool only.
  • A project can use several pools for its builds.

Project builds can be run only on build agents from pools assigned to the project. By default, all newly authorized agents are included into Default pool.
With the help of agent pools you can bind specific agents to specific projects. Also with agent pools it is easier to calculate required agents capacity.

You can find all agent pools configured in TeamCity at Agents | Pools tab. To be able to add\edit pools you need to have "Manage agent pools" permission. In default TeamCity per-project authorization mode following users have this permission: system administrator, agent manager and project administrator.

To create a new agent pool you need only to specify its name; to populate it with agents, just click "Assign agents" and select them from a list. Since an agent can belong to one pool only, assigning it to a pool will remove it from its previous pool. If this can possibly cause compatibility problems TeamCity will give a warning.

When you have configured agent pools, you can:

  • Filter build queue by pools.
  • Group by pool on Agent Matrix and Agent Statistics pages.



See also:

Concepts: Agent Requirements
Administrator's Guide: Viewing Agents Workload

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.