|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.|
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:
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.
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: