配置 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 服务器以使更改生效。
如果您使用 runAll
或 teamcity-server
脚本运行服务器,或作为Windows服务,您需要通过操作系统 环境变量 设置选项,这些变量会传递给 TeamCity 服务器进程:
TEAMCITY_SERVER_MEM_OPTS
— 服务器 JVM 内存选项(例如,-Xmx750m
)。TEAMCITY_SERVER_OPTS
—— 额外的服务器 JVM 选项(例如,-Dteamcity.git.fetch.separate.process=false
)。
设置环境变量的过程取决于您的操作系统。 例如,在 Windows 中,前往 控制面板\系统和安全\系统
并打开 高级系统设置 | 环境变量。
确保已为运行 TeamCity 的用户帐户或者全局环境变量设置环境变量。 您可能需要重新启动操作系统,然后才能使更改生效。