TeamCity 服务器与 Agent 的安装卸载

Windows 上装 TeamCity server 和 agent 的记录。同一个 exe 既能装 server 也能装 agent,安装时按需选。免费版最多三个 agent。

安装 server

去官网下载 teamcity.exe,双击安装,它会注册成 Windows 服务。安装向导里可以选装 server 还是 agent。参考官方快速安装指南。

改 server 端口

server 端口配置文件在 <TeamCityInstallFolder>\conf\server.xml,默认端口 8111。安装时可以直接改端口;装好之后想改参考官方说明。

如果同一台机器装多个 TeamCity 实例,<TeamCityInstallFolder>\conf\server.xml 里所有端口配置都要改开,改完重启服务器。

改 agent 端口

agent 端口配置文件在 <TeamCityInstallFolder>\buildAgent\conf\buildAgent.properties,安装时可以改。

手动启停 server

cd /d <TeamCityPath>\bin
./runAll.bat start
./runAll.bat stop

安装 agent

在 agent 机器上跑同一个 exe,它会注册成 Windows 服务。agent 起来后会自动连上 server。

手动启停 agent:

cd /d <AgentPath>\bin
agent.bat start
agent.bat stop

卸载 server

管理员 CMD 里删服务:

cd /d C:\TeamCity\bin
.\teamcity-server.bat service delete

删服务只是去掉了 Windows 服务注册,数据缓存还在 C:\ProgramData\JetBrains\TeamCity。这个目录的结构:

子目录	存的内容	重要性
config/	所有项目、构建配置、VCS root、模板的 XML;database.properties(数据库连接配置)	核心配置
system/	内部数据库(默认 HSQLDB,文件在 system/buildserver),以及构建历史、artifacts、构建日志	核心数据
system/artifacts/	每次构建产出的归档文件	占空间最大
system/messages/	构建运行日志
plugins/	额外装的插件
lib/	数据库 JDBC 驱动等
backup/	TeamCity 自己做的备份包
config/_trash/	被删项目的回收站

删掉这个目录等于所有项目配置、构建历史、artifacts、用户账号、license 配置全部清空,TeamCity 回到刚装好的空白状态。确认不需要再删。

卸载 agent

cd /d C:\TeamCity\buildAgent\bin
.\service.stop.bat
.\service.uninstall.bat