TeamCity On-Premises 2024.03 Help

配置 代理池

而不是拥有一套公用的 构建代理,您可以将它们分解成为称之为 代理池 的单独组。 池是一个命名的代理集,您可以向其分配项目。

  • 一个代理只能属于 一个池

  • 一个项目可以使用 多个池 来构建。

由 TeamCity 服务器授权的代理数量受到 agent licenses的数量限制。 默认情况下,所有新授权的代理都被包含在 Default pool 中。

借助代理池,您可以将特定的代理绑定到特定的项目。 项目构建只能在分配给项目的构建代理池中运行。 此外,使用代理池可以更便于监控所需代理的容量。

使用代理池允许:

  • 将特定代理绑定到特定项目:项目构建只能在分配给该项目的池中的构建代理上运行。

  • 按照池对构建队列进行过滤。

  • Agent Matrix 和 Agent Statistics 页面上使用按池分组。

  • 监控所需代理的容量。

所需权限

为了能够添加 / 删除池并设置池中代理的最大数量,您需要在默认的 TeamCity 每项目授权模式中为系统管理员和代理经理 角色 授予 "管理代理池"权限。

将项目和代理分配和取消分配给/从池中是受到 "更改与项目关联的代理池 " 权限的限制,该权限默认是项目管理员角色的一部分。 只有当用户拥有对所有项目的"更改与项目相关的代理池"权限,同时这些项目与受操作影响的所有池相关时,用户方可对池进行操作。

请参阅相关的 代理管理权限

管理代理池

您可以在 Agents 页面管理构建代理,该链接位于 UI 头部。 如果您正在使用经典 UI 模式,请注意,它的导航系统与本文中描述的不同:池在 Agents | Pools 标签页进行管理。

Agents 侧栏允许在现有的 agent pools 之间进行导航,并实时显示 agent 的状态。

要创建新的池,点击侧边栏中的 + 并输入其名称。
默认情况下,一个池包含无限数量的代理。 您可以设定池中代理的最大数量(不适用于 Default 池)。 如果达到了代理的最大数量,TeamCity 将不允许向此资源池添加任何新的代理。 这包括将代理从其他池中移动以及云代理的自动授权。 如果目标池已满,新的云代理将不会启动。

要查看特定池或其嵌套的 agent 的详细信息,请在侧边栏中点击其名称。

代理标签页

要向资源池添加代理,点击侧边栏中的目标资源池,然后点击 分配代理代理选项卡中,并从列表中选择所需的代理。 由于代理只能属于一个池,因此将其指派到池中将使其从之前的池中移除。 如果 TeamCity 检测到此操作可能会导致兼容性问题,它将显示相应的警告。 将代理从自定义池中移除将使其返回到 Default 池。

要将云代理分配给一个池,您需要在 agent cloud profile 的云镜像细节中进行配置。 请注意,当前项目的所有云配置文件中的代理自动组合成一个 项目池
只有在 <Root> 项目中配置的云代理镜像才可以使用 分配代理 进行移动。

项目选项卡

项目"选项卡允许您指定您的项目可以利用哪些代理池。

  • 浏览项目列表,检查哪些项目可以在属于当前选择的池中的代理上运行其构建。

  • 点击 指定项目 按钮,以允许所需项目使用此资源池。

  • 点击 Dissociate 按钮,阻止目标项目使用此资源池。

代理池设置页面的项目标签页

请注意,如果您将项目从所有现有的代理池中解绑,您将无法运行此项目的构建配置(除非它们完全由 无代理构建步骤 组成)。

最喜欢的池子

您可以点击泳池名称旁边的星形图标来标记它。

最喜爱的资源池

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

喜爱的池子详细信息

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

最后修改日期: 16日 7月 2024年