TeamCity On-Premises 2024.03 Help

为代理配置 Java

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

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

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

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

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

代理机器上的 Java 路径

.exe TeamCity 代理分发与 64 位的 Amazon Corretto 11 绑定在一起。 为了 .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 中显示为已断开连接。

如果构建代理使用的是早于 Java 8 的 Java 版本,您将在代理的页面上看到相应的警告,以及用户界面中的一个 健康指标

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

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

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

  • (Windows)由于构建代理Windows安装程序已与所需的Java一同捆绑,您只需使用从TeamCity服务器 Agents 页面获取的Windows安装程序( .exe )手动重新安装代理即可。 请查看 安装指南。 在安装更新的代理前,卸载之前版本的代理是很重要的:在 代理主目录 中调用 Uninstall.exe ,清除所有的 "移除" 复选框,并点击 卸载

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

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

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

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