TeamCity On-Premises 2024.03 Help

系统要求

这篇文章包含了关于选择和配置 TeamCity 服务器和代理 环境,以及它们与专用外部数据库之间网络连接的一般建议。 如果您有一些这里未涉及到的特定问题,请通过任何方便的 反馈渠道 联系我们的支持服务。

TeamCity 服务器要求

选择服务器操作系统/平台

TeamCity 服务器 可以在任何最新版本的 Windows 、 Linux 或 macOS 上运行。 服务器操作系统的要求在 这里 列出。

我们也建议您回顾一下您计划使用的集成的 要求。 例如,以下功能可能需要或在 TeamCity 服务器 安装在 Windows 下时运行得更好:

  • VCS 与 Azure DevOps (TFS)集成

  • VCS 与 VSS 的集成

  • Windows 域登录(可以在 Linux 下工作,但可能稳定性较低),特别是 NTLM HTTP 验证

  • 在服务器上的 NuGet 源(可以在 Linux 下工作,但可能稳定性较差)

  • Agent push 推送至 Windows 机器

如果您没有特定的偏好,总的来说,Linux 平台可能更受欢迎。 他们在文件系统操作和维护方面更有效率。 对操作系统的最终决定应取决于您的公司的可用资源和已建立的实践。

估算服务器的硬件需求

服务器的硬件需求取决于服务器负载,而服务器负载在很大程度上取决于您的构建类型和服务器使用模式。 这一部分包含了关于各种硬件相关方面的注释。

CPU

TeamCity 服务器 可以利用多个 CPU 核心。 对于生产用途,使用至少 4 个 CPU 核心是有意义的。

内存

TeamCity 通常会启动多个 Java 进程。 主进程负责显示用户界面并执行大多数的后台操作。 它可以启动执行特定任务所需的其他进程,如编译和执行 Kotlin DSL。 在定义主进程的 -Xmx 内存值时,记得为其他可能的进程留下足够的内存。 参见 关于配置主进程内存的说明

对于估计,16 GB 的内存通常足以运行高达 100 个并行构建(代理),支持最多 200 个在线用户,并与中等大小的存储库一起工作。 如果您的服务器规模相当大,我们建议您相应地调整内存量。

TeamCity 将按比例使用所有可用的内存:例如,JetBrains 构建服务器由两个节点组成,总共使用了 80 GB 的内存,以支持 2000 个构建代理和许多提交者。

磁盘

TeamCity 服务器的性能在很大程度上取决于磁盘性能。 由于 TeamCity 在 <TeamCity 数据目录>/system 下存储大量数据(尤其是 VCS 缓存和构建结果),因此确保快速访问磁盘非常重要(特别是在多线程中读取 / 写入文件和列出带有属性的文件)。

如果您计划在网络驱动器上存储数据目录,您需要确保其性能良好。 然而,我们强烈建议您为 <TeamCity 数据目录>/system/caches 目录使用本地存储。 另见:关于 选择数据目录位置 的说明。

免费磁盘空间的需求主要由服务器上存储的构建数量以及每个构建中的工件 / 构建日志大小决定。 在处理 Git 或 Mercurial 项目时,TeamCity 会创建仓库的镜像,并将它们放入 system/caches 目录下。 如果您的构建配置使用了服务器端检出,您需要在 system/caches 下分配额外的空间来存储仓库的资源。 因此,所需的磁盘空间可能是所有配置的 VCS 根使用的存储库大小的两倍。

如果构建产生大量的数据(构建产件 / 构建日志 / 测试数据),我们建议您使用快速访问的外部存储来存储 .BuildServer/system 目录。

另请参见以下示例配置 下面

网络

为了支持一个与众多代理相连的负载服务器,需要快速的网络连接。

网络流量主要由以下因素占用:

  • 支持人员:

    • 从服务器下载更新、工具、构件依赖项以及源代码(在服务器端签出的情况下)。

    • 将构建日志消息发送回服务器并上传工件。

  • 服务器:

    • 从 VCS 仓库获取新的提交并检查它们的状态。

    • 与云服务提供商进行通信。

    • 与外部数据库进行通信。

  • 使用服务器网络界面的浏览器。

  • 使用服务器 REST API 来获取数据的自定义脚本/控制板。

服务器负载因素

服务器的负载取决于:

  • 构建配置的数量

  • 历史记录中的构建数量

  • 每日运行的构建数量

  • 构建消耗和产生的数据量(使用的源文件和工件的大小、构建日志的大小、单元测试的数量和输出大小、检查和重复项命中的数量、产生的工件的大小和数量等)

  • 配置了清理规则

  • 代理数量及其利用率

  • 拥有打开 TeamCity 网页的用户数量

  • 从 IDE 插件中登录的用户数量

  • VCS 根的数量和类型,以及配置的检查更改的间隔。 VCS签出模式也亦相关:服务器签出模式会生成更大的服务器负载。 特定类型的 VCS 也会影响服务器负载,但可以根据原生 VCS 客户端性能进行大致估算。

  • TeamCity 每天在所有 VCS 根目录中检测到的更改数量

  • TeamCity 处理的仓库的大小

  • TeamCity 每日检出的源码总大小

