第4章 Node.js ベースのアプリケーションのデバッグ

手順

1. デバッガーを有効にしてアプリケーションを起動します。

   ネイティブデバッガーは自動的に割り当てられ、デバッグプロンプトを提供します。

   デバッガーが有効になっているサンプルアプリケーション

   $ node inspect app.js
   < Debugger listening on ws://127.0.0.1:9229/12345678-aaaa-bbbb-cccc-0123456789ab
   < For help see https://nodejs.org/en/docs/inspector
   < Debugger attached.
   ...
   debug>

   Copy to Clipboard Toggle word wrap

   アプリケーションに別のエントリーポイントがある場合は、コマンドを変更してそのエントリーポイントを指定する必要があります。

   $ node inspect path/to/entrypoint

   Copy to Clipboard Toggle word wrap

   たとえば、express generator を使用してアプリケーションを作成する場合、エントリーポイントはデフォルトで ./bin/www に設定されます。REST API Level 0 example application などのサンプルの一部は、エントリーポイントとして ./bin/www を使用します。

2. デバッガープロンプトを使用して デバッグコマンド を実行します。

手順

1. V8 インスペクターの統合を有効にして アプリケーションを起動します。

   $ node --inspect app.js

   Copy to Clipboard Toggle word wrap

   アプリケーションに別のエントリーポイントがある場合は、コマンドを変更してそのエントリーポイントを指定する必要があります。

   $ node --inspect path/to/entrypoint

   Copy to Clipboard Toggle word wrap

   たとえば、express generator を使用してアプリケーションを作成する場合、エントリーポイントはデフォルトで ./bin/www に設定されます。REST API Level 0 example application などのサンプルの一部は、エントリーポイントとして ./bin/www を使用します。

2. V8 インスペクターをアタッチし、デバッグコマンドを実行します。

   たとえば、Google Chrome を使用している場合は、以下のようになります。

   1. chrome://inspect に移動します。
   2. 以下の リモートターゲット からアプリケーションを選択します。
   3. これで、アプリケーションのソースを確認し、デバッグアクションを実行できるようになりました。

手順

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

   $ oc get dc

   Copy to Clipboard Toggle word wrap

2. アプリケーションのデプロイメント設定の NODE_ENV 環境変数を development に設定して、デバッグを有効にします。以下に例を示します。

   $ oc set env dc/MY_APP_NAME NODE_ENV=development

   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:5858

      Copy to Clipboard Toggle word wrap

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

5. V8 インスペクターをアタッチし、デバッグコマンドを実行します。

   たとえば、Google Chrome を使用している場合は、以下のようになります。

   1. chrome://inspect に移動します。
   2. Configure をクリックします。
   3. 127.0.0.1:$LOCAL_PORT_NUMBER を追加します。
   4. Done をクリックします。
   5. 以下の リモートターゲット からアプリケーションを選択します。
   6. これで、アプリケーションのソースを確認し、デバッグアクションを実行できるようになりました。

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

   $ oc set env dc/MY_APP_NAME NODE_ENV-

   Copy to Clipboard Toggle word wrap