ビルドエージェント始動プロパティの設定
TeamCity では、 ビルドエージェントに二つのプロセスが含まれます：
エージェントランチャー — エージェントプロセスを起動する Java プロセス。
エージェント — ビルドエージェントのメインプロセス。エージェントランチャーの子プロセスとして実行されます。
ビルドエージェントを agent.bat|sh スクリプトで実行する場合でも Windows サービスとして実行する場合でも、エージェントランチャーが先に起動し、その後でエージェント自体を起動します。 エージェントをスクリプトで実行する方法が推奨されますが、場合によってはサービスとして実行したいことがある点に注意してください。詳細については、 このページを参照してください。
エージェントプロパティ
上記の両方のプロセスで、エージェントの実行に使用するシステムプロパティと変数を指定することにより、エージェントの最終的な動作をカスタマイズできます。
ビルドエージェントをスクリプトで実行
<エージェントホーム>/bin/agent.bat|sh スクリプトを実行する前に、OS で次の 環境変数(英語)を設定します。
TEAMCITY_AGENT_MEM_OPTS— エージェントメモリの JVM オプションを設定する (64 ビットエージェントの場合、-Xmxを 512MB に設定することを検討してください)TEAMCITY_AGENT_OPTS— 追加のエージェント JVM オプション
ビルドエージェントをサービスとして実行
<エージェントホーム>/launcher/conf/wrapper.conf ファイルに、次の行を追加します (オプションごとに 1 行)。
ビルドエージェントを Launchd で実行 (macOS)
TeamCity エージェントプロセスが launchd スクリプトによって開始された場合は、対応する .plist ファイルを変更して環境変数をセットアップする必要があります。 次の .plist ファイルエントリは、ビルドエージェントの最大メモリ割り当てプールを 512 MB に増やすように JVM XMX パラメーターを設定します。
エージェントランチャープロパティ
エージェントランチャーのプロパティを変更する必要があるのは、ごくまれなケースです。 これらを変更する前に、 上記のメインエージェントプロセスのプロパティを変更しても問題が解決しないことを確認してください。
ビルドエージェントをスクリプトで実行
<エージェントホーム>/bin/agent.bat|sh スクリプトを実行する前に、 TEAMCITY_LAUNCHER_OPTS 環境変数を設定します。
ビルドエージェントをサービスとして実行
<エージェントホーム>/launcher/conf/wrapper.conf ファイルに、次の行を追加します (オプションごとに 1 行、 N の番号は増加します)。