ビルドエージェントの構成とメンテナンス

TeamCity エージェント詳細の表示

TeamCity ウェブ UI の エージェント ページでは、TeamCity エージェントに関する包括的な情報を確認できます。 ページ上のタブの数は、エージェントのセットアップによって異なる場合があります。

接続済み / 切断済み

接続済み タブと 切断済み タブでは、エージェントが エージェントプール (デフォルト) ごとに表示されます。 エージェントをアルファベット順に表示するには、 エージェントプールでグループ化 ボックスのチェックを外します。
TeamCity は各プールについて、そのビルドエージェントのステータスを表示します。 プールの横にある矢印をクリックすると、そのプールのエージェントとステータスの一覧が表示されます。

UI でのエージェントの有効化/無効化

TeamCity は有効化されたエージェント間でのみビルドを配布します。 エージェントの名前の横にあるステータスアイコン（1）をクリックすると、Web UI からエージェントを手動で有効 / 無効にできます。 必要に応じて、一定時間後にエージェントを自動的に無効化/有効化し、コメントを入力するよう TeamCity に指示できます。 TeamCity は指示に従い、コメントアイコン (2) を表示します。 アイコンにカーソルを合わせると、関連情報が表示されます（3）。

メンテナンスのため無効化 をクリックすると、クラウドエージェントがメンテナンスモードに切り替わります。 このモードでは、エージェントは終了せず、エージェントにログインしてログを表示し、その他の操作を実行できます。 また、デフォルトでは、新しいビルドではエージェントを使用できません。

エージェントをリモートでデバッグする

エージェントをインストール、接続、 承認した後、TeamCity UI からこのエージェントのマシンのターミナルを直接呼び出すことができます。 この機能を使用すると、エージェントログをリモートで表示したり、インストールされているソフトウェアを確認したり、エージェント固有の問題をデバッグしたりできます。

未承認のエージェントではターミナルを使用できません: TeamCity は信頼するよう指示されていないマシンとは通信せず、そのようなエージェントでは ターミナルを開く ボタンを非表示にします。 承認に失敗するクラウドインスタンスをデバッグするには、代わりにクラウドプロバイダー独自のツールを使用してください。たとえば、AWS コンソールから EC2 インスタンスに接続します。

ターミナルを起動するには、TeamCity ヘッダーで エージェント をクリックし、必要なエージェントを選択して、 ターミナルを開く をクリックします。

このターミナルは ビルド結果ページ から開くこともできます。 この場合、ターミナルは $HOME フォルダーではなく チェックアウトディレクトリで開きます。

ターミナルが開いたら、 別のタブで開く リンクをクリックすると、より大きなクライアント領域が表示されます。

ターミナルを開く ボタンは、すべてのタイプのエージェントマシン (Linux、Windows、macOS) で使用でき、TeamCity エージェントを起動するユーザーと同じユーザー ID でターミナルを呼び出します。

メンテナンスの実行中にビルドエージェントがアイドル状態であることを確認するには、ターミナルセッションでは 実行中のビルドエージェントが必要であるため、ビルドエージェントを停止せずに無効にします。 ビルドエージェントの停止は、以前に開いていたターミナルタブをフリーズし、ユーザーが新しいコマンドを入力できないようにします。

一定時間アイドル状態になると自動的に終了するクラウドエージェントの場合は、ビルドの問題を調査している間にエージェントのマシンを実行したままにしてシャットダウンしないようにするために、 「メンテナンスのため無効にします ...」ボタンをクリックすることをお勧めします。

ターミナルを開く リンクは、 ロール権限に 「対話型エージェントターミナルを呼び出す」権限が含まれているユーザーにのみ表示されます。 この権限は、対応するエージェントのエージェントプールに関連付けられているすべてのプロジェクトに付与する必要があります。 「プロジェクト管理者」および「システム管理者」ロールを持つユーザーには、デフォルトでこのような権限が付与されます。 追加の予防策として、ターミナルを開く各要求は、 監査ログに新しい「エージェントアクション | エージェントに接続」アクティビティとして書き込まれます。