TeamCity オンプレミス 2025.11 ヘルプ

TeamCity サーバー起動プロパティの設定

TeamCity サーバーの動作のさまざまな側面は、起動時に渡されるオプションを介してカスタマイズできます。

  • TeamCity 自体に影響を与える内部プロパティ

  • Java 仮想マシン(JVM)のプロパティ

TeamCity の内部プロパティ

TeamCity には、内部ロジックのさまざまな側面に影響を与える内部構成プロパティがあります。これらは通常、デバッグ、内部定数の変更、実験的な動作の有効化を目的としています。

TeamCity サポートチームからの要請がない限り、内部プロパティを変更しないでください。内部プロパティをカスタマイズしている場合は、TeamCity サポートに連絡するときにこれに注意してください。

サーバー管理者は、TeamCity UI で内部プロパティを確認および編集できます。これを行うには、管理 | サーバー管理 | 診断 | 内部プロパティに移動して内部プロパティを編集するをクリックします。
多くのプロパティではサーバーの再起動は必要ありませんが、一部のプロパティでは再起動が必要です。再起動が必要な場合は、通常、その旨が明記されます。

プロパティは、 <TeamCity Data Directory> /config/internal.properties ファイルに保存されます。これは Java プロパティファイル(英語)です。ファイルを手動で編集し、各 <property_name>=<property_value> を別々の行に追加できます。

内部プロパティを追加する別の方法としては、それを -D<name>=<value> JVM オプションとして渡すという方法がありますが、これは廃止されています ( 以下のセクションを参照)。

JVM オプション

追加の JVM オプションを TeamCity サーバー(たとえば、-D または -X...)に渡す必要がある場合、アプローチはサーバーの実行方法によって異なります。変更を有効にするには、サーバーを再起動する必要があります。

runAll または teamcity-server スクリプトを使用して、または Windows サービスとしてサーバーを実行する場合は、TeamCity サーバープロセスに渡される OS 環境変数を介してオプションを設定する必要(英語)があります。

  • TEAMCITY_SERVER_MEM_OPTS — サーバーの JVM メモリオプション(たとえば、-Xmx750m)。

  • TEAMCITY_SERVER_OPTS — 追加のサーバー JVM オプション(たとえば、-Dteamcity.git.fetch.separate.process=false)。

環境変数を設定するプロセスは、オペレーティングシステムによって異なります。例: Windows では、Control Panel\System and Security\System に移動し、高度なシステム設定 | 環境変数を開きます。

アカウントが TeamCity の実行に使用されているユーザーに対して、またはグローバル環境変数として環境変数が設定されていることを確認してください。変更を有効にするには、OS を再起動する必要がある場合があります。

2025 年 4 月 07 日

関連ページ:

サポートとトラブルシューティング

TeamCity で問題が発生した場合は、まずよくある問題および既知の問題ページをチェックして、発生している問題に関する既存のガイダンスがあるかどうかを確認することをお勧めします。追加のサポートが必要な場合は、いくつかの便利なオプションをご用意しています。課題トラッカー (公開、非公開オプションあり): バグや機能リクエストを記録します。サポートチケット (プライベート): 有効なエンタープライズサーバーライセンスをお持ちのお客様のみが、サポートチームから直接サポートを受けることができます。コミュニ...

TeamCity データディレクトリ

TeamCity データディレクトリは、TeamCity サーバーが構成、ビルド結果、現在の操作ファイルを保存するために使用するファイルシステム上のディレクトリです。このディレクトリは、すべての構成設定の 1 次ストレージであり、TeamCity のインストールに不可欠なデータを保持します。ビルド履歴、ユーザーとそのデータ、その他のデータはデータベースに保存されます。ディレクトリとデータベースに保存されるデータの説明については、バックアップに関する注意事項を参照してください。このドキュメントや他...

TeamCity サーバーを起動

サーバーの起動:TeamCity がまたはディストリビューションを使用してインストールされている場合、ディレクトリにあるスクリプトによって起動および停止できます。スクリプトは、(同じコンソールで実行)、(新しい分離プロセスを開始してスクリプトを終了)、およびコマンドを受け入れます。TeamCity を再起動するには、を送信し、停止したらを送信します。(評価のみ)TeamCity サーバーと 1 つのデフォルトエージェントを同時に起動 / 停止するには、スクリプトを使用、例: を使用して、サーバー...