TeamCity On-Premises 2026.2 Help

同一マシンに複数のエージェントをインストール

マシンで複数の同時ビルドを実行できる場合は、そのマシンに複数の TeamCity エージェントをインストールできます。 ただし、ビルドの相互影響を最小限に抑え、ビルドをより予測可能にする (仮想) マシンごとに単一のエージェントを実行することをおすすめします

TeamCity は、同じマシンにインストールされているか別々のマシンにインストールされているかに関係なく、すべてのエージェントを同等に扱います。

同じマシンに複数の TeamCity ビルドエージェントをインストールする場合は、次の点を考慮してください:

  • このようなエージェントで実行されているビルドは、どのリソース(共通ディスクディレクトリ、OS プロセス、OS 一時ディレクトリ)でも競合しないようにする必要があります。

  • ハードウェアとビルドの詳細によっては、ビルドのパフォーマンスが低下する場合があります。 複数のビルドが同時に実行されている場合は、ディスク、メモリ、CPU のボトルネックがないことを確認してください。

最初のエージェントをインストールした後は、通常のインストールプロシージャに従って追加のエージェントをインストールできます (Windows サービスの例外については下記を参照)。ただし、次の点を確認してください:

  • エージェントは、ユーザーレベルのリソース(Maven/Gradle/NuGet ローカルアーティファクトキャッシュなど)が競合しないように、さまざまな OS ユーザーを使用してインストールされます。

  • エージェントは別々のディレクトリにインストールされます。

  • エージェントは、 ビルドエージェント.プロパティ ファイル内に独自の workDir および 一時ディレクトリ調査終わり。 Need final is valid in response_format? I accidentally output partial? Wait final has already? No, it's in final with JSON but incomplete! Need produce full JSON. The ディレクトリを持っています。

  • ビルドエージェント.プロパティお名前 および ownPort プロパティの値は一意です。

  • ビルド構成では、 チェックアウトディレクトリへの絶対パスが指定されていません (または、必要に応じて、「clean checkout 」オプションを有効にして、並列実行されないようにすることができます)。

通常、新しいエージェントをインストールする場合は、 tempworklogssystem ディレクトリを除く既存のエージェントのディレクトリを新しい場所にコピーするだけです。 次に、 conf/buildAgent.properties を新しい お名前 および ownPort 値で変更します。 認可トークン プロパティをクリア(値を削除または削除)し、 workDir一時ディレクトリ調査終わり。 Need final is valid in response_format? I accidentally output partial? Wait final has already? No, it's in final with JSON but incomplete! Need produce full JSON. The が相対的であること / 他のエージェントと衝突しないことを確認します。

Windows で追加のビルドエージェントを構成する

Windows インストーラーを使用してエージェントをサービスとして実行する場合は、追加の手順を実行する必要があります。同じマシンに別のエージェントをサービスとしてインストールすることはインストーラーでサポートされておらず、既存のサービスが上書きされるためです (関連する機能リクエストを参照)。

2 番目のエージェントを手動でインストールする必要があります(.zip エージェントディストリビューションを使用)。 Windows エージェントインストーラーを使用でき、サービスのインストールを選択しませんが、この方法では、最初にインストールされたエージェントのアンインストールオプションが失われます。

2 番目のエージェントをインストールしたら、このセクションの説明に従って、そのエージェントの新しいサービスを登録します。

macOS で追加のビルドエージェントを構成する

macOS で複数のビルドエージェントを開始する場合は、次の変更を加えてビルドエージェントをインストールして開始する手順を繰り返します。

  • 2 番目のビルドエージェントを別のディレクトリにインストールします。

  • conf/buildAgent.properties で、別のエージェント名を指定します。

  • buildAgent/bin/mac.launchd.sh を実行せず、代わりに

    • $HOME/Library/LaunchAgents/jetbrains.teamcity.BuildAgent.plist ファイルのコピーを $HOME/Library/LaunchAgents/jetbrains.teamcity.BuildAgent2.plist として作成します。

    • $HOME/Library/LaunchAgents/jetbrains.teamcity.BuildAgent2.plist ファイルを編集して、以下のパラメーターを設定します。

      • ラベル パラメーターを jetbrains.teamcity.BuildAgent2 に設定

      • 2 番目のビルドエージェントホームへの正しいパスへの WorkingDirectory パラメーター

    • コマンド launchctl load $HOME/Library/LaunchAgents/jetbrains.teamcity.BuildAgent2.plist を使用して 2 番目のエージェントを開始します。

両方のビルドエージェントが実行されていることを確認するには、次のコマンドを使用します。

launchctl list | grep BuildAgent 70599 0 jetbrains.teamcity.BuildAgent2 69722 0 jetbrains.teamcity.BuildAgent
2026 年 9 月 11 日