JetBrains TeamCity代理执行器模式配置及可行性问询

1. 执行器模式能不能替代守护进程模式？ #

明确说：不行。这俩的设计目标完全不一样：

• 守护进程模式（run/start/stop）是让代理长期在线，持续接收服务器分配的构建任务，是TeamCity代理的标准运行方式，适合稳定的持续集成环境。
• 执行器模式是一次性跑单个构建或步骤的临时模式，跑完就退出，适合临时调试某个构建、离线执行预定义任务，或者在无持久化环境这类特殊场景里用。

2. 执行器模式怎么配置使用？ #

（1）BUILD_FILE在哪拿？ #

BUILD_FILE是TeamCity服务器生成的构建配置脚本，获取路径有两种：

• 从服务器页面下载：触发构建后进入构建详情页，找到「Agent Log」或「Build Files」区域，下载对应的构建脚本（一般是.xml或.properties格式，包含构建的所有配置）。
• 通过TeamCity REST API获取：调用服务器的API接口（服务器/app/rest路径下有内置文档），根据构建ID获取对应的构建配置文件。

（2）运行命令示例 #

拿到BUILD_FILE后，直接执行：

./bin/agent.sh executor /绝对路径/到/你的/build-file.xml [BUILD_STEP]

• BUILD_STEP是可选参数，填了就只跑指定的构建步骤，不填就跑整个构建流程。
• 注意：运行前代理必须完成过初始配置（也就是已经连接过服务器，生成了conf/buildAgent.properties这类配置文件），不然执行器模式跑不起来。

3. 能不能让代理默认以执行器模式运行？ #

官方不支持直接设为默认模式。因为执行器模式是TeamCity代理的补充功能，不是常规运行方式。如果需要每次都用这个模式，可以这么搞：

• 写个自定义脚本：先自动从服务器获取BUILD_FILE，再调用agent.sh executor命令，把这个脚本当代理的启动入口。
• 结合自动化工具：在需要临时执行构建的场景里，用本地脚本或其他CI工具触发执行器模式的运行，不用依赖代理的默认启动流程。

内容的提问来源于stack exchange，提问作者TehQuila