TeamCity On-Premises 2024.03 Help

配置 TeamCity 服务器启动属性

可以通过在其启动时传递的选项来定制 TeamCity 服务器行为的各个方面:

  • 影响 TeamCity 本身的内部属性

  • Java 虚拟机 (JVM) 属性

TeamCity 内部属性

TeamCity 具有影响内部逻辑各个方面的内部配置属性。 这些通常用于调试、更改内部常量,或启用实验性行为。

除非 TeamCity 支持团队要求,否则请不要更改内部属性。如果您定制了内部属性,在联系 TeamCity 支持时,请确保注意到这一点。

服务器管理员可以在 TeamCity UI 中查看和编辑内部属性。 要做到这一点,您需要前往管理 | 服务器Administration | Diagnostics | 内部属性,然后点击编辑内部属性
许多属性无需重启服务器,但有些则需要。 当需要重启时,通常会特别指出。

属性被存储在 <TeamCity 数据目录>/config/internal.properties 文件中。 这是一个 Java properties 文件。 您可以手动编辑文件,并在单独的行上添加每个 <属性名称>=<属性值>

添加内部属性的另一种但已过时的方法是将其作为 -D<名称>=<值> JVM 选项传递(参见下面的 部分)。

JVM 选项

如果您需要向 TeamCity 服务器传递额外的 JVM 选项(例如, -D-X... ),具体方法将取决于运行服务器的方式。 您需要 restart 服务器以使更改生效。

如果您使用 runAllteamcity-server 脚本运行服务器,或作为Windows服务,您需要通过操作系统 环境变量 设置选项,这些变量会传递给 TeamCity 服务器进程:

  • TEAMCITY_SERVER_MEM_OPTS — 服务器 JVM 内存选项(例如, -Xmx750m)。

  • TEAMCITY_SERVER_OPTS—— 额外的服务器 JVM 选项(例如, -Dteamcity.git.fetch.separate.process=false)。

设置环境变量的过程取决于您的操作系统。 例如,在 Windows 中,前往 控制面板\系统和安全\系统 并打开 高级系统设置 | 环境变量

确保已为运行 TeamCity 的用户帐户或者全局环境变量设置环境变量。 您可能需要重新启动操作系统,然后才能使更改生效。

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