1.16. Red Hat build of Quarkus プロジェクトをデバッグする
Red Hat build of Quarkus を開発モードで起動すると、デフォルトでデバッグが有効になり、デバッガーは JVM を一時停止せずにポート 5005 でリッスンします。Quarkus のデバッグ機能を有効にして設定するには、コマンドラインを使用するか、システムプロパティーを設定します。Quarkus CLI を使用してプロジェクトをデバッグすることもできます。
前提条件
- Red Hat build of Quarkus Maven プロジェクトを作成している。
- オプション: Quarkus コマンドラインインターフェイス (CLI) がインストールされている。これは、プロジェクトのコンパイルとデバッグを行う方法の 1 つとして使用できます。詳細は、Quarkus CLI のインストール を参照してください。
Quarkus CLI は、Quarkus プロジェクトの作成、更新、ビルドなどのタスクを含む開発目的で使用されます。Red Hat は、実稼働環境での Quarkus CLI の使用をサポートしていません。
手順
デバッグを制御するには、以下のいずれかの方法を使用します。
システムプロパティーを設定してデバッガーを制御する
以下の
debugシステムプロパティーの値の 1 つを変更します。ここで、PORTはデバッガーがリッスンするポートです。-
false: JVM はデバッグモードを無効にして開始します。 -
true: JVM はデバッグモードで開始し、ポート5005でリッスンしています。 -
client: JVM はクライアントモードで起動され、localhost:5005への接続を試みます。 -
PORT: JVM はデバッグモードで開始され、PORTをリッスンしています。
-
デバッグモードでの実行中に JVM を一時停止するには、
suspendシステムプロパティーの値を次のいずれかの値に設定します。-
yまたはtrue: デバッグモードの JVM の起動が一時停止します。 -
nまたはfalse: デバッグモードの JVM は一時停止せずに起動します。
-
コマンドラインからのデバッガーの制御
一時停止された JVM を使用して、デバッグモードで Quarkus アプリケーションをコンパイルおよび起動するには、次のいずれかの方法を使用します。
Maven を使用する場合:
./mvnw quarkus:dev -Dsuspend
./mvnw quarkus:dev -DsuspendCopy to Clipboard Copied! Toggle word wrap Toggle overflow Quarkus CLI を使用する場合:
quarkus dev --suspend
quarkus dev --suspendCopy to Clipboard Copied! Toggle word wrap Toggle overflow
特定のホストネットワークインターフェイスに対してデバッガーを有効にする
開発モードでは、セキュリティー上の理由から Quarkus はデフォルトでデバッグホストインターフェイスを localhost に設定します。
特定のホストネットワークインターフェイスに対してデバッガーを有効にするには、次のいずれかの方法で -DdebugHost オプションを使用できます。
Maven を使用する場合:
./mvnw quarkus:dev -DdebugHost=<host-ip-address>
./mvnw quarkus:dev -DdebugHost=<host-ip-address>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Quarkus CLI を使用する場合:
quarkus dev --debug-host=<host-ip-address>
quarkus dev --debug-host=<host-ip-address>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
<host-ip-address> は、デバッグを有効にするホストネットワークインターフェイスの IP アドレスです。
すべてのホストインターフェイスでデバッグを有効にするには、<host-ip-address> を次の値に置き換えます。
0.0.0.0
0.0.0.0