设置并运行其他构建代理

共同

代理程序（java）必须

• 能够打开通过服务器配置的服务器URL的出站HTTP连接serverUrl物业buildAgent.properties文件（通常与您在浏览器中用来查看TeamCity UI的地址相同）。将请求发送到配置的URL下的路径不应受到限制。另请参阅推荐的反向代理设置 。确保代理或服务器计算机上安装的所有防火墙，网络配置和代理（如果有）均符合这些要求。

• 递归对以下目录具有完全权限（读/写/删除）： （自动代理升级和代理工具支持所必需）， ， 和代理系统目录（由workDir ， tempDir和systemDir中的参数buildAgent.properties文件）

• 能够启动流程（运行构建）。

• 能够使用以下父进程出口启动嵌套进程（在代理升级期间使用）

视窗

• 作为服务登录（作为Windows服务运行）

• 启动/停止服务（要作为Windows服务运行，代理升级才能正常运行，另请参阅Microsoft KB文章 ）

• 调试程序（需要执行进程转储功能）

• 重新启动计算机（代理重新启动功能需要）

• 为了能够监视作为Windows 服务运行的构建代理的性能 ，启动代理的用户必须是Performance Monitor Users组的成员。

的Linux

• 用户必须能够运行shutdown命令（用于在云环境中运行时的代理计算机重新启动功能和计算机关闭功能）

• 使用systemd时，不应杀死主进程出口上的进程（使用RemainAfterExit = yes ）

与构建相关的权限

构建过程由TeamCity代理启动，因此共享环境，并在TeamCity代理使用的OS用户下执行。确保已相应配置TeamCity代理。有关相关的Windows服务限制，请参阅已知问题 。

单向代理到服务器通信

代理通过轮询协议使用单向代理到服务器的连接：代理建立与TeamCity Server的HTTP（S）连接，并定期轮询服务器以获取服务器命令。

建议使用HTTPS进行代理到服务器的通信（请参阅相关的服务器配置说明 ）。如果将代理程序和服务器部署到安全环境中，则可以将代理程序配置为使用纯HTTP URL来连接到服务器，因为这样可以减少传输开销。请注意，通过从代理建立的连接到服务器的连接传输的数据包括构建设置，存储库访问凭证和密钥，存储库源，构建工件，构建进度消息和构建日志。如果使用HTTP协议，则可以通过“中间人”攻击来破坏数据。

双向通讯

双向通信是代理程序与服务器之间的传统连接，需要专门启用它（请参见下面的示例）。启用后，它要求代理通过HTTP（或HTTPS）连接到服务器，服务器需要通过HTTP连接到代理。

通过服务器建立的连接传递给代理的数据会通过不安全的HTTP通道传递，因此可能会暴露给任何可能监听服务器和代理之间流量的第三方。此外，由于代理和服务器可以相互发送“命令”，因此可以发送HTTP请求和捕获响应的攻击者从理论上讲可以诱使代理执行任意命令并执行其他具有安全影响的动作。

TeamCity代理使用的通信协议由以下值确定： teamcity.agent.communicationProtocols服务器内部属性 。该属性接受以逗号分隔的协议的有序列表（ polling和xml-rpc支持的协议名称），并设置为teamcity.agent.communicationProtocols=polling默认。如果指定了多个协议，则代理将尝试使用此列表中的第一个协议进行连接，如果失败，它将尝试通过列表中的第二个协议进行连接。 polling表示单向协议， xml-rpc -较旧的双向通讯。

更改通讯协议

• 要更改所有座席的通信协议，请设置TeamCity服务器teamcity.agent.communicationProtocols服务器内部属性 。更改后，所有连接到服务器的代理将使用新设置。要更改现有连接的协议，请重新启动TeamCity服务器。

• 默认情况下，未配置代理的属性。当代理首次连接到服务器时，它会从TeamCity服务器接收它。要在初始代理配置后更改单个代理的协议，请更改teamcity.agent.communicationProtocols 代理属性中的属性 。代理的属性将覆盖服务器属性。更改后，代理将在完成正在运行的构建（如果有）时自动重新启动。

• 将版本为2018.1+的TeamCity代理连接到9.1之前的版本的TeamCity服务器时（例如，在升级后回滚之后），将需要更新代理以使用xml-rpc协议（或可以重新安装），以便能够连接到较旧的服务器以执行自我更新过程。

远程主机要求

远程主机有一些要求：

安装

1. 在TeamCity Server Web UI中，导航到“ 代理” |“ 代理” 。 代理推送选项卡，然后单击安装代理...。
   如果要对多个目标主机使用相同的设置，则可以使用这些设置创建一个预设 ，并在每次将代理安装到另一个远程主机时都使用该预设 。

2. 在“ 安装代理”对话框中，选择一个保存的预设或选择“使用自定义设置”，指定目标主机平台并配置相应的设置。通过SSH将代理推送到Linux系统支持指定为SSH端口参数的自定义端口（默认为22）。预设中指定的端口可以在主机名中覆盖，例如hostname.domain:2222 ，在实际安装代理程序期间。

3. 您可能需要下载Sysinternals psexec.exe ，在这种情况下，您会看到相应的警告以及指向管理 |链接的链接。您可以在“ 工具”页面上下载它。

您可以在“ 代理程序云”配置文件设置中使用“代理程序推送”预设来将构建代理程序自动安装到已启动的云实例。

Windows下自动启动代理

