エージェントプールの構成
ビルドエージェントの共通セットを 1 つ持つ代わりに、エージェントプールと呼ばれる個別のグループに分割できます。プールは、プロジェクトを割り当てることができるエージェントの名前付きセットです。
エージェントは 1 つのプールにのみ所属できます。
プロジェクトではビルドに複数のプールを使用できます。
TeamCity サーバーによって承認されるエージェントの数は、エージェントライセンスの数によって制限されます。デフォルトでは、新しく承認されたすべてのエージェントがデフォルトプールに含まれます。
エージェントプールを使用すると、特定のエージェントを特定のプロジェクトにバインドできます。プロジェクトビルドは、プロジェクトに割り当てられたプールのビルドエージェントでのみ実行できます。さらに、エージェントプールを使用すると、必要なエージェントの容量を簡単に監視できます。
エージェントプールを使用すると、次のことが可能になります。
特定のエージェントを特定のプロジェクトにバインドする: プロジェクトビルドは、プロジェクトに割り当てられたプールのビルドエージェントでのみ実行できます。
プールによるビルドキューのフィルタリング。
エージェントマトリックスとエージェント統計ページでプールによるグループ化を使用します。
必要なエージェントの容量を監視します。
必須アクセス権
プールを追加 / 削除し、プール内のエージェントの最大数を設定するには、「エージェントプールの管理」権限が必要です。デフォルトでは、これらの権限はシステム管理者とエージェントマネージャーのロールに付与されています。
プールへのプロジェクトおよびエージェントの割り当てと割り当て解除は、「プロジェクトに関連付けられたエージェントプールの変更」権限によって制限されます。この権限は、デフォルトではプロジェクト管理者ロールの一部です。ユーザーは、操作の影響を受けるすべてのプールに関連付けられたすべてのプロジェクトに対して「プロジェクトに関連付けられたエージェントプールの変更」権限を持っている場合にのみ、プールで操作を実行できます。
関連するエージェント管理権限も参照してください。
エージェントプールの管理
ビルドエージェントは、UI ヘッダーにあるエージェントページで管理できます。従来の UI モードを使用している場合は、この記事で説明されているものとは異なるナビゲーションシステムがあることに注意してください。プールはエージェント | プールタブで管理されます。
エージェントサイドバーを使用すると、既存のエージェントプール間を移動し、エージェントのステータスをリアルタイムで表示できます。
新しいプールを作成するには、サイドバーの + をクリックし、その名前を入力します。
デフォルトでは、プールには無制限の数のエージェントが含まれます。プール内のエージェントの最大数を設定できます ( デフォルトプールには適用されません)。エージェントの最大数に達すると、TeamCity はこのプールに新しいエージェントを追加することを許可しません。これには、他のプールからのエージェントの移動とクラウドエージェントの自動承認が含まれます。ターゲットプールがいっぱいの場合、新しいクラウドエージェントは起動しません。
特定のプールまたはそのネストされたエージェントの詳細を表示するには、サイドバーでその名前をクリックします。
エージェントタブ
プールにエージェントを追加するには、サイドバーで対象のプールをクリックし、エージェントタブでエージェントを割り当てるをクリックして、リストから必要なエージェントを選択します。エージェントは 1 つのプールにしか属することができないため、プールに割り当てると、以前のプールから削除されます。TeamCity がこのアクションによって互換性の問題が発生する可能性があることを検出すると、対応する警告が表示されます。カスタムプールからエージェントを削除すると、そのエージェントはデフォルトプールに戻ります。
クラウドエージェントをプールに割り当てるには、エージェントクラウドプロファイルのクラウドイメージの詳細で設定する必要があります。現在のプロジェクトのすべてのクラウドプロファイルのエージェントは、プロジェクトプールに自動的に結合されることに注意してください。
<Root> プロジェクトで構成されたクラウドエージェントイメージのみをエージェントを割り当てるを使用して移動できます。
「プロジェクト」タブ
プロジェクトタブでは、プロジェクトが利用できるエージェントプールを指定できます。
プロジェクトのリストを参照して、現在選択されているプールに属するエージェント上でビルドを実行できるプロジェクトを確認します。
「プロジェクトを割り当てる」ボタンをクリックして、必要なプロジェクトがこのプールを利用できるようにします。
ターゲットプロジェクトがこのプールを使用できないようにするには、解離するボタンをクリックします。
既存のすべてのエージェントプールからプロジェクトのバインドを解除すると、このプロジェクトのビルド構成を実行できなくなることに注意してください (完全にエージェントレスビルドステップで構成されている場合を除く)。
お気に入りのプール
プール名の横にある星アイコンをクリックすると、プールをブックマークできます。
お気に入りのプールは、サイドナビゲーションペインの上部に固定されます。「お気に入り」セクションでは、すべてのお気に入りプールのすべてのエージェントとクラウドイメージを表示することもできます。
お気に入りのプールはユーザー固有です。つまり、各 TeamCity ユーザーは独自のお気に入りのエージェントプールのセットを持つことができます。
関連ページ：
TeamCity エージェントをインストールして開始する
TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...
ライセンスポリシー
価格と新規ライセンス / アップグレードについては、公式 Web サイトから入手できます。ライセンス条件、ライセンスキーの取得またはアップグレード、その他の関連トピックについてご質問がある場合は、JetBrains セールス部門にお問い合わせください。TeamCity ライセンス契約は、公式 Web サイトまたはインストールされた TeamCity サーバー Web UI のフッターで確認できます。ライセンスの概要：JetBrains では、ニーズに合わせて TeamCity を拡張できるライセ...
エージェントの表示
TeamCity は、ビルドエージェントの効率を推定し、システムの管理に役立つ便利な方法を提供します。ロード統計マトリックス：エージェントページのマトリックスタブで利用できるマトリックスでは、選択した期間に完了したすべてのビルドのビルドエージェントの全体的なワークロードを俯瞰できます。特定のエージェントと互換性のあるビルド構成を確認することで、ビルド構成を特定のビルドエージェントに割り当て、アイドル時間を大幅に短縮できます。これにより、ハードウェアリソースの使用をより効果的に調整し、発見された...
ロールと権限の管理
TeamCity のユーザーアクセスレベルは、ユーザーに異なるロールを割り当てて、それぞれの権限を付与することによって処理されます。権限とは、ビルドを実行したり、ビルド構成設定を変更したりするなど、特定の操作を実行するための承認です。ロールとは、1 つまたはすべてのプロジェクトでユーザーに付与できる権限のセットであり、プロジェクトや UI のさまざまな機能へのアクセスを制御します。認証モード：TeamCity 認証は、シンプルモードと per-project モードの 2 つのモードをサポートしま...
ビルドエージェントの詳細の表示
エージェントの状態と情報を表示するには、その名前をクリックするか、エージェントページに移動し、接続、切断、許可されたエージェントのリストでエージェントを見つけて、その名前をクリックします。接続されたエージェントごとに、TeamCity は次の情報を提供します。エージェント概要：状況: エージェントのステータスの詳細。詳細: エージェント名、エージェントのホスト IP アドレス、TeamCity サーバーがエージェントに接続するために使用するポート、エージェントとサーバー間のデータ転送に使用される通...
クラウドのホストビルドエージェント
TeamCity とクラウド (IaaS) ソリューションの統合により、TeamCity は TeamCity エージェントをオンデマンドで実行する仮想マシンを提供できるようになります。これにより、TeamCity は現在のワークロードに応じてアクティブなビルドエージェントの数を自動的に調整できます。クラウドエージェントとエグゼキューター：TeamCity は次の 2 種類の統合をサポートしています。通常のクラウドエージェント。この統合タイプでは、ビルドエージェントをホストする環境として、クラ...