TeamCity オンプレミス 2026.1 ヘルプ

ビルドエージェント起動プロパティの設定

TeamCity では、ビルドエージェントに 2 つのプロセスが含まれます。

  • エージェントランチャー — エージェントプロセスを起動する Java プロセス。

  • エージェント — ビルドエージェントのメインプロセス。エージェントランチャーの子プロセスとして実行されます。

ビルドエージェントを agent.bat|sh スクリプト経由で実行するか、Windows サービスとして実行するかにかかわらず、最初にエージェントランチャーが起動し、次にエージェント自体が起動します。スクリプト経由でエージェントを実行することが推奨される方法ですが、場合によってはサービスとして実行する必要がある場合もあります。詳細については、このページを参照してください。

エージェントのプロパティ

上記の両方のプロセスで、エージェントの実行に使用するシステムプロパティと変数を指定することにより、エージェントの最終的な動作をカスタマイズできます。

ビルドエージェントはスクリプトを介して実行されます

<Agent_Home> /bin/agent.bat|sh スクリプトを実行する前に、OS で次の環境変数(英語)を設定します。

  • TEAMCITY_AGENT_MEM_OPTS — エージェントメモリの JVM オプションを設定する (64 ビットエージェントの場合、-Xmx を 512MB に設定することを検討してください)

  • TEAMCITY_AGENT_OPTS — 追加のエージェント JVM オプション

ビルドエージェントはサービスとして実行されます

<Agent_Home> /launcher/conf/wrapper.conf ファイルに、次の行を追加します (オプションごとに 1 行)。

wrapper.app.parameter.<N>

ビルドエージェントは Launchd によって実行されます (macOS)

TeamCity エージェントプロセスが launchd スクリプトによって開始される場合は、対応する .plist ファイルを変更して環境変数を設定する必要があります。次の .plist ファイルエントリは、ビルドエージェントの最大メモリ割り当てプールを 512 MB に増やすように JVM XMX パラメーターを設定します。

<key>EnvironmentVariables</key> <dict> <key>TEAMCITY_AGENT_MEM_OPTS</key> <string>-Xmx512m</string> </dict>

エージェントランチャーのプロパティ

エージェントランチャーのプロパティを変更する必要があるのは、ごくまれなケースです。これらを変更する前に、上記のメインエージェントプロセスのプロパティを変更しても問題が解決しないことを確認してください。

ビルドエージェントはスクリプトを介して実行されます

<Agent_Home> /bin/agent.bat|sh スクリプトを実行する前に、TEAMCITY_LAUNCHER_OPTS 環境変数を設定します。

ビルドエージェントはサービスとして実行されます

<Agent_Home> /launcher/conf/wrapper.conf ファイルに、次の行を追加します (オプションごとに 1 行、N の番号は増加します)。

wrapper.java.additional.<N>
2025 年 4 月 07 日

関連ページ:

TeamCity エージェントをインストールして開始する

TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...

エージェントホームディレクトリ

エージェントホームディレクトリの構築は、エージェントがインストールされているディレクトリです。ビルドエージェントは任意のディレクトリにインストールできます。ビルドエージェントのインストールを選択して TeamCity.tar.gz ディストリビューションまたは .exe ディストリビューションを使用する場合、エージェントはに配置されます。エージェントのインストールで提案されるデフォルトのディレクトリはです。エージェントは関連するすべてのデータをそのディレクトリに保存します。OS へのインストール...

エージェントの表示

TeamCity は、ビルドエージェントの効率を推定し、システムの管理に役立つ便利な方法を提供します。ロード統計マトリックス:エージェントページのマトリックスタブで利用できるマトリックスでは、選択した期間に完了したすべてのビルドのビルドエージェントの全体的なワークロードを俯瞰できます。特定のエージェントと互換性のあるビルド構成を確認することで、ビルド構成を特定のビルドエージェントに割り当て、アイドル時間を大幅に短縮できます。これにより、ハードウェアリソースの使用をより効果的に調整し、発見された...