リモートデバッグ
リモートデバッグは、ローカルの開発者マシン上の IDE から TeamCity エージェントマシン上のテストをリモートでデバッグできるようにする機能です。この機能は、エージェント環境が何らかの点で固有であり、テストが失敗し、問題をローカルで再現するのが困難な場合に役立ちます。
IntelliJ ベースの IDE 用の TeamCity 統合を有効にすると、IntelliJ IDEA プロジェクトおよび Ant ビルド手順に基づくビルドに対して、リモートデバッグセッションを IntelliJ IDEA から直接起動できます。
現在、次の IntelliJ IDEA 実行構成がサポートされています。
Java アプリケーション実行構成
JUnit 実行構成
TestNG 実行構成
Ant ステップのリモートデバッグでは、ビルド構成に teamcity.remote-debug.ant.supported=true パラメーターが含まれている必要があります。
前提条件
TeamCity 用 TeamCity プラグイン IntelliJ IDEA がインストールされたローカル開発者マシンでの IntelliJ IDEA 実行構成
IntelliJ IDEA プロジェクトランナーをビルドステップの 1 つとして TeamCity サーバー上で構成をビルドする
リモート TeamCity エージェントは、ソケット接続によりローカルマシンでこのビルドを使用可能にします
テストをリモートでデバッグする
テストのリモートデバッグを開始するには、テストを選択してコンテキストメニューから TeamCity エージェントで <テスト名> をリモートでデバッグするオプションを選択します（リモートデバッグアクションは TeamCity プラグインメニューからも利用できます。このアクションでは IntelliJ IDEA 実行構成を選択する必要があります）。
これを行うと、TeamCity プラグインは、デバッグセッションを開始するビルド構成を選択するように求めます。このプロセスは、個人用ビルドの開始に似ています。例: 個人的な変更がある場合、個人用パッチが作成され、エージェントに送信されます。また、プロセスは基本的に同じであるため、ビルド構成を選択するときに、エージェントを指定したり、プロパティをカスタマイズしたりできます。
選択した設定に複数の IntelliJ IDEA プロジェクトビルドステップが含まれている場合、プラグインはデバッグセッションを開始する場所を選択します。
その後、ビルドがキューに追加され、標準の IntelliJ IDEA デバッグツールウィンドウが表示されます。
これで、いくつかのブレークポイントを設定し、通知ポップアップまたはデバッグツールウィンドウで開始をクリックして、実際にデバッグセッションを開始できます。
JVM プロセスが終了すると、IDE に別の通知ポップアップが表示されます。
関連ページ：
IntelliJ プラットフォームプラグイン
このプラグインは、JetBrains IntelliJ IDEA、RubyMine、PyCharm、PhpStorm/WebStorm、AppCode、Rider などの IntelliJ プラットフォームベースの IDE との TeamCity 統合を実装します。リモートの実行 / 事前テスト済みのコミット機能は、JetBrains によって IDE にバンドルされている VCS 統合でのみサポートされます。サポートされているバージョンのリストについては、JetBrains マーケットプレイス...
ビルドパラメーターの設定
パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型：TeamCity は次の 3 種類のパラメーターをサポートします。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...
ビルドステップの設定
ビルドステップは、CI/CD ワークフローの最小単位です。ビルドステップは、全体として実行される一連のアクションを定義します。ビルドステップは、ビルド構成とパイプラインジョブに属します。構成とパイプラインのビルドステップ：TeamCity は、.NET、Maven、NAnt、Xcode などの特定のビルドツール用に設計された幅広いビルドステップを提供します。現在、ビルド構成ではすべてのステップが利用可能です。バージョン 2025.07 で導入された
TeamCity エージェントをインストールして開始する
TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...