第5章 Eclipse Vert.x ベースのアプリケーションのデバッグ

手順

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

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

   $ mvn vertx:debug -Ddebug.port=$PORT_NUMBER

   Copy to Clipboard Toggle word wrap

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

   -Ddebug.suspend=true 引数を使用して、デバッガーが起動するまでアプリケーションを待機します。

手順

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

   $ oc get dc

   Copy to Clipboard Toggle word wrap

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

   $ oc set env dc/MY_APP_NAME JAVA_DEBUG=true

   Copy to Clipboard Toggle word wrap

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

   $ oc rollout latest dc/MY_APP_NAME

   Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

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

   $ oc set env dc/MY_APP_NAME JAVA_DEBUG-

   Copy to Clipboard Toggle word wrap

手順

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 をクリックし、一覧から設定を選択します。