TeamCity On-Premises 2026.2 Help

リモートデバッグ

リモートデバッグは、ローカルの開発者マシン上の IDE から TeamCity エージェントマシン上のテストをリモートでデバッグできる機能です。 この機能は、エージェント環境が何らかの点で固有であり、テストが失敗し、問題をローカルで再現するのが困難な場合に役立ちます。

IntelliJ ベース IDE 向け TeamCity 統合を有効にすると、IntelliJ IDEA Project および Ant ビルドステップに基づくビルドのリモートデバッグセッションを IntelliJ IDEA から直接起動できます。

現在、次の IntelliJ IDEA 実行構成がサポートされています。

  • Java アプリケーション実行構成

  • JUnit 実行構成

  • TestNG 実行構成

Ant ステップのリモートデバッグでは、ビルド構成に teamcity.remote-debug.ant.supported=true パラメーターが含まれている必要があります。

前提条件

テストのリモートデバッグ

  1. テストのリモートデバッグを開始するには、テストを選択し、コンテキストメニューから TeamCity エージェントで<テスト名>をリモートデバッグ オプションを選択します(リモートデバッグ アクションは TeamCity プラグインメニューからも利用できます。 このアクションでは IntelliJ IDEA 実行構成を選択する必要があります)。

  2. これを実行すると、TeamCity プラグインにより、デバッグセッションを開始するビルド構成を選択するよう求められます。 このプロセスは、個人用ビルドの開始と似ています。 たとえば、個人用変更がある場合、個人用パッチが作成され、エージェントに送信されます。 また、プロセスは基本的に同じなので、ビルド構成を選択するときに、エージェントの指定やプロパティのカスタマイズなどを行えます。

    remote_debug_conf_selected.png

  3. 選択した構成に IntelliJ IDEA Project ビルドステップが複数含まれている場合、プラグインにより、デバッグセッションを開始するビルドステップを選択するよう求められます。

    remote_debug_step_selected.png

  4. その後、ビルドがキューに追加され、標準の IntelliJ IDEA デバッグツールウィンドウが表示されます:

    remote_debug_tool_window.png
    デバッグツールウィンドウはリッスンモードで動作します。つまり、エージェントからの接続を待機します。 エージェントが接続すると、エージェント上の Java プロセスが一時停止され、IDE にエージェント接続済み通知が表示されます:
    agent_attached_popup.png

  5. これで、いくつかのブレークポイントを設定し、通知ポップアップまたはデバッグツールウィンドウで 開始 をクリックして、実際にデバッグセッションを開始できます。
    JVM プロセスが終了すると、IDE に別の通知ポップアップが表示されます:

    repeat_debug_notification.png
    デバッグセッションはまだ終了していないため、繰り返すか終了できます。 繰り返し を選択すると、同じビルドステップが再度実行されます。これは新しいデバッグセッションを開始するよりもはるかに高速です。

2026 年 9 月 11 日