示例服务器配置

以下硬件配置能够处理多达100个并发运行的构建。 暗示了这台机器只托管 TeamCity 服务器 - 而不是代理或数据库。

  • 适用于服务器的现代多核CPU(8核或以上)

  • 16 GB 的内存

  • 快速网络连接

  • 快速且可靠的硬盘驱动器

  • 快速外部数据库访问

案例 1

根据我们的经验,如 Intel 3.2 GHz 双核 CPU,Windows 下的 8 GB 内存,1 GB 网络适配器以及单个 HDD 等硬件可以为以下设定提供可接受的性能:

  • 60个项目和300个构建配置(其中四分之一正在活跃并定期运行)

  • 每天超过300次构建

  • 每次构建约产生 2 MB 日志

  • 50个构建代理

  • 50 位网页用户和 30 位 IDE 用户

  • 100 个 VCS 根(主要是使用服务器检出的 Perforce 和 Subversion),平均检查更改间隔为 120 秒

  • 每天超过150次更改

  • Kotlin DSL 没有被使用

  • 数据库(MySQL)正在同一台机器上运行

  • TeamCity 服务器进程具有 -Xmx1100m JVM 设置

案例 2

以下配置可以为负载较大的 TeamCity 服务器提供可接受的性能:Intel Xeon E5520 2.2 GHz CPU(4 核,8 线程),Windows Server 2008 R2 x64 下的 16 GB 内存,1 GB 网络适配器,3 HDD RAID1 磁盘(一般情况下一个,一个用于存放构建工件、日志和缓存,另一个用于数据库存储)。 针对以下设置进行了测试:

  • 150个项目和1500个构建配置(其中三分之一正在活跃并定期运行)

  • 每天超过1500次构建

  • 每次构建大约需要 4 MB 的日志

  • 100 个构建代理

  • 150 位网页用户和 40 位 IDE 用户

  • 250个VCS根(主要是Git、Hg、Perforce和使用代理端检出的Subversion),平均检查更改间隔为180秒

  • 每天超过1000次变更

  • 数据库(MySQL)正在同一台机器上运行

  • TeamCity 服务器进程设置了 -Xmx3700m x64 JVM

然而,为了确保能够良好地处理峰值负载,建议使用更强大的硬件。

如果您在虚拟机上安装了 TeamCity,请确保您每天执行 清理,以删除过期的构建日志和工件,从而节省磁盘空间。 根据我们的粗略估计,Case 1 的安装可能需要 7 GB 的磁盘空间,Case 2 可能需要 15 GB,前提是空间被最优化利用并且所有峰值负载都已经考虑在内。

对于部署大规模 TeamCity 安装的一般建议是,从考虑潜在硬件升级的合理硬件开始。 您可以逐渐增加服务器的负载(例如,添加更多的项目)同时监控性能统计数据,然后决定是否需要进行硬件或软件的改进。 还有一个 benchmark plugin 可以用来估计当前服务器安装能处理的同时构建的数量。

我们也建议您遵循服务器管理的最佳实践,例如将磁盘碎片整理保持在合理的水平。

如果您需要增加同时运行的构建(代理)的数量,那么请准备按照相同的比例增加 CPU、内存、数据库和 HDD 的访问速度,以达到相同的性能。 如果您增加每天的构建次数,请准备相应地增加磁盘大小。

根据代理数量调整服务器规模

一个 TeamCity 服务器 实例可以稳定地与 1000+ 的构建代理(同时运行并积极记录构建运行时间数据的 1000 个构建)进行工作。

每个构建产生的服务器负载取决于这个构建的数据量(日志、测试、失败详细信息、检查/重复问题数量等)。 将数据量合理地限制(将大型输出作为构建成果发布,而不是打印到标准输出中,调整检查配置文件以报告最重要的一些检查结果等等)将有助于服务器扩展以处理更多的并行构建。

如果您需要更多的代理/并行构建,我们强烈推荐使用 多节点设置 并在节点之间分配项目

我们不断改进 TeamCity 的性能,并与运行大型 TeamCity 安装的组织紧密合作。 这样,我们可以研究性能问题并改进 TeamCity 以处理更大的负载。

配置 TeamCity 服务器以提高性能

