Node.js と Docker Compose

Docker Compose(英語) は、マルチコンテナーアプリケーションを実行するために使用されます。例: Web サーバー、バックエンドデータベース、アプリケーションコードを個別のサービスとして実行できます。必要に応じてコンテナーを追加することで各サービスを拡張できます。これにより、本番環境と同様に、動的な環境で効率的な開発とテストを実行できます。

始める前に

JavaScript Debugger、 Node.js、 Node.js Remote Interpreter、 Docker の必須プラグインが設定 | プラグインページ、タブインストール済みで有効になっていることを確認してください。詳細はプラグインの管理を参照してください。
Docker をダウンロード、インストール、設定し、 Docker の説明に従ってください。

Docker Compose で Node.js ランタイムを構成する

Docker の Node.js ランタイムは、 Node.js リモートランタイムの構成ダイアログで設定します。このダイアログは、設定ダイアログの JavaScript ランタイムページから、またはそれ以降にアプリケーションの実行またはデバッグのために Node.js の実行 / デバッグ構成を作成または編集するを実行する際に開くことができます。

推奨される方法は、設定ダイアログでリモート Node.js ランタイムを設定することです。この場合、ランタイムと関連するパッケージマネージャーをプロジェクトのデフォルトとして設定できます。これにより、Docker で設定された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係の管理、テストの実行、コードのリンティングも実行できるようになります。以下の npm、pnpm、yarn と Docker、アプリケーションをテストする、 Docker を使用した ESLint を参照してください。

Node.js 実行 / デバッグ構成で直接構成したリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。

設定ダイアログ（Ctrl+Alt+S ）を開き、言語 & フレームワーク | JavaScript ランタイムに進みます。
ノードランタイムフィールドの横にあるをクリックします。
現在構成されているすべてのランタイムのリストが表示されている Node.js ランタイムダイアログで、ツールバーのをクリックし、コンテキストメニューからリモートの追加を選択します。
開いた Node.js リモートランタイムを構成するダイアログで、 Docker Compose を選択します。
サーバーリストから、使用する Docker 構成を選択します。
または、フィールドの横にある新規をクリックし、 Docker サポートを有効にする説明に従って Docker サーバーを構成します。
構成ファイルフィールドで使用する docker-compose 設定ファイルを指定します。「閲覧する」をクリックし、表示される「Docker Compose 構成ファイル」ダイアログで構成ファイルのリストを作成します。
サービスリストから、使用するサービスを選択します。
OK をクリックすると、新しいランタイムがリストに追加される Node.js ランタイムダイアログに戻ります。新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでそのランタイムを選択し、 OK をクリックして JavaScript ランタイムダイアログに戻ります。

WebStorm は、たとえば実行/デバッグ構成作成時などノードランタイムリストから Project エイリアスを選択するたびに、このインタープリターを自動的に利用します。

新しいランタイムに関連付けられたパッケージマネージャーをプロジェクトの依存関係の管理に使用するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。そのためには、パッケージマネージャーフィールドにパッケージマネージャーの場所を指定します。詳しくはプロジェクトでデフォルトの Node.js ランタイムとパッケージマネージャーを指定するを参照してください。

プロジェクト内のデフォルトの Node.js ランタイムとパッケージマネージャーを指定する

WebStorm は、ノードランタイムリストから Project エイリアスを選択するたびに、たとえば実行 / デバッグ構成作成時など、デフォルトプロジェクトインタープリターを自動的に使用します。

デフォルトのプロジェクトパッケージマネージャーは、依存関係を管理するために自動的に使用されます。たとえば、 package.json ファイルから <package manager> install を実行したり、ESLint、Prettier などのサードパーティ製ツールをインストールしたりします。

設定ダイアログ（Ctrl+Alt+S ）を開き、言語 & フレームワーク | JavaScript ランタイムに進みます。
ノードランタイムリストから、現在のプロジェクトでデフォルトで使用する構成を選択します。
パッケージマネージャーリストから、使用するパッケージマネージャーに関連付けられているエイリアスを選択します。 WebStorm はその場所を自動的に検出します。
あるいは、必要なパッケージマネージャーの場所を手動で指定してください。
- npm 実行可能ファイルのデフォルトの場所は /usr/local/lib/node_modules/npm です。
- pnpm のデフォルトの場所はインストール方法によって異なります：
  1. npm を介してインストールするための /usr/local/lib/node_modules/pnpm 。
  2. カールを介してインストールするための /usr/local/pnpm-global/<version>/node_modules/pnpm （curl -f https://get.pnpm.io/<version>.js | node - add --global pnpm）。
  詳細については、 pnpm 公式 Web サイト(英語)を参照してください。
- ヤーンのデフォルトの場所は /opt/yarn-<version>5 で、たとえば /opt/yarn-v1.22.5 です。

Node.js 実行 / デバッグ構成を作成する

実行 | 実行構成の編集に進みます。開いた構成の編集ダイアログで、ツールバーのをクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js 」ダイアログが開きます。
ファイルフィールドで、それを開始するアプリケーションのメインファイルへのパスを指定します（たとえば、 Express(英語) アプリケーションの場合は bin/www ）。
必要に応じて、 Node.js アプリケーションの実行とデバッグで説明されているいくつかのオプション設定を指定します。
ノードランタイムリストから、Docker Compose 経由で関連するリモート Node.js ランタイムを選択します。
または、ノードランタイムフィールドの横にあるをクリックし、上記のようにリモート Node.js ランタイムを構成します。
Docker Compose エリアで、Docker Compose に渡すコマンドとオプションを指定します。デフォルト設定を受け入れるか、「」をクリックしてカスタム設定 (たとえば、 --rm や --service-ports などのカスタム Docker Compose フラグ) を指定します。詳細については、 Docker オフィシャル Web サイト(英語)を参照してください。
コマンドプレビューを確認してください。

2026 年 6 月 8 日