TeamCity オンプレミス 2025.11 ヘルプ

ビルドエージェントの詳細の表示

エージェントの状態と情報を表示するには、その名前をクリックするか、エージェントページに移動し、接続、切断、許可されたエージェントのリストでエージェントを見つけて、その名前をクリックします。

接続されたエージェントごとに、TeamCity は次の情報を提供します。

エージェント概要

  • 状況 : エージェントのステータスの詳細

  • 詳細 :

    • エージェント名

    • エージェントのホスト IP アドレス

    • TeamCity サーバーがエージェントに接続するために使用するポート

    • エージェントとサーバー間のデータ転送に使用される通信プロトコル

    • エージェントのオペレーティングシステム

    • CPU ランク: バンドルされた CPU ベンチマークの結果。ベンチマークの結果は、エージェントが使用する JVM バージョンとオプションに依存することに注意してください。例: -server JVM オプションは、結果に大きな影響を及ぼします。CPU ベンチマークは、サーバーがエージェント間でビルドを配布する方法にも影響します。エージェントのビルド期間の見積もりを計算できない場合(このエージェントで実行された履歴にビルドがなかった場合)、TeamCity は CPU ベンチマーク値に基づいて最速のエージェントを選択します。

    • エージェントが所属するプール

    • エージェントランチャーバージョン

    • ターミナルを開くボタン。対話型のブラウザーベースのシェルを開きます。「対話型エージェントターミナルを呼び出す」権限を持つユーザーが利用できます (デフォルトでは、この権限はシステム管理者とプロジェクト管理者に付与されます)。詳細については、このヘルプ記事を参照してください: エージェントをリモートでデバッグします

  • エージェント上で実行中のビルドがある場合、ページにはビルドに関する情報とビルド結果へのリンクが表示されます。

  • その他 : このセクション

    • エージェントのクリーンソース

    • リモートデスクトップを開く: RDP クライアントがインストールされ、エージェントに登録されている場合、Windows オペレーティングシステムで実行されているエージェントで使用できます。

    • エージェントマシンを再起動します: ビルドエージェントマシンを再起動する権限を持つユーザーが利用できます。リンクをクリックして、再起動アクションを確認してください。デフォルトでは、TeamCity エージェントは現在のビルドが完了するまで待機します。チェックボックスをオフにして再起動をクリックすると、エージェントがすぐに再起動されます。
      再起動コマンドの追加設定が可能です。エージェントの再起動を参照してください。

    • エージェントマシン上のスレッドとメモリスナップショットをダンプする

エージェントの再起動

エージェントの再起動は、OS 固有のコマンドを実行することにより実行されます。特定の状況では、コマンドは OS 環境に固有のカスタマイズを必要とする場合があります。デフォルトの再起動コマンドが失敗した場合、追加の設定が必要になる場合があります。

エージェントの再起動を調整するには、再起動が必要なときに実行するコマンドを使用して、teamcity.agent.reboot.command エージェント構成パラメーターを buildagent.properties ファイルに追加します。設定例:

teamcity.agent.reboot.command=sudo shutdown -r 60

または

teamcity.agent.reboot.command=shutdown -r -t 60 -c "TeamCity Agent reboot command" -f

ビルド履歴

エージェントで実行されたビルドを表示します。

特定のクラウドイメージから生成されたエージェントで実行されるすべてのビルドを表示するには、エージェントページに移動し、必要なイメージを選択して、ビルド履歴タブに切り替えます。特定のクラウドエージェントが利用できなくなった場合でも、そのビルドを参照することもできます。これを行うには、検索ボックスにその名前を入力します。

History for deleted agent

互換性のある構成

互換性のないビルド構成と互換性のないビルド構成を表示します。

ビルドランナー

ビルドエージェントでサポートされているビルドランナーを一覧表示します。

ログ

このページでは、ログを表示およびダウンロードできます。

パラメーター

このタブには、システムプロパティ、環境変数、構成パラメーターが一覧表示されます。さまざまな型のパラメーターの詳細については、ビルドパラメーターの設定ページを参照してください。

New Agent Parameters tab
2025 年 11 月 03 日

関連ページ:

TeamCity エージェントをインストールして開始する

TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...

エージェントプールの構成

ビルドエージェントの共通セットを 1 つ持つ代わりに、エージェントプールと呼ばれる個別のグループに分割できます。プールは、プロジェクトを割り当てることができるエージェントの名前付きセットです。エージェントは 1 つのプールにのみ所属できます。プロジェクトではビルドに複数のプールを使用できます。TeamCity サーバーによって承認されるエージェントの数は、エージェントライセンスの数によって制限されます。デフォルトでは、新しく承認されたすべてのエージェントがデフォルトプールに含まれます。エージェント...

ビルド結果を扱う

TeamCity には、ホームと設定という 2 つのメインモードがあります。ホームモードでは、プロジェクトレベルとビルド構成レベルでビルド結果が蓄積されます。新しい TeamCity UI を使用している場合は、プロジェクトサイドバーを介してこの階層間を移動できます。各モードには、独自の詳細レベルがあります。プロジェクト全体のビルド統計を確認するには、プロジェクトホームにアクセスしてください。単一のビルド構成の詳細を参照するには、その名前をクリックしてビルド構成ホームを開きます。ホームページで特...

クリーンチェックアウト

クリーンチェックアウト(クリーンなソースとも呼ばれる)は、次のビルドで VCS からすべてフェッチされたソースのコピーを確実に取得する操作です。ビルドチェックアウトディレクトリのすべてのコンテンツが削除され、ソースがバージョン管理から再フェッチされます。クリーンチェックアウトの実施:新規ファイルの追加、既存ファイルの変更または削除によって、チェックアウトディレクトリの内容が外部プロセスによって変更された場合は、クリーンチェックアウトをお勧めします。以下の手順を実行することで、ソースのクリーニン...

クラウドのホストビルドエージェント

TeamCity とクラウド (IaaS) ソリューションの統合により、TeamCity は TeamCity エージェントをオンデマンドで実行する仮想マシンを提供できるようになります。これにより、TeamCity は現在のワークロードに応じてアクティブなビルドエージェントの数を自動的に調整できます。クラウドエージェントとエグゼキューター:TeamCity は次の 2 種類の統合をサポートしています。通常のクラウドエージェント。この統合タイプでは、ビルドエージェントをホストする環境として、クラ...

ビルドパラメーターの設定

パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型:TeamCity は次の 3 種類のパラメーターをサポートします。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...