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

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\remove pools you need to have "Manage agent pools" permission. In default TeamCity per-project authorization mode following users have this permission: system administrator and agent manager.

Another permission "Change agent pools associated with project" by default granted to project administrator role allows users to assign and un-assign projects and agents to/from pools. User can assign and un-assign projects and agents from pool only if he/she has "Change agent pools associated with project" for all projects associated with pool.

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