TeamCity代理初始仅执行一次构建及无空闲兼容代理问题求解

先排查代理兼容性问题 #

首先确认不是代理和新构建不兼容导致的：

• 进入构建配置页面，找到"Agent Requirements"选项，检查所有要求的条件（比如JDK版本、OS类型、特定环境变量）
• 对比现有代理的参数（在Agents页面点击代理名称查看详情），如果有不匹配的，要么修改构建的要求，要么调整代理的环境配置

让单个代理同时执行多个构建 #

如果代理硬件资源足够，可调整其并行构建数：

• 登录TeamCity管理后台，进入Agents页面，选中要配置的代理
• 切换到Agent Parameters标签页，找到Maximum number of running builds配置项
• 将默认值1改为合适的数值（比如2、3，根据CPU、内存资源调整），保存设置即可

新增构建代理 #

如果代理资源确实不足，新增代理步骤如下：

• 在TeamCity服务器的Agents页面，点击Install Build Agent，下载对应操作系统的代理安装包
• 在目标机器上安装代理，安装时填写TeamCity服务器的地址和端口
• 完成安装后，启动代理服务
• 回到TeamCity的Agents页面，找到新增的代理，点击Authorize完成授权，授权后代理就会进入可用状态

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