要在Windows下的计算机启动时自动运行代理，可以将代理设置为作为Windows服务运行，也可以使用另一种自动启动进程的方式。
使用Windows服务方法是最简单的方法，但是Windows将某些约束应用于以这种方式运行的进程。
只要满足所有要求 ，TeamCity代理就可以在Windows服务下可靠地工作，但是配置为在代理上运行的生成过程通常不是这种情况。

这就是为什么仅在所有构建脚本都支持的情况下才建议将TeamCity代理作为Windows服务运行的原因。否则，建议使用特定于操作系统的替代方法来自动启动TeamCity代理。
一种方法是在Windows启动时配置自动用户登录 ，然后配置TeamCity代理启动（通过agent.bat start ）（例如，通过Windows Task Scheduler ）。

Build Agent作为Windows服务

在Windows中，您可能希望将TeamCity代理作为Windows服务运行，以使其在没有任何用户登录的情况下运行。如果使用Windows代理安装程序，则可以选择在安装向导中安装该服务。

以下说明可用于手动安装Windows服务（例如， .zip代理安装）。还应执行此过程，以在同一台计算机上为第二个及后续代理创建Windows服务。

要安装服务：

1. 检查服务是否具有所需的名称和ID（请参阅下面的＃4，服务名称为TeamCity Build Agent默认情况下）不存在；如果已安装，请将其删除。

2. 检查wrapper.java.command物业\launcher\conf\wrapper.conf文件在JDK安装目录中包含Java可执行文件的有效路径。您可以使用wrapper.java.command=../jre/bin/java与Windows发行版一起安装的代理。确保指定java.exe文件的路径，且不带引号。

3. 如果要以用户帐户（推荐）而不是“系统”身份运行代理，请添加wrapper.ntservice.account和wrapper.ntservice.password的属性\launcher\conf\wrapper.conf具有适当凭证的文件

4. （适用于第二和后续安装）修改\launcher\conf\wrapper.conf文件，以便wrapper.console.title ， wrapper.ntservice.name ， wrapper.ntservice.displayname和wrapper.ntservice.description属性在计算机内具有唯一值。

5. 跑过\bin\service.install.bat具有足够特权的用户下的脚本来注册新代理服务。确保仅在按照说明进行配置后才第一次启动代理。

要启动服务：

• 跑/bin/service.start.bat （或使用标准的Windows Services小程序）

要停止服务：

• 跑/bin/service.stop.bat （或使用标准的Windows Services小程序）

您也可以使用标准Windows net.exe实用程序，用于在安装服务后对其进行管理。
例如（假设默认服务名称）：

的\launcher\conf\wrapper.conf该文件还可以用于更改代理JVM参数。

用于运行构建代理服务的用户帐户必须具有足够的权限来启动/停止代理服务，如描述上面 。

在Linux下自动启动代理

要在Linux下的计算机引导上自动运行代理，请使用以下命令配置守护进程agent.sh start命令启动它并agent.sh stop命令停止它。

对于systemd，请参见示例teamcityagent.service配置文件：

对于init.d ，请参考示例过程：

1。导航到服务启动/停止服务脚本目录：

2。打开构建代理服务脚本：

3。将以下内容粘贴到文件中：

4。设置执行文件的权限：

5，建立链接以使用适当的工具在计算机启动和重新启动时启动代理服务：

• 对于Debian / Ubuntu：

• 对于Red Hat / CentOS：

在macOS下自动启动代理

对于macOS / Mac OS X，TeamCity提供了在构建用户登录时自动加载构建代理的功能。

LaunchAgent方法

通过配置自动构建代理启动LaunchAgent ， 跟着这些步骤：

1。通过Mac在Mac上安装构建代理buildAgent.zip 。

2。准备conf/buildAgent.properties文件（至少在此设置代理名称）。

3。确保下的所有文件buildAgent目录归拥有者所有your_build_user以确保适当的代理升级过程。

4。通过以下命令加载构建代理：

在下面运行这些命令your_build_user帐户。

您必须等待几分钟 ，构建代理才能从TeamCity服务器自动升级。您可以在日志中查看该过程：

5，当构建代理升级并成功连接到TeamCity服务器后，停止代理：

6。从TeamCity服务器升级构建代理后，复制buildAgent/bin/jetbrains.teamcity.BuildAgent.plist归档到$HOME/Library/LaunchAgents/目录。

7。配置您的Mac系统自动登录的用户打造，如所描述这里 。

8。重启。

在系统启动时，构建用户应自动登录，并且构建代理应启动。

要快速检查构建代理程序是否正在运行，请使用以下命令：

在Mac OS上配置第二个Build Agent

如果要启动多个构建代理，请通过以下更改重复安装和启动构建代理的过程：

• 在另一个目录中安装第二个构建代理。

• 在conf/buildAgent.properties指定其他代理名称。

• 别跑buildAgent/bin/mac.launchd.sh ;代替

  • 创建副本$HOME/Library/LaunchAgents/jetbrains.teamcity.BuildAgent.plist归档为$HOME/Library/LaunchAgents/jetbrains.teamcity.BuildAgent2.plist 。

  • 编辑$HOME/Library/LaunchAgents/jetbrains.teamcity.BuildAgent2.plist文件并设置以下参数：

    • 的Label参数jetbrains.teamcity.BuildAgent2

    • 的WorkingDirectory参数到第二个构建代理主目录的正确路径

  • 使用命令启动第二个代理launchctl load $HOME/Library/LaunchAgents/jetbrains.teamcity.BuildAgent2.plist

要检查两个构建代理程序是否都在运行，请使用以下命令：