リモート Node.js ランタイムの構成},{
IntelliJ IDEA では、リモートホストまたは仮想環境にインストールされた Node.js でアプリケーションを開発、テスト、リント、実行、デバッグするときに、リモート Node.js ランタイムを構成する必要があります。
リモート Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで構成されます。 このダイアログは、リモート環境でアプリケーションを実行またはデバッグするための Node.js 実行/デバッグ構成を作成または編集する際に、 設定 ダイアログの JavaScript ランタイム ページから開けます。
推奨される方法は、 設定 ダイアログでリモート Node.js ランタイムを構成することです。 この場合、プロジェクトのデフォルトとしてランタイムと関連するパッケージマネージャーを設定できます。
Node.js の実行 / デバッグ構成で直接構成するリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
SSH 接続を介してアクセス可能なホスト上のリモート Node.js ランタイム},{
始める前に
設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript と TypeScript と入力します。 プラグインに関する詳細は、 プラグインの管理を参照してください。
JetBrains Marketplaceからプラグインをインストールするの説明に従って、 設定 | プラグイン ページのタブ Marketplace で、 Node.js、 Node.js Remote Interpreter、 FTP/SFTP/WebDAV Connectivityプラグインをインストールします。 プラグインは IntelliJ IDEA Ultimate でのみ利用できます。
SSH 構成を作成するの説明に従って、ターゲットリモートホスト上の SSH サーバーへのアクセスを構成し、このサーバーが実行されていることを確認してください。
SSH 経由の Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで構成されます。 このダイアログは、 設定 ダイアログの JavaScript ランタイム ページから開くことができます。また、アプリケーションを実行またはデバッグするために Node.js の実行/デバッグ構成を作成または編集するときに開くこともできます。
推奨される方法は、 設定 ダイアログでリモート Node.js ランタイムを構成することです。 この場合、プロジェクトのデフォルトとしてランタイムと関連するパッケージマネージャーを設定できます。
Node.js の実行 / デバッグ構成で直接構成するリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定ダイアログで、SSH 経由のリモート Node.js ランタイムを構成する},{
設定 ダイアログ（Ctrl+Alt+S ）を開き、 に進みます。
Node runtime フィールドの横にある
をクリックします。
現在構成されているすべてのランタイムのリストが表示された Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューから リモートの追加 を選択します。
開いた Node.js リモート ランタイムの構成ダイアログで、 SSH を選択します。
使用する SSH 構成を選択します。
代わりに、
をクリックし、 SSH 構成の作成に記載されている手順で新しい SSH 構成を作成します。OK をクリックして、新しいランタイムがリストに追加される Node.js ランタイム ダイアログに戻ります。
新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでランタイムを選択し、 OK をクリックして JavaScript ランタイム ダイアログに戻ります。
IntelliJ IDEA は、たとえば実行 / デバッグ構成を作成するときに、 Node runtime リストから
プロジェクトエイリアスを選択するたびに、このインタープリターを自動的に使用します。新しいランタイムに関連付けられたパッケージマネージャーを使用してプロジェクトの依存関係を管理するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。 これを行うには、 パッケージマネージャー(M) フィールドでパッケージマネージャーの場所を指定します。
npm 実行可能ファイルのデフォルトの場所は
/usr/local/lib/node_modules/npmです。
実行/デバッグ構成で SSH 経由でリモート Node.js ランタイムを構成する
に移動します。 開いた 構成の編集 ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成: Node.js 」ダイアログが開きます。Node runtime フィールドの横にある
をクリックします。
Node.js ランタイムダイアログが開きます。
ツールバーの
をクリックし、コンテキストメニューから リモートの追加 を選択します。
上記のように、SSH 経由でリモート Node.js ランタイムを構成します。
Docker コンテナー内のリモート Node.js ランタイム
始める前に
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 設定 | プラグイン ページの Marketplace タブに Node.js リモートインタープリタープラグインをインストールして有効にします。
設定 | プラグイン ページのタブ インストール済み で、 Node.js および Docker 必要なプラグインが有効になっていることを確認してください。 詳細は、 プラグインの管理を参照してください。
Docker の説明に従って Dockerをダウンロード、インストール、および構成します。
Docker の Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで構成されます。 このダイアログは、 設定 ダイアログの JavaScript ランタイム ページから開くことができます。また、Docker でアプリケーションを実行またはデバッグするために Node.js の実行 / デバッグ構成を作成または編集するときに開くこともできます。
推奨される方法は、 設定 ダイアログでリモート Node.js ランタイムを構成することです。 この場合、プロジェクトのデフォルトとしてランタイムと関連するパッケージマネージャーを設定できます。 その結果、Docker で構成された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係を管理し、テストを実行し、コードをリントすることもできます。
Node.js の実行 / デバッグ構成で直接構成するリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定ダイアログで Node.js ランタイムを構成する
に移動します。 開いた 構成の編集 ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。開いた 実行/デバッグ構成: Node.jsダイアログで、 Node runtime フィールドの横にある
をクリックします。現在構成されているすべてのランタイムのリストが表示された Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューから リモートの追加 を選択します。開いた Node.js リモートランタイムの構成ダイアログで、 Docker オプションを選択します。
サーバー フィールドに、使用する Docker の設定を指定します。 詳細については、 Docker デーモンの接続設定を構成するを参照してください。 リストから構成を選択するか、
をクリックして、開いた Docker ページ上に新しい構成を作成します。イメージ名: フィールドで、使用するベース Docker イメージを指定します。 リストから以前にダウンロードしたイメージまたはカスタムイメージのいずれかを選択するか、
node:argonやmhart/alpine-nodeなどのイメージ名を手動で入力します。 後で実行構成を起動すると、Docker はマシン上で指定されたイメージを検索します。 検索が失敗した場合、イメージは Docker レジストリページの Docker 公式イメージ(英語)リポジトリからダウンロードされます。Node.js ランタイムパス フィールドには、指定されたイメージからのデフォルトの Node.js ランタイムのロケーションが表示されます。},{
OK をクリックすると、IntelliJ IDEA は Node.js リモートインタープリターの構成 ダイアログを閉じ、新しいランタイム構成がリストに追加される Node.js ランタイムダイアログに移動します。 OK をクリックして、実行構成に戻ります。
Node.js の実行/デバッグ構成で Node.js ランタイムを構成する
に移動します。 開いた 構成の編集 ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成: Node.js 」ダイアログが開きます。Node runtime フィールドの横にある
をクリックします。 Node.js ランタイムダイアログが開きます。ツールバーの
をクリックし、コンテキストメニューから リモートの追加 を選択します。
上記のようにリモート Node.js ランタイムを構成します。
Docker Compose 定義を持つ Docker コンテナーでリモート Node.js ランタイムを使用する
Docker Compose(英語) を使用すると、Node.js サーバーとアプリケーションコードを別々のサービスとして実行できます。 必要に応じてコンテナーを追加することで各サービスを拡張できます。 これにより、実稼働環境に似た動的環境で効率的な開発とテストを実行できます。
始める前に
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 設定 | プラグイン ページの Marketplace タブに Node.js リモートインタープリタープラグインをインストールして有効にします。
設定 | プラグイン ページのタブ インストール済み で、 Node.js および Docker 必要なプラグインが有効になっていることを確認してください。 詳細は、 プラグインの管理を参照してください。
Docker の説明に従って Dockerをダウンロード、インストール、および構成します。
マルチコンテナー Docker アプリケーションの Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで設定します。 このダイアログは、Vagrant 環境でアプリケーションを実行またはデバッグするために Node.js の実行/デバッグ構成を作成または編集する際に、 設定 ダイアログの JavaScript ランタイム ページから開けます。
推奨される方法は、 設定 ダイアログでリモート Node.js ランタイムを構成することです。 この場合、プロジェクトのデフォルトとしてランタイムと関連するパッケージマネージャーを設定できます。 その結果、Docker で構成された Node.js ランタイムを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係を管理し、テストを実行し、コードをリントすることもできます。 以下の npm、pnpm、yarn と Docker、 アプリケーションをテストする、 Docker を使用した ESLint を参照してください。
Node.js の実行 / デバッグ構成で直接構成するリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定 ダイアログ（Ctrl+Alt+S ）を開き、 に進みます。
Node runtime フィールドの横にある
をクリックします。現在構成されているすべてのランタイムのリストが表示された Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューから リモートの追加 を選択します。開いた Node.js リモート ランタイムの構成ダイアログで、 Docker Compose を選択します。
サーバー リストから、使用する Docker 構成を選択します。
または、フィールドの横にある 新規 をクリックし、 Docker サポートを有効にする説明に従って Docker サーバーを構成します。
構成ファイル フィールドで、使用する docker-compose 構成ファイルを指定します。 「参照 」をクリックし、表示される「Docker Compose 構成ファイル 」ダイアログで構成ファイルのリストを作成します。
サービス リストから、使用するサービスを選択します。
OK をクリックして、新しいランタイムがリストに追加される Node.js ランタイム ダイアログに戻ります。 新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでランタイムを選択し、 OK をクリックして JavaScript ランタイム ダイアログに戻ります。
IntelliJ IDEA は、たとえば実行 / デバッグ構成を作成するときに、 Node runtime リストから プロジェクト エイリアスを選択するたびに、このインタープリターを自動的に使用します。
新しいランタイムに関連付けられたパッケージマネージャーを使用してプロジェクトの依存関係を管理するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。 これを行うには、 パッケージマネージャー(M) フィールドでパッケージマネージャーの場所を指定します。 プロジェクトでデフォルトの Node.js ランタイムとパッケージマネージャーを指定するから詳細を参照してください。
プロジェクトでデフォルトの Node.js ランタイムとパッケージマネージャーを指定する
IntelliJ IDEA は、実行 / デバッグ構成の作成時など、 Node runtime リストから プロジェクト エイリアスを選択するたびに、デフォルトのプロジェクトインタープリターを自動的に使用します。
デフォルトのプロジェクトパッケージマネージャーは、依存関係を管理するために自動的に使用されます。たとえば、 package.json ファイルから <package manager> install を実行したり、ESLint、Prettier などのサードパーティ製ツールをインストールしたりします。
設定 ダイアログ（Ctrl+Alt+S ）を開き、 に進みます。
優先ランタイム リストで Node.js が選択されていることを確認してください。
Node runtime リストから、現在のプロジェクトでデフォルトで使用する構成を選択します。
パッケージマネージャー リストから、使用するパッケージマネージャーに関連付けられているエイリアスを選択します。 IntelliJ IDEA はその位置を自動的に検出します。
または、必要なパッケージマネージャーの場所を手動で指定します。
npm 実行可能ファイルのデフォルトの場所は
/usr/local/lib/node_modules/npmです。pnpm のデフォルトの場所は、インストール方法によって異なります。
npm を介してインストールするための /usr/local/lib/node_modules/pnpm 。
カールを介してインストールするための /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 実行/デバッグ構成で Docker Compose 定義を使用して Node.js ランタイムを構成する
に移動します。 開いた 構成の編集 ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成: Node.js 」ダイアログが開きます。ファイル フィールドで、それを開始するアプリケーションのメインファイルへのパスを指定します（たとえば、 Express(英語) アプリケーションの場合は bin/www ）。
必要に応じて、 Node.js アプリケーションの実行とデバッグで説明されているいくつかのオプション設定を指定します。
Node runtime リストから、Docker Compose を介して関連するリモート Node.js ランタイムを選択します。
または、 Node runtime フィールドの横にある
をクリックします。 そして、 上記のようにリモート Node.js ランタイムを構成します。
Docker Compose エリアで、Docker Compose に渡すコマンドとオプションを指定します。 デフォルト設定を受け入れるか、「
」をクリックしてカスタム設定 (たとえば、 --rmや--service-portsなどのカスタム Docker Compose フラグ) を指定します。 詳細については、 Docker オフィシャル Web サイト(英語)を参照してください。コマンドプレビュー を確認してください。
Vagrant インスタンスの Node.js ランタイム
Vagrant(英語) を使用すると、Node.js アプリケーションをすばやくブートストラップして、IntelliJ IDEA から実行、デバッグ、プロファイリングできます。
始める前に
JetBrains Marketplaceからプラグインをインストールするの説明に従って、 設定 | プラグイン ページのタブ Marketplace で、 Node.js、 Node.js Remote Interpreter、 Vagrantプラグインをインストールします。
Vagrant(英語) と Oracle の VirtualBox(英語) がコンピューターにダウンロード、インストール、構成されていることを確認してください。 詳細は、 Vagrant を参照してください。
次の実行可能ファイルの親フォルダーがシステム PATH 変数に追加されていることを確認します。
Vagrant から vagrant.bat または vagrant を選択してください。 これは、Vagrant インストーラによって自動的に実行されます。
Oracle VirtualBox インストールからの VBoxManage.exe または VBoxManage 。
Vagrant 環境の Node.js ランタイムは、 Node.js リモートランタイムの構成 ダイアログで構成されます。 このダイアログは、Vagrant 環境でアプリケーションを実行またはデバッグするために Node.js の実行/デバッグ構成を作成または編集する際に、 設定 ダイアログの JavaScript ランタイム ページから開けます。
推奨される方法は、 設定 ダイアログでリモート Node.js ランタイムを構成することです。 この場合、プロジェクトのデフォルトとしてランタイムと関連するパッケージマネージャーを設定できます。
Node.js の実行 / デバッグ構成で直接構成するリモート Node.js ランタイムは、この実行 / デバッグ構成でのみ使用できます。
設定ダイアログで Node.js ランタイムを構成する
設定 ダイアログ（Ctrl+Alt+S ）を開き、 に進みます。
Node runtime フィールドの横にある
をクリックします。現在構成されているすべてのランタイムのリストが表示された Node.js ランタイムダイアログで、ツールバーの
をクリックし、コンテキストメニューから リモートの追加 を選択します。開いた Node.js リモート ランタイムの構成ダイアログで、 Vagrant を選択します。
使用する環境を指す Vagrant インスタンスフォルダー を指定してください。
技術的には、目的の環境の VagrantFile 構成ファイルが配置されているフォルダーです。 この設定に基づいて、IntelliJ IDEA は Vagrant ホストを検出し、 Vagrant ホスト URL 読み取り専用フィールドにリンクとして表示します。
デフォルトでは、フィールドには現在のプロジェクトフォルダーが表示されます。
Node.js ランタイムパス フィールドで、Node.js 実行可能ファイルの場所を指定します。
Node.js 実行可能ファイルを見つけるには、埋め込み ターミナル （Alt+F12 ）を開いて次のように入力します。
vagrant ssh whereis node exit
OK をクリックして、新しいランタイムがリストに追加される Node.js ランタイム ダイアログに戻ります。
新しく構成されたランタイムをプロジェクトのデフォルトとして設定するには、リストでランタイムを選択し、 OK をクリックして JavaScript ランタイム ダイアログに戻ります。
IntelliJ IDEA は、たとえば実行 / デバッグ構成を作成するときに、 Node runtime リストから
プロジェクトエイリアスを選択するたびに、このインタープリターを自動的に使用します。使用するパッケージマネージャーへのパスを指定します。
パッケージマネージャーを見つけるには、組み込み ターミナル （Alt+F12 ）を開いて次のように入力します。
vagrant ssh whereis <package manager> exit
Node.js の実行/デバッグ構成で Node.js ランタイムを構成する
に移動します。 開いた 構成の編集 ダイアログで、ツールバーの
をクリックし、コンテキストメニューから Node.js を選択します。 「実行 / デバッグ構成: Node.js 」ダイアログが開きます。Node runtime フィールドの横にある
をクリックします。 Node.js ランタイムダイアログが開きます。ツールバーの
をクリックし、コンテキストメニューから リモートの追加 を選択します。上記のように、Vagrant 環境でリモート Node.js ランタイムを構成します。