启动 TeamCity 代理

Windows 下的自动代理启动

一个 TeamCity 代理在满足所有要求的情况下可以在 Windows 服务下可靠地工作，但对于配置为在代理上运行的构建过程来说，这种情况往往并非如此。这就是为什么仅在您的所有构建脚本都支持此功能的情况下，才推荐将 TeamCity 代理作为 Windows 服务来运行。否则，建议使用其他特定于操作系统的方法来自动启动 TeamCity 代理。
其中一种方法是在 Windows 启动时配置用户自动登录，然后使用 agent.bat start 在用户登录时配置 TeamCity 代理的启动（例如，通过 Windows 计划任务进行配置）。

使用 Windows 服务运行构建代理

以下指令可用于手动安装 Windows 服务（例如，完成 .zip 代理的安装后）。此过程也应执行以在同一台机器上为第二个及后续代理创建 Windows 服务。

您也可以使用标准的 Windows 工具 net.exe 来管理已安装的服务。例如（假设默认服务名称）：

net start TCBuildAgent

<agent home>\launcher\conf\wrapper.conf 文件也可以用于更改代理 JVM 参数。

Linux 下自动启动代理

要在 Linux 机器上自动运行代理，需要使用 agent.sh start 命令配置一个守护进程来启动它，并使用 agent.sh stop 命令来停止它。

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

[Unit]
Description=TeamCity Build Agent
After=network.target

[Service]
Type=oneshot

User=teamcityagent
Group=teamcityagent
ExecStart=/home/teamcityagent/agent/bin/agent.sh start
ExecStop=-/home/teamcityagent/agent/bin/agent.sh stop

# Support agent upgrade as the main process starts a child and exits then
RemainAfterExit=yes
# Support agent upgrade as the main process gets SIGTERM during upgrade and that maps to exit code 143
SuccessExitStatus=0 143

[Install]
WantedBy=default.target

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

导航至服务的脚本目录：
```
cd /etc/init.d/
```
打开构建代理服务脚本：
```
sudo vim buildAgent
```

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

#!/bin/sh
### BEGIN INIT INFO
# Provides:          TeamCity Build Agent
# Required-Start:    $remote_fs $syslog
# Required-Stop:     $remote_fs $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Start build agent daemon at boot time
# Description:       Enable service provided by daemon.
### END INIT INFO
#Provide the correct user name:
USER="agentuser"

case "$1" in
start)
 su - $USER -c "cd BuildAgent/bin ; ./agent.sh start"
;;
stop)
 su - $USER -c "cd BuildAgent/bin ; ./agent.sh stop"
;;
*)
  echo "usage start/stop"
  exit 1
 ;;

esac

exit 0

设定文件的执行权限：
```
sudo chmod 755 buildAgent
```
使用适当的工具，在机器启动和重启时启动代理服务：
- 对于 Debian/Ubuntu：
```
sudo update-rc.d buildAgent defaults
```
- 对于 Red Hat / CentOS ：
```
sudo chkconfig buildAgent on
```

macOS 下自动启动代理

要通过 launchd 配置自动构建代理的启动，请按照以下步骤操作：

在 buildAgent.zip 上安装构建代理。
准备 conf / buildAgent.properties 文件（至少设置代理名称）。
确保 buildAgent 目录下的所有文件都由 your_build_user 所拥有，以保证代理升级过程的适当进行。

通过命令加载构建代理：

mkdir buildAgent/logs  # Directory should be created under your_build_user user
sh buildAgent/bin/mac.launchd.sh load

在 your_build_user 帐户下运行这些命令。等待几分钟，以便构建代理从 TeamCity 服务器自动升级。您可以在日志中查看该过程：
```
tail -f buildAgent/logs/teamcity-agent.log
```
当构建代理升级并成功连接到 TeamCity 服务器后，停止该代理：
```
sh buildAgent/bin/mac.launchd.sh unload
```
在构建代理从 TeamCity 服务器升级之后，将 buildAgent/bin/jetbrains.teamcity.BuildAgent.plist 文件复制到 $HOME/Library/LaunchAgents/ 目录（您可能需要创建它）。如果您不希望 TeamCity 以 root 权限启动，请在 .plist 文件中指定 UserName 密钥，例如：
```
<key>UserName</key>
<string>your_build_user</string>
```
按照此处所述，将您的 macOS 系统配置为自动登录为 your_build_user。
重启机器。在系统启动时，构建用户应自动登录，构建代理应该启动。
要快速检查构建代理是否正在运行，请使用以下命令：
```
launchctl list | grep BuildAgent
69722	0	jetbrains.teamcity.BuildAgent
```

启动 TeamCity 代理﻿

手动启动﻿

tip

自动启动﻿

Windows 下的自动代理启动﻿

使用 Windows 服务运行构建代理﻿

warning

tip

Linux 下自动启动代理﻿

macOS 下自动启动代理﻿

停止构建代理﻿

手动启动

自动启动

Windows 下的自动代理启动

使用 Windows 服务运行构建代理

Linux 下自动启动代理

macOS 下自动启动代理

停止构建代理