为代理配置 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。