这一部分包含了一份关于调整 TeamCity 服务器设置以提高性能的建议清单。 它假设服务器已经配置为生产环境使用

  • 定期查看 Server Health 报告(包括隐藏的)。

  • 使用单独的 反向代理服务器(例如,NGINX)来处理 HTTPS。

  • 使用单独的服务器来管理外部数据库。 监控数据库性能。

  • 监控服务器的 CPU 和 I/O 性能。 根据需要增加硬件资源。

  • 确保所有具有适当保留策略的项目都配置了 clean-up。 检查 Administration | Clean-Up 以确保定期执行清理操作。

  • 请考虑确保 <TeamCity 数据目录>/system/caches 目录的良好 I/O 性能:例如,将其移动到单独的本地驱动器上。

  • 定期 归档 过时的项目。

  • 定期审查已安装的非捆绑插件,并删除那些对服务器运行不必要的插件。

  • 尽可能考虑使用 代理端检出

  • 确保构建日志占用的空间合理(最多数十兆字节,但最好少于 10 MB)。

  • 如果服务器上配置了大量的 VCS 根目录,您可能需要考虑配置 仓库提交钩子,以替代轮询变更;或者,将 VCS 轮询间隔 增加到 300 秒或更多。

  • 如果服务器被超过1000个用户使用,可以考虑通过增加 UI刷新间隔 来降低后台 UI 请求的频率。

  • 当经常超过500个同时运行的构建并记录大量数据时,请考虑切换到一个 多节点设置

  • 如果您有很多项目或构建配置,我们建议您避免使用 Default agent,以便释放 TeamCity 服务器资源。 TeamCity 管理员可以在网页 UI 的 代理 页面上 禁用 默认代理。

TeamCity 代理需求

此部分列出了适合运行 TeamCity 构建代理进程的环境和操作系统用户的要求。

选择代理 操作系统 / 平台

TeamCity 代理 可以在任何最新版本的 Windows、Linux 或 macOS 上运行。 代理操作系统的需求已在 此处 列出。

常见要求

代理 Java 进程必须:

  • 能够打开指向服务器URL的出站HTTP连接,该URL是通过 serverUrl 属性在 buildAgent.properties 文件中配置的(通常与您在浏览器中查看 TeamCity UI 所用的地址相同)
    向配置的URL下的路径发送请求不应受到限制。 另请参见推荐的 反向代理设置。 确保安装在代理或服务器主机上的任何防火墙、网络配置以及代理(如有)都符合这些要求。

  • 对以下目录具有完全的权限(读/写/删除): <Agent Home Directory> (自动代理升级和代理工具支持所必需), <Agent Work Directory><Agent Temp Directory> ,以及代理系统目录(由 workDirtempDirsystemDir 参数在 buildAgent.properties 文件中设定)。

  • 能够启动进程(运行构建)。

  • 能够在以下父进程退出时(在代理升级过程中使用)启动嵌套进程。

针对 Windows 基础的代理的要求

运行代理进程的 Windows 用户必须:

  • 能够启动 / 停止服务(以 Windows 服务形式运行,对于代理升级至关重要,也请参阅 此文章)。

  • 能够调试程序(需要用于获取进程转储功能)。

  • 能够重新启动机器(这是代理重启功能所必需的)。

  • 成为 性能监控用户 组的成员(以便能够 监控 作为 Windows 服务 运行的构建代理的性能)。

  • 能够作为 Windows 服务运行,仅当代理作为服务运行时(请参阅 此文章)。

关于赋予权限的说明:

要了解如何授予用户必要的权限,请查看 这篇文章。 您可以使用 Microsoft SubInACL 工具来分配管理服务的权限,这是一款使管理员能够直接编辑安全信息的命令行工具。 该工具使用以下语法:

SUBINACL /SERVICE \\MachineName\ServiceName /GRANT=[DomainName]UserName[=Access]

例如,要授予启动/停止权限,您可能需要执行以下命令:

subinacl.exe /service TCBuildAgent /grant=<user login name>=PTO

基于 Linux 的代理要求

运行代理进程的 Linux 用户必须能够运行 已关闭 命令(用于在云环境中运行时的代理机器重启和关闭功能)。 如果您正在使用 systemd ,那么在主进程退出时,它不应该结束进程(使用 RemainAfterExit=yes)。 另请参阅:如何在 Linux 下设置自动启动代理

构建相关的权限

每个构建过程都由 TeamCity 代理启动。 它共享环境,并在 TeamCity 代理所使用的操作系统用户下执行。 确保 TeamCity 代理已经相应地被配置。 参阅 已知问题 了解与 Windows 服务限制相关的信息。

估算代理的硬件需求

代理的硬件需求由它们运行的构建确定。 运行 TeamCity 代理软件需要额外的 CPU 时间(但通常可以忽略,因为与构建过程的 CPU 要求相比,这个需求较小)和额外的内存:大约 500 MB。 所需的磁盘空间对应于代理上运行的构建(源代码检出,下载的工件,构建过程中消耗的磁盘空间;所有这些都是针对常规发生的构建)。

