ビルドエージェントの設定とメンテナンス
TeamCity エージェントの詳細の表示
TeamCity Web UI のエージェントページは、TeamCity エージェントに関する包括的な情報を提供します。ページ上のタブの数は、エージェントのセットアップによって異なる場合があります。
接続済み / 切断済み
接続済みタブと切断済みタブには、エージェントがエージェントプール (デフォルト) 順に表示されます。エージェントをアルファベット順に表示するには、エージェントプールによるグループ化ボックスのチェックを外します。
TeamCity は各プールのビルドエージェントのステータスを表示します。プールの横にある矢印をクリックすると、プールエージェントとそのステータスのリストが表示されます。
UI を介したエージェントの有効化 / 無効化
TeamCity は有効なエージェント間でのみビルドを配布します。エージェントの名前の横にあるステータスアイコン（1）をクリックすると、Web UI からエージェントを手動で有効 / 無効にできます。オプションで、しばらくすると自動的にエージェントを無効 / 有効にしてコメントを入力するように TeamCity に指示できます。TeamCity は指示に従い、コメントアイコン（2）を表示します。アイコンにカーソルを合わせると、関連情報が表示されます（3）。
メンテナンスのため無効にするをクリックすると、クラウドエージェントがメンテナンスモードに切り替わります。このモードでは、エージェントは終了せず、エージェントにログインしてログを表示し、その他の操作を実行できます。また、デフォルトでは、新しいビルドではエージェントを使用できません。
プール
TeamCity でのエージェントプールの構成については、別のページを参照してください。
パラメーターレポート
指定されたパラメーターを使用して、使用可能なすべてのエージェントをフィルターに掛けます。
行列と統計
エージェントのワークロードの表示については、別のページを参照してください。
クラウド
構成されたすべてのエージェントクラウドプロファイルを一覧表示します。
差分
2 つのエージェントを比較して、それらの違いをハイライトします。
エージェントをリモートでデバッグする
エージェントをインストールして接続した後、TeamCity UI からこのエージェントのマシンのターミナルを直接呼び出すことができます。この機能を使用すると、エージェントログをリモートで表示したり、インストールされているソフトウェアを確認したり、エージェント固有の問題をデバッグしたりできます。
ターミナルを呼び出すには、TeamCity ヘッダーのエージェントをクリックし、必要なエージェントを選択して、ターミナルを開くをクリックします。
このターミナルはビルド結果ページから開くこともできます。この場合、ターミナルは $HOME フォルダーではなくチェックアウトディレクトリで開きます。
ターミナルが開いたら、別のタブで開くリンクをクリックすると、より大きなクライアント領域が表示されます。
ターミナルを開くボタンは、すべてのタイプのエージェントマシン (Linux、Windows、macOS) で使用でき、TeamCity エージェントを起動するのと同じユーザー ID でターミナルを呼び出します。
メンテナンスの実行中にビルドエージェントがアイドル状態であることを確認するには、ターミナルセッションでは実行中のビルドエージェントが必要であるため、ビルドエージェントを停止せずに無効にします。ビルドエージェントの停止は、以前に開いていたターミナルタブをフリーズし、ユーザーが新しいコマンドを入力できないようにします。
一定時間アイドル状態になると自動的に終了するクラウドエージェントの場合は、ビルドの問題を調査している間にエージェントのマシンを実行したままにしてシャットダウンしないようにするために、「メンテナンスのため無効にします ...」ボタンをクリックすることをお勧めします。
ターミナルを開くリンクは、ロール権限に「対話型エージェントターミナルを呼び出す」権限が含まれているユーザーにのみ表示されます。この権限は、対応するエージェントのエージェントプールに関連付けられているすべてのプロジェクトに付与する必要があります。「プロジェクト管理者」および「システム管理者」ロールを持つユーザーには、デフォルトでこのような権限が付与されます。追加の予防策として、ターミナルを開く各要求は、監査ログに新しい「エージェントアクション | エージェントに接続」アクティビティとして書き込まれます。
関連ページ：
エージェントプールの構成
ビルドエージェントの共通セットを 1 つ持つ代わりに、エージェントプールと呼ばれる個別のグループに分割できます。プールは、プロジェクトを割り当てることができるエージェントの名前付きセットです。エージェントは 1 つのプールにのみ所属できます。プロジェクトではビルドに複数のプールを使用できます。TeamCity サーバーによって承認されるエージェントの数は、エージェントライセンスの数によって制限されます。デフォルトでは、新しく承認されたすべてのエージェントがデフォルトプールに含まれます。エージェント...
エージェントの表示
TeamCity は、ビルドエージェントの効率を推定し、システムの管理に役立つ便利な方法を提供します。ロード統計マトリックス：エージェントページのマトリックスタブで利用できるマトリックスでは、選択した期間に完了したすべてのビルドのビルドエージェントの全体的なワークロードを俯瞰できます。特定のエージェントと互換性のあるビルド構成を確認することで、ビルド構成を特定のビルドエージェントに割り当て、アイドル時間を大幅に短縮できます。これにより、ハードウェアリソースの使用をより効果的に調整し、発見された...
クラウドのホストビルドエージェント
TeamCity とクラウド (IaaS) ソリューションの統合により、TeamCity は TeamCity エージェントをオンデマンドで実行する仮想マシンを提供できるようになります。これにより、TeamCity は現在のワークロードに応じてアクティブなビルドエージェントの数を自動的に調整できます。クラウドエージェントとエグゼキューター：TeamCity は次の 2 種類の統合をサポートしています。通常のクラウドエージェント。この統合タイプでは、ビルドエージェントをホストする環境として、クラ...
ビルド結果ページ
TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ (概要、変更、ビルドログ、アーティファクトなど) と、特定の構成機能に応じて表示が決まるコンテキストタブが含まれます。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID...
ビルドチェックアウトディレクトリ
ビルドチェックアウトディレクトリは、特定の VCS ルートからのビルドソースがチェックアウトされる TeamCity エージェントマシン上のディレクトリです。ビルド構成が同じ VCS ルートで構成されている場合、このディレクトリは複数のビルド構成間で共有できます。詳細については、デフォルトのチェックアウトディレクトリおよびカスタムチェックアウトディレクトリを参照してください。チェックアウトプロセス：チェックアウトプロセスは、次のように VCS チェックアウトモードの影響を受けます。エージェント側チ...
高可用性のためのマルチノードセットアップ
TeamCity サーバーは、高可用性と柔軟な負荷分散のために複数のノード (またはサーバー) を使用するように構成できます。TeamCity ノードのクラスターをセットアップすることが可能です。各ノードは、ビルドからのデータの処理や VCS リポジトリからの変更の収集など、さまざまなタスクを担当します。または、すべての作業を行うメインノードを 1 つと、読み取り専用インターフェースを提供するセカンダリノードを 1 つ保持します。メインノードがダウンした場合、最小限のダウンタイムですべてのデータ...