TeamCity オンプレミス 2025.11 ヘルプ

1 台のマシンに複数のエージェントをインストールする

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

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

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

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

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

1 つのエージェントをインストールした後は、通常のインストール手順に従って追加のエージェントをインストールできます(下記の Windows サービスの例外を参照)。ただし、以下のことを確認してください。

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

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

  • エージェントは、 buildAgent.properties ファイル内に独自の workDir および tempDir ディレクトリを持っています。

  • buildAgent.properties name および ownPort プロパティの値は一意です。

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

通常、新しいエージェントをインストールする場合は、tempworklogssystem ディレクトリを除く既存のエージェントのディレクトリを新しい場所にコピーするだけです。次に、conf/buildAgent.properties を新しい name および ownPort 値で変更します。authorizationToken プロパティをクリア(値を削除または削除)し、workDirtempDir が相対的であること / 他のエージェントと衝突しないことを確認します。

Windows での 2 番目のビルドエージェントの構成

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

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

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

macOS での 2 番目のビルドエージェントの構成

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 ファイルを編集して、以下のパラメーターを設定します。

      • Label パラメーターを 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
2025 年 4 月 07 日

関連ページ:

エージェントのインストールを構成する

ビルドエージェントは、ファイルで調整することで構成できます。一般的なエージェント設定:この Java プロパティ構成ファイルには、エージェントプロパティとしてサーバーに公開され、エージェント要件式に参加できるプロパティを保存できます。ファイルで定義されているすべてのシステムプロパティと環境プロパティは、エージェントで実行されるすべてのビルドに渡されます。構文リファレンス: 構文を使用します。コメントには、行の最初の位置にを使用します。パス区切り文字として、の代わりにを使用します。を含める必要がある...

TeamCity エージェントをインストールする

TeamCity ビルドエージェントをインストールする前に、必ずシステム要件を参照してください。便利なインストールオプションを選択してください。Windows では、エージェントの手動起動を使用する代わりに、ビルドエージェントの Windows サービスをインストールすることをお勧めします。エージェントプッシュ経由でインストール:TeamCity は、ビルドエージェントをリモートホストにインストールできるようにするエージェントプッシュ機能を提供します。サーバーホストプラットフォームとビルドエー...