第11章 アプリケーションのデバッグ

手順

1. コンソールで、アプリケーションでディレクトリーに移動します。

2. アプリケーションを起動し、-Dthorntail.debug.port 引数を使用してデバッグポートを指定します。

   $ mvn thorntail:run -Dthorntail.debug.port=$PORT_NUMBER

   ここで、$PORT_NUMBER は未使用のポート番号です。リモートデバッガー設定のこの番号を覚えておいてください。

手順

1. コンソールで、uberjar のディレクトリーに移動します。

2. 以下のパラメーターで uberjar を実行します。行上の uberjar の名前の前に、すべてのパラメーターが指定されていることを確認してください。

   $ java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=$PORT_NUMBER -jar $UBERJAR_FILENAME

   $PORT_NUMBER は未使用のポート番号です。リモートデバッガー設定のこの番号を覚えておいてください。

   JVM を一時停止してリモートデバッガー接続を待つ場合は、アプリケーションを起動する前に suspend を y に変更します。

手順

1. oc コマンドを使用して、利用可能なデプロイメント設定を一覧表示します。

   $ oc get dc

2. アプリケーションのデプロイメント設定の JAVA_DEBUG 環境変数を true に設定します。これにより、JVM がデバッグ用にポート番号 5005 を開くように設定されます。以下は例になります。

   $ oc set env dc/MY_APP_NAME JAVA_DEBUG=true

3. 設定変更時に自動的に再デプロイするように設定されていない場合は、アプリケーションを再デプロイします。以下は例になります。

   $ oc rollout latest dc/MY_APP_NAME

4. ローカルマシンからアプリケーション Pod へのポート転送を設定します。

   1. 現在実行中の Pod を一覧表示し、アプリケーションが含まれる Pod を検索します。

      $ oc get pod
      NAME                            READY     STATUS      RESTARTS   AGE
      MY_APP_NAME-3-1xrsp          0/1       Running     0          6s
      ...

   2. ポート転送を設定します。

      $ oc port-forward MY_APP_NAME-3-1xrsp $LOCAL_PORT_NUMBER:5005

      ここで、$LOCAL_PORT_NUMBER はローカルマシンで選択した未使用のポート番号になります。リモートデバッガー設定のこの番号を覚えておいてください。

5. デバッグが完了したら、アプリケーション Pod の JAVA_DEBUG 環境変数の設定を解除します。以下は例になります。

   $ oc set env dc/MY_APP_NAME JAVA_DEBUG-

手順

1. Red Hat CodeReady Studio を起動します。

2. アプリケーションの新規デバッグ設定を作成します。

   1. Run→Debug Configurations をクリックします。
   2. 設定のリストで、Remote Java アプリケーション をダブルクリックします。これにより、新しいリモートデバッグ設定が作成されます。
   3. Name フィールドに、設定に適した名前を入力します。
   4. アプリケーションが含まれるディレクトリーへのパスを Project フィールドに入力します。便宜上、Browse…​ ボタンを使用できます。
   5. Connection Type フィールドを Standard (Socket Attach) に設定していない場合は、これを設定します。
   6. Port フィールドを、アプリケーションがデバッグをリッスンしているポート番号に設定します。
   7. Apply をクリックします。

3. Debug Configurations ウィンドウの Debug ボタンをクリックしてデバッグを開始します。

   初めてデバッグ設定を迅速に起動するには、Run→Debug History をクリックし、一覧から設定を選択します。