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

请注意,如果您将项目从所有现有的代理池中解绑,您将无法运行此项目的构建配置(除非它们完全由 无代理构建步骤 组成)。
最喜欢的池子
您可以点击泳池名称旁边的星形图标来标记它。

喜欢的池被固定在侧边导航面板的顶部。 您还可以在 "FAVORITES" 部分查看所有喜欢的资源池中的所有代理和云镜像。

收藏的代理池是针对用户的,这意味着每个 TeamCity 用户可以拥有自己的收藏代理池集合。