TeamCity On-Premises
 
Get TeamCity On-Premises

Configuring Agent Pools

Edit pageLast modified: 28 November 2024

Instead of having one common set of build agents, you can break them 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 multiple pools for its builds.

The number of agents authorized by the TeamCity server is limited by the number of agent licenses. By default, all newly authorized agents are included into the Default pool.

With the help of agent pools you can bind specific agents to specific projects. Project builds can be run only on build agents from the pools assigned to the project. Besides, using agent pools makes it easier to monitor the required agents' capacity.

Using agent pools allows:

  • Binding specific agents to specific projects: project builds can be run only on build agents from the pools assigned to the project.

  • Filtering the build queue by pools.

  • Use grouping by pool on the Agent Matrix and Agent Statistics pages.

  • Monitoring the required agents' capacity.