重命名一个TeamCity构建代理

Question

我继承了一个TeamCity服务器并正在审核配置。为了使它更容易，我想将一个构建代理从一个很长的随机名称改成一个更容易识别的名称。

但是，在代理汇总页面中找不到任何更改名称的选项。

有人知道如何更改构建代理名称吗？

- Karl Gjertsen

Answer 1

您需要在代理服务器自身的 buildAgent.properties 文件中编辑 name 字段：

name=change-this-name

根据TeamCity代理的安装位置，Windows上的文件可能位于C:\TeamCity\buildAgent\conf\buildAgent.properties，Linux上则位于/home/teamcity/buildagent/conf/buildAgent.properties。

- Jonathon Rossi

---

完美！值得注意的是，我随后不得不重新启动构建代理和TeamCity服务。有趣的一点是，在TeamCity中，旧的构建仍然显示原始的构建代理名称，但是单击它们仍会将您带到构建代理，尽管使用了新名称。 - Karl Gjertsen

过去我发现（至少在Windows上），如果您编辑了该文件并使用新名称连接，代理程序将自动重启。代理名称在旧版本中被缓存，以防您删除代理程序，您可以在“历史”数据库表中更新agent_name，保留 agent_type_id不变。 - Jonathon Rossi