TeamCity On-Premises 2025.07 Help

查看构建代理详情

要查看代理的状态和信息,请点击其名称或导航到 支持人员 页面,在已连接、已断开或已授权的代理列表中找到该代理并点击其名称。

对于每个连接的代理,TeamCity提供以下信息:

代理概述

  • 状态了解有关代理状态的更多信息

  • 详情:

    • 代理名称

    • 代理主机的 IP 地址

    • TeamCity 服务器连接到代理时使用的端口

    • 代理和服务器之间进行数据传输所使用的通信 协议

    • 代理操作系统

    • CPU 排名:捆绑的 CPU 基准测试的结果。 请注意,基准测试结果可能取决于代理使用的 JVM 版本和选项。 例如, -服务器 JVM 选项对结果有重大影响。 CPU 基准测试也会影响服务器如何在代理之间分配构建。 如果无法为代理计算构建持续时间估计(该代理的历史记录中没有构建),TeamCity 会根据 CPU 基准值选择最快的代理。

    • 代理所属的

    • 代理启动器版本

    • Open Terminal 按钮。 打开一个基于浏览器的交互式Shell。 拥有 "Invoke interactive agent terminals" 权限的用户可使用此功能(默认情况下,系统和项目管理员会被授予此权限)。 查看此帮助文章以了解更多信息: 远程调试代理

  • 如果代理上有 正在运行构建 ,页面将显示有关构建的信息,并提供指向 构建结果的链接。

  • 其他 :本节提供以下选项

    • 在代理上清理源代码

    • 打开远程桌面:如果RDP客户端已在代理上安装并注册,那么运行在Windows操作系统上的代理可以使用此功能。

    • 重启代理机器:仅对具有 重启构建代理机器 权限的用户可用。 点击链接并确认重启操作。 默认情况下,TeamCity 代理会等待当前构建完成。 取消选择复选框,然后点击 Reboot 以立即重启代理。
      可以进一步配置重启命令。 请查看 Agent Reboot

    • 在代理上转储线程

代理重启

通过执行特定于操作系统的命令来进行代理重启。 在某些情况下,命令可能需要针对操作系统环境进行特定的定制。 如果默认的重新启动命令失败,可能需要进行额外的配置。

为了调整代理重启,将 teamcity.agent.reboot.command 代理配置参数添加到 buildagent.properties 文件中,并在需要重启时执行命令。 示例配置:

teamcity.agent.reboot.command=sudo shutdown -r 60

或者

teamcity.agent.reboot.command=shutdown -r -t 60 -c "TeamCity Agent reboot command" -f

Build History(构建历史记录)

显示在代理上运行的构建。

要查看从特定 云镜像生成的任何代理上运行的所有构建,请转到 支持人员 页面,选择所需的镜像,并切换到 Build History(构建历史记录) 选项卡。 您也可以浏览特定云代理的构建,即使它已经不再可用。 为此,请在搜索框中输入其名称。

已删除代理的历史记录

兼容配置

显示兼容和不兼容的构建配置,以及不兼容的原因。

构建运行程序

列出由构建代理支持的构建运行程序。

日志

该页面允许查看和下载日志。

参数

该标签页列出了系统属性、环境变量和配置参数。 请参阅 配置构建参数 页面以获取有关不同类型参数的更多信息。

新的 Agent 参数标签页
最后修改日期: 2025年 9月 3日