TeamCity On-Premises 2024.03 Help

构建代理配置和维护

查看 TeamCity 代理详情

TeamCity 网络用户界面的 Agents 页面为您提供了关于 TeamCity 代理的全面信息。 根据您的代理设置,页面上的标签页数量可能会有所不同。

已连接 / 已断开连接

ConnectedDisconnected选项卡默认按代理池显示代理。 要按字母顺序查看代理,取消选中 按代理池分组 框。
对于每个池,TeamCity 都会显示其构建代理的状态。 点击池旁边的箭头,将显示池代理及其状态的列表。

通过用户界面启用/禁用代理

TeamCity 只在启用的代理之间分配构建。 代理可以通过点击代理名称旁边的状态图标(1)在网页用户界面手动启用/禁用。 如果需要,您可以告诉 TeamCity 在一段时间后自动禁用/启用代理,并输入您的评论。 TeamCity 将按照指令操作,并显示评论图标(2)。 将鼠标悬停在图标上将显示相关信息(3)。

启用/禁用代理程序

当您点击 Disable for maintenance,云代理将切换到维护模式。 在这种模式下,代理将不会被终止,您可以登录代理,查看其日志,并执行其他操作。 另外,默认情况下,代理将不可用于新的构建。

启用/禁用代理程序

参考独立页面以获取有关在 TeamCity 中配置 agent pools 的信息。

参数报告

使用指定参数过滤所有可用的代理。

矩阵和统计学

请参考单独的页面以获取有关查看代理工作量的信息。

列出所有配置的 代理云配置文件

Diff

比较两个代理,并查看其突出的差异。

远程调试代理

在代理安装并连接之后,您可以直接从 TeamCity UI 调用此代理的机器的终端。 这项功能让您可以远程查看代理日志,检查已安装的软件,并对特定的代理问题进行调试。

要调用终端,点击 TeamCity 标题中的 Agents,选择所需的代理,然后点击 Open terminal

代理终端窗口

您也可以从 构建结果页面 打开此终端。 在这种情况下,终端会在 checkout directory 中打开,而不是在 $HOME 文件夹中打开。

代理终端窗口

当终端打开后,您可以点击 Open in a separate tab (在独立选项卡中打开)链接,以获得更大的客户区域。

Open terminal 按钮适用于所有类型的代理机器(Linux,Windows 和 macOS),并以启动 TeamCity 代理的同一用户身份调用终端。

为了确保您在进行维护时构建代理处于空闲状态,请禁用它,但不要停止它,因为终端会话需要一个 运行中的 构建代理。 停止构建代理会冻结之前打开的终端标签页,阻止用户输入新的命令。

对于云代理,如果他们在闲置一段时间后会自动终止,点击 "Disable for maintenance..." 按钮,以保持代理的机器运行。

Open terminal 链接仅对拥有 角色权限 中包含 "Invoke interactive agent terminals" 权限的用户可见。 应授予此权限给所有与相应 agent 的 代理池 关联的项目。 拥有 "Project Administrator" 和 "System Administrator" 角色的用户默认具有此权限。 作为额外的预防措施,每个打开终端的请求都会作为新的 "Agent actions | Connect to agent" 活动写入审核日志

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