虽然您可以在与 TeamCity 服务器相同的机器上运行构建代理,但推荐的方法是为每个构建代理使用单独的机器(可以是虚拟的)。 如果您选择在同一台机器上安装多个代理,那么请考虑可能出现的 CPU、硬盘、内存或网络瓶颈。 Performance Monitor 构建功能可以帮助分析实时数据。

如果您考虑为 TeamCity 代理(例如,在 Amazon EC2上)进行云部署,也请参见 这篇文章

估算服务器与代理之间的网络流量

网络流量主要取决于您的设置,因为其中一些设置涉及在代理和服务器之间传输二进制文件。

TeamCity 代理和 TeamCity 服务器之间最重要的流量流动包括:

  • 代理从服务器获取命令:这些通常是构建启动任务,包括构建配置设置的转储和完整的构建参数集。 这些参数可以在构建的 参数 标签页中进行查看。

  • 代理定期将当前状态数据发送到服务器(这包括可以在代理的 参数 标签页上查看的所有代理参数)。

  • 在构建过程中,代理会将构建日志信息和参数数据发送回服务器。 这些可以在构建的 构建日志参数 标签页中进行查看。

  • (当使用服务器端检出模式时)代理在构建之前(作为全量或增量补丁)从服务器下载源代码。

  • (当配置了 工件依赖项)在开始构建之前,除非使用了外部工件存储,否则代理会从服务器下载其他构建的构建工件。

  • (当为构建配置了工件时)代理将构建工件上传到服务器,除非使用了外部工件存储。

  • 一些运行器(如覆盖率或代码分析)包含了自动上传其结果报告到服务器的功能。

评估外部数据库容量

如果广泛使用 TeamCity 服务器,数据库性能将开始发挥更大的作用。 为确保产品级的性能和可靠性,必须使用外部数据库。 其大小和性能是需要考虑的关键方面。

如果您决定在与服务器(并不推荐)同一台机器上运行外部数据库,请在选择服务器硬件时充分考虑数据库引擎的需求。

在设置或迁移到外部数据库时,很难预估确切的需求,因为所需的容量在很大程度上取决于如何使用 TeamCity。 数据库大小的需求自然会根据存储数据的数量(构建数量,测试数量等)有所不同。 活跃数据库的使用量每年可以估计为几个千兆字节的数据。

数据库大小

数据库的大小取决于:

  • 每天启动了多少次构建

  • 构建中报告了多少个测试

  • 清理 规则(保留策略)和计划

推荐的初始大小为 4 GB。 当从内部数据库迁移时,我们建议至少将当前内部数据库的大小增加一倍。 例如,JetBrains 内部的 TeamCity 服务器的外部数据库(不包括 redo log 文件)的大小约为 1 TB。 将您的数据库设置为自动增长有助于在必要时将文件大小增加到预定的限制,从而最小化监控磁盘空间的工作。

在大多数情况下,为重做日志(请参阅下表)和撤消文件分配 1 GB 的空间就足够了。

数据库性能

以下因素可能会影响数据库性能:

  • 数据库类型(RDBMS)

  • 代理数量(并行运行的构建数量)

  • 所有用户打开的网页数量

  • 清理规则(保留策略)

建议将 TeamCity 数据目录 和数据库数据文件放在物理上不同的硬盘上(即使 TeamCity 服务器和 RDBMS 共享同一个主机)。

建议将重做日志放在单独的物理磁盘上 —— 特别是当有50个或更多的代理时。

特定数据库的注释

各种 RDBMS 的重做日志(或类似实体)命名:

  • RDBMS:日志名称

  • Oracle:重做日志

  • MS SQL Server:事务日志

  • PostgreSQL:WAL(预写式日志)

  • MySQL + InnoDB 和 Percona:Redo Log

PostgreSQL:建议使用9.2+版本,该版本具有许多查询优化功能。 请查看 PostgreSQL 文档 中关于预写式日志(WAL)的信息。

Oracle:建议保持统计信息——所有自动收集的统计信息应该启用(自 Oracle 10.0 版本以后,这是默认设置)。 请参阅 Oracle 文档 中关于重做日志文件的信息。

MS SQL Server :强烈建议不要使用 jTDS 驱动程序 —— 它无法与 nchar/nvarchar 一起使用。 为了保留 Unicode 流,这可能会导致查询花费很长时间并消耗许多 I/O 操作。 请查看 Microsoft Knowledge base 上关于重做日志的信息。 如果您使用 jTDS ,请考虑进行迁移

MySQL:查询优化器可能效率不高:某些查询可能会得到错误的执行计划,导致它们消耗大量时间和 I/O 操作。

最后修改日期: 16日 7月 2024年