TeamCity On-Premises 2026.1 Help

为代理配置 Java

TeamCity 构建代理是一个 Java 应用程序(参见 支持的 Java 版本)。

一个构建代理运行两个 Java 进程:

  • 代理启动器 —— 启动代理进程。

  • 代理 — 构建代理的主要进程;作为代理启动器的子进程运行。

建议使用 64 位的 JDK(非 JRE)。 JDK 是一些构建运行程序(如 IntelliJ IDEA Project 、Java InspectionsDuplicates )所必需的。 如果您没有 Java 构建,您可以选择安装 JRE 而不是 JDK。

代理机器上的 Java 路径

.exe TeamCity 代理发行版自带 64 位 Amazon Corretto 21。 为了 .zip 代理的安装,您需要安装适当的 Java 版本。 将其通过 PATH 或以下几个地方之一进行发布:

  • <Agent home>/jre 目录

  • TEAMCITY_JREJAVA_HOMEJRE_HOME 环境变量指向的目录(请检查您只定义了其中一个变量)

  • 如果您计划将代理作为 Windows 服务来运行,请确保在 <agent home>\launcher\conf\wrapper.conf 文件中将 wrapper.java.command 属性设置为 Java 可执行文件的有效路径。

在代理上升级 Java

如果您正在尝试启动一个代理,而它在任何 默认位置 都找不到所需的 Java 版本,那么代理将在启动时报告错误,进程将不会启动,而且代理将在 TeamCity UI 中显示为已断开连接。

如果构建代理使用了不受支持或将在未来 TeamCity 版本中停止支持的 Java 版本,您将在代理页面和 UI 中看到相应的警告以及一个 健康项

有关 TeamCity 代理 当前支持的 Java 版本的信息,可以在 这里 查看。

要更新代理上的 Java,请执行以下操作之一:

  • 如果代理检测到安装了相同位数的较新Java版本,那么在TeamCity UI中的代理详细信息页面将显示自动更新操作。 点击此操作以使用较新的 Java 重新启动代理。 代理在完成当前构建并变为闲置状态后重新启动。

  • (Windows)由于构建代理的 Windows 安装程序已捆绑所需的 Java,您只需使用从 TeamCity 服务器 支持人员 页面获取的 Windows 安装程序(.exe )手动重新安装代理。 请查看 安装指南。 在安装更新的代理之前,务必卸载以前版本的代理:在 Agent Home Directory 中调用 Uninstall.exe ,清除所有“ Remove ”复选框,然后点击 卸载

  • 在代理中的一个 标准位置安装所需的 Java 版本,并重启代理 —— 代理应该会检测到它,并在 UI 中提供一个动作来使用更新的 Java。

  • 在代理上安装所需的 Java ,并配置代理以使用它。

请查看此文章获取更多信息: 如何安装非捆绑版本的 Java

无人值守 Java 升级

如果通过软件包管理器(例如 Linux 上的 apt-get )安装了 Java,可能会在不通知的情况下将 Java 升级到最新可用版本。 即使此版本受 TeamCity 支持,也可能会导致某些问题。 例如,正在运行的构建代理需要重启,否则无法找到正确的 JDK 并无法运行其任务。

为避免这些潜在问题,建议手动安装 Java 并配置 JAVA_HOMETEAMCITY_JRE 环境变量。 例如,可能需要通过运行以下命令来禁用 Ubuntu 无人值守升级

# Check the unattended upgrade status systemctl status unattended-upgrades # Stop the service sudo systemctl stop unattended-upgrades # Disable the service sudo systemctl disable --now unattended-upgrades # Edit the configuration file sudo nano /etc/apt/apt.conf.d/20auto-upgrades # TODO: Insert or edit the 'APT::Periodic::Unattended-Upgrade "0";' line in the config file
2026年 8月 6日