TeamCity Allure插件：为何代理无法完成插件升级？

针对你遇到的Allure插件未同步到代理、导致构建步骤无法被代理接受的问题，结合TeamCity 2017.2.2的特性，给你几个实操性的解决方案：

• 手动同步插件文件
  TeamCity旧版本的代理有时不会自动拉取服务器端安装的插件。你可以：

  1. 找到TeamCity服务器的插件目录（通常是<TeamCity安装路径>\plugins），定位到allure-teamcity-plugin-2.6.jar相关文件；
  2. 把这些文件复制到每台代理的插件目录（Windows代理默认路径是C:\BuildAgent\plugins）；
  3. 注意Windows 7代理可能需要管理员权限才能完成复制操作，确保操作时拥有足够权限。

• 重启代理服务
  插件复制完成后，必须重启TeamCity代理服务才能让新插件生效：

  • 打开Windows服务列表，找到TeamCity Build Agent服务，右键选择「重启」；
  • 或者用管理员权限打开命令行，执行：net stop TeamCityBuildAgent && net start TeamCityBuildAgent。

• 强制代理重新同步插件
  在TeamCity服务器的「代理管理」页面，找到对应的代理实例，点击「Refresh plugins」（旧版本可能显示为「Reload plugins」），触发代理主动从服务器拉取最新的插件配置。

• 检查代理日志排查深层问题
  如果以上操作后仍未解决，去代理的日志目录（C:\BuildAgent\logs）查看teamcity-agent.log，搜索allure关键词，看看有没有插件加载失败的报错信息——比如依赖缺失、权限不足或者版本兼容问题，这些日志能帮你定位具体原因。

• 再次确认版本兼容性
  虽然你用了同版本的插件和工具，但TeamCity 2017.2.2属于较旧版本，建议再核对下Allure 2.6插件是否明确支持这个TeamCity版本，避免因版本不兼容导致插件无法正常加载。

内容的提问来源于stack exchange，提问作者Michał Fita