TeamCity On-Premises 2024.03 Help

为代理配置 Java

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

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

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

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

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

代理机器上的 Java 路径

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

  • <Agent home>/jre 目录

  • 由 TEAMCITY_JRE, JAVA_HOME 或 JRE_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年