配置 代理池
而不是拥有一套公用的 构建代理 ，您可以将它们分解成为称之为 代理池 的单独组。 池是一个命名的代理集，您可以向其分配项目。
一个代理只能属于 一个池。
一个项目可以使用 多个池 来构建。
由 TeamCity 服务器授权的代理数量受到 agent licenses的数量限制。 默认情况下，所有新授权的代理都被包含在 Default pool 中。
借助代理池，您可以将特定的代理绑定到特定的项目。 项目构建只能在分配给项目的构建代理池中运行。 此外，使用代理池可以更便于监控所需代理的容量。
使用代理池允许：
将特定代理绑定到特定项目：项目构建只能在分配给该项目的池中的构建代理上运行。
按照池对构建队列进行过滤。
在 Agent Matrix 和 Agent Statistics 页面上使用按池分组。
监控所需代理的容量。
note
您可以使用 TeamCity 的 REST API 来访问代理池功能。
要能够添加/删除池并设置池中的代理最大数量，您需要拥有“ 管理代理池 ”权限。 默认情况下，这些权限授予系统管理员和代理管理器 角色。
将项目和代理分配和取消分配给/从池中是受到 "更改与项目关联的代理池 " 权限的限制，该权限默认是项目管理员角色的一部分。 只有当用户拥有对 所有项目的" 更改与项目相关的代理池"权限，同时这些项目与受操作影响的 所有池相关时，用户方可对池进行操作。
请参阅相关的 代理管理权限。
您可以在 支持人员 页面上管理构建代理，该页面的链接位于 UI 页眉中。 如果您使用的是经典 UI 模式，请注意其导航系统与本文中描述的不同：池在 代理 | 池 选项卡中管理。
Agents 侧栏允许在现有的 agent pools 之间进行导航，并实时显示 agent 的状态。
要创建一个新池，请单击侧边栏中的 + 并输入其名称。
默认情况下，一个池包含无限数量的代理。 您可以设定池中代理的最大数量（不适用于 Default 池）。 如果达到了代理的最大数量，TeamCity 将不允许向此资源池添加任何新的代理。 这包括将代理从其他池中移动以及云代理的自动授权。 如果目标池已满，新的云代理将不会启动。
要查看特定池或其嵌套的 agent 的详细信息，请在侧边栏中点击其名称。
要向池中添加代理，请单击侧边栏中的目标池，然后在 支持人员 选项卡中单击 分配代理 ，并从列表中选择所需的代理。 由于代理只能属于一个池，因此将其指派到池中将使其从之前的池中移除。 如果 TeamCity 检测到此操作可能会导致兼容性问题，它将显示相应的警告。 将代理从自定义池中移除将使其返回到 Default 池。
要将云代理分配给一个池，您需要在 agent cloud profile 的云镜像细节中进行配置。 请注意，当前项目的所有云配置文件中的代理会自动合并到 项目池中。
只有在 <Root> 项目中配置的云代理镜像可以使用 分配代理 进行移动。
项目"选项卡允许您指定您的项目可以利用哪些代理池。
浏览项目列表，检查哪些项目可以在属于当前选择的池中的代理上运行其构建。
单击 分配项目 按钮以允许所需项目使用此池。
单击 解除关联 按钮以阻止目标项目使用此池。
请注意，如果您将项目从所有现有的代理池中解绑，您将无法运行此项目的构建配置（除非它们完全由 无代理构建步骤 组成）。
您可以点击泳池名称旁边的星形图标来标记它。
喜欢的池被固定在侧边导航面板的顶部。 您还可以在 "FAVORITES" 部分查看所有喜欢的资源池中的所有代理和云镜像。
收藏的代理池是针对用户的，这意味着每个 TeamCity 用户可以拥有自己的收藏代理池集合。