安装 TeamCity 代理
在安装 TeamCity 构建代理之前,请务必阅读 系统要求。
选择一个便捷的安装选项:
在 Windows 上使用 安装程序
从 ZIP 文件手动安装在任何平台上
根据 TeamCity 官方的代理镜像 准备容器
在 TeamCity 中打开 Agents 页面。
点击 Install Build Agents 并选择 Windows Installer 来下载安装程序。
在代理机器上,运行
agentInstaller.exe
并按照安装说明进行操作。
确保运行代理服务的用户帐户具有适当的权限。
这个选项允许您下载可以复制到您的代理机器的代理文件的存档。
您可以选择下载完整或最小的 agent 发行版。
Minimal agent distribution(最小代理分发)是一个没有插件的常规构建代理。 最小代理程序在首次启动时将下载所有必需的插件。
Full agent distribution(完全代理分发)包括服务器上当前启用的所有插件的相关版本。 这使得完整的发行版存档变得更大,但显著减少了第一次代理运行所花费的时间。
如果您使用脚本创建代理映像(例如,在云配置文件中),则全代理更为可取。 所有装有完整代理的云实例从启动的那一刻起就与服务器同步,并可以立即运行构建。
完整代理分发也以两种变体提供:
不带 Java 开发工具包的常规代理分发。 如果您下载并安装了这个版本,请确保代理机器已经安装了所需的 JDK 版本(参见 支持的 Java 版本 ),并且
JRE_HOME
或JAVA_HOME
环境变量指向了正确的安装路径。与操作系统特定 JDK 打包的分发版。 这些分发版使您可以一次性安装代理和所需的 JDK。 要下载这些发行版,请在 Administration | Agent JDKs 页面上添加所需的 JDK 版本,然后等待 TeamCity 构建相关的代理发行版。
访问 支持的平台和环境 文档文章,以获取有关哪些 Java 版本受 TeamCity 代理支持的信息。
在 TeamCity 中打开 Agents 页面,并在侧边导航栏中选择 Overview。
点击 Install agent 按钮并选择所需的选项。
如果您选择了 Minimal ZIP file distribution (最小 ZIP 文件分发)选项,最小的操作系统独立存档将开始下载。
如果您选择了 Full distributions (完整版发行)选项,您将被重定向到 Agent Distributions (代理发行)页面,该页面将可用的代理存档分为两类:附带和不附带捆绑 JDK。
未捆绑 JDK 的代理可作为常规存档和 Docker 镜像 提供。
提取已下载的存档。
打开
<installation path>\conf
目录并将buildAgent.dist.properties
文件重命名为buildAgent.properties
。编辑
buildAgent.properties
文件,指定 TeamCity 服务器 URL (建议使用 HTTPS,参见 这些说明)和 agent 的名称。 请参考 此文章 了解代理配置的详细信息。
在 Linux 上,您可能需要授予 bin/agent.sh
Shell 脚本执行权限。
在 Windows 上,您可能希望 使用 Windows 服务运行构建代理,而不是使用手动启动代理。
TeamCity 提供了 Agent Push 功能,该功能允许将构建代理安装到远程主机。 支持的服务器主机平台和构建代理目标的组合:
从基于 Unix 的 TeamCity 服务器,只能将构建代理安装到 Unix 主机(通过 SSH)。
从基于 Windows 的 TeamCity 服务器,可以将构建代理安装到 Unix(通过 SSH)或 Windows(通过 psexec)主机上。
note
SSH 注意事项
确保在目标主机上根据您偏好的认证方法启用了 "Password" 或 "Public key" 认证。
远程主机有几个要求:
平台 | 前提条件 |
---|---|
Linux |
|
Windows |
您可以通过以下命令测试连接:
|
请注意,要访问 Agent Push 页面,用户需要具有 Administer build agent machines (管理构建代理机器)的权限。
在 TeamCity UI 中,打开 Agents | Agent Push,然后点击 Install Agent。
如果您希望对多个目标主机使用相同的设置,您可以 创建一个预设,并在每次向另一台远程主机安装代理时使用它。在 Install agent (安装代理)对话框中,选择已保存的预设或选择 "Use custom settings"(使用自定义设置),指定目标主机平台,然后配置相应的设置。 通过 SSH 将 Agent 推送到 Linux 系统支持自定义端口(默认为22),作为 SSH 端口 参数进行指定。 在主机名中(例如,
hostname.domain:2222
)可以覆盖预设中指定的端口,该操作在实际安装代理时进行。您可能需要下载
Sysinternals psexec.exe
,在这种情况下,您将看到相应的警告和一个指向 Administration | Tools (管理 | 工具)的链接,您可以在那里下载它。
tip
您可以在 代理云配置文件 的设置中使用 Agent Push 预设,以自动将构建代理安装到启动的云实例中。
感谢您的反馈!