特定のビルドエージェントへのビルド構成の割り当て
ビルドエージェントのワークロードをより効率的に管理する必要がある場合があります。 例: 時間のかかるパフォーマンステストを実行すると、ハードウェアリソースが少ないビルドエージェントの速度が低下する可能性があります。 その結果、 ビルドキューに入るビルドが増え、フィードバックループが想定よりも長くなる可能性があります。 このような状況を回避するには、次の操作を実行します。
エージェントに対して 実行構成ポリシーを設定し、このエージェントで実行するビルド構成を定義します。
ビルド構成でビルドを実行できるエージェントのプールを制限するために、特別な エージェント要件を定義します。 これらの要件は以下のとおりです。
ビルドエージェント名。 ビルドエージェントの名前が必須になっている場合、ビルド構成はこのエージェントでのみビルドを実行します。
ビルドエージェントプロパティ。 特定のプロパティ、たとえば特定の構成またはオペレーティングシステムのビルドを実行する機能が要件になっている場合、ビルド構成はこの要件を満たすエージェントでビルドを実行します。
エージェントプール
エージェントをプールに分割することができます。 各プロジェクトは、いくつかのプールに関連付けることができます。 エージェントプールを参照してください。
実行構成ポリシーの設定
ビルドエージェントの実行構成ポリシーを確立するには、以下のようにします。
エージェント をクリックして目的のビルドエージェントを選択します。
互換性のある構成 タブをクリックします。
現在の実行構成ポリシー オプションを 割り当てられた構成のみを実行 に設定します。
構成を割り当て ボタンをクリックし、ビルドエージェントで実行する目的のビルド構成名にチェックマークを付けます。
ビルドエージェントのお名前とプロパティをビルド構成要件にする
ビルド構成を作成するには、指定された名前とプロパティを使用してビルドエージェントでビルドを実行します。
管理 をクリックして、目的のビルド構成を選択します。
左側のナビゲーションパネルで エージェント要件 タブを選択します (エージェント要件の設定を参照)。
新しい要件を追加する をクリックし、 パラメーター名 フィールドに「teamcity.agent.name」と入力します。
条件を「等しい」に変更し、 値 フィールドにエージェントの完全な名前を入力します。
次の Kotlin スニペットは結果を示しています。
必要に応じて、この要件を次のように変更できます。
条件 を「等しい」から非厳密な演算子 (「含む」など) に変更して、複数の類似した名前のエージェントを含めます。 たとえば、
startsWith("teamcity.agent.name", "NightlyAgent")条件では、「NightlyAgent1」、「NightlyAgent_24」、「NightlyAgent.A」、名前が要件を満たすその他のビルドエージェントでビルドを実行できます。名前ではなくオペレーティングシステムでエージェントを選択するには、
teamcity.agent.jvm.os.nameパラメーターを使用します。 例:equals("teamcity.agent.jvm.os.name", "Mac OS X")。