JetBrains Rider 2024.1 ヘルプ

リモート Node.js インタープリターの構成

JetBrains Rider では、リモートホストまたは仮想環境にインストールされた Node.js でアプリケーションを開発、テスト、リント、実行、デバッグするときに、リモート Node.js インタープリターを構成する必要があります。

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

推奨される方法は、設定 / 環境設定ダイアログでリモート Node.js インタープリターを構成することです。この場合、プロジェクトのデフォルトとしてインタープリターと関連するパッケージマネージャーを設定できます。

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

SSH 接続を介してアクセス可能なホスト上のリモート Node.js インタープリター

始める前に

  1. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、Node.js および Node.js リモートインタープリタープラグインを設定 | プラグインページのマーケットプレースタブにインストールします。

  2. 設定で FTP/SFTP/WebDAV 接続プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、プラグインを選択します。インストール済みタブをクリックします。検索フィールドに FTP/SFTP/WebDAV 接続と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。

  3. SSH 構成を作成する説明に従って、ターゲットリモートホスト上の SSH サーバーへのアクセスを構成し、このサーバーが実行されていることを確認します。

SSH 経由の Node.js インタープリターは、Node.js リモートインタープリターの構成ダイアログで構成されます。このダイアログは、Node.js の実行 / デバッグ構成を作成または編集するを使用してアプリケーションを実行またはデバッグするときに、設定 / 環境設定ダイアログの Node.js ページ以降から開くことができます。

推奨される方法は、設定 / 環境設定ダイアログでリモート Node.js インタープリターを構成することです。この場合、プロジェクトのデフォルトとしてインタープリターと関連するパッケージマネージャーを設定できます。

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

設定 / 環境設定で SSH 経由でリモート Node.js インタープリターを構成するダイアログ

  1. 設定 / 環境設定ダイアログ（Ctrl+Alt+S）を開き、言語 & フレームワーク | Node.js に移動します。

  2. Node インタープリターフィールドの横にある the Browse button をクリックします。

    Add interpreter - Browse button

  3. 現在構成されているすべてのインタープリターのリストが表示された Node.js インタープリターダイアログで、ツールバーの the Add button をクリックし、コンテキストメニューからリモートの追加を選択します。

    Configure Node.js interpreter via SSH: Add Remote

  4. 開いた Node.js リモートインタープリターの構成ダイアログで、SSH を選択します。

  5. 使用する SSH 構成を選択します。

    Configure remote Node.js interpreter via SSH: select SSH configuration

    または、the Browse button をクリックして、SSH 構成を作成する説明に従って新しい SSH 構成を作成します。

  6. OK をクリックして、新しいインタープリターがリストに追加される Node.js インタープリターダイアログに戻ります。

    Remote Interpreters dialog: the new Node.js interpreter via SSH added to the list

  7. 新しく構成されたインタープリターをプロジェクトのデフォルトとして設定するには、リストでインタープリターを選択し、OK をクリックして Node.js ダイアログに戻ります。

    JetBrains Rider は、たとえば実行 / デバッグ構成を作成するときに、Node インタープリターリストから Project エイリアスを選択するたびに、このインタープリターを自動的に使用します。

    新しいインタープリターに関連付けられたパッケージマネージャーを使用してプロジェクトの依存関係を管理するには、このパッケージマネージャーをプロジェクトのデフォルトとして設定します。これを行うには、パッケージマネージャーフィールドでパッケージマネージャーの場所を指定します。

    npm 実行可能ファイルのデフォルトの場所は /usr/local/lib/node_modules/npm です。

    Configure Node.js interpreter via SSH: set as default project interpreter

実行 / デバッグ構成で SSH 経由でリモート Node.js インタープリターを構成する

  1. 実行 | 実行構成の編集に進みます。開いた構成の編集ダイアログで、ツールバーの the Add New Configuration button をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。

  2. Node インタープリターフィールドの横にある the Browse button をクリックします。

    Node.js run/debug configuration: JavaScript file specified

    Node.js インタープリターダイアログが開きます。

  3. ツールバーの the Add button をクリックし、コンテキストメニューからリモートの追加を選択します。

    Node.js via SSH: run/debug configuration, configure interpreter, select Add Remote

  4. 上記のように、 SSH 経由でリモート Node.js インタープリターを構成します。

Docker コンテナー内のリモート Node.js インタープリター

始める前に

  1. Node.js、Node.js リモートインタープリター、Docker に必要なプラグインが設定 | プラグインページのインストール済みタブで有効になっていることを確認します。詳細については、プラグインのマッピングを参照してください。

  2. Docker の説明に従って、Docker をダウンロード、インストール、設定します。

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

推奨される方法は、設定 / 環境設定ダイアログでリモート Node.js インタープリターを構成することです。この場合、プロジェクトのデフォルトとしてインタープリターと関連するパッケージマネージャーを設定できます。その結果、Docker で構成された Node.js インタープリターを使用してアプリを実行およびデバッグできるだけでなく、プロジェクトの依存関係を管理し、テストを実行し、コードをリントすることもできます。

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

設定 / 環境設定で Node.js インタープリターを構成するダイアログ

  1. 実行 | 実行構成の編集に進みます。開いた構成の編集ダイアログで、ツールバーの the Add New Configuration button をクリックし、コンテキストメニューから Node.js を選択します。

    開いた実行 / デバッグ構成: Node.js ダイアログで、Node インタープリターフィールドの横にある the Browse button をクリックします。

  2. 現在構成されているすべてのインタープリターのリストが表示された Node.js インタープリターダイアログで、ツールバーの the Add button をクリックし、コンテキストメニューからリモートの追加を選択します。

  3. 開いた Node.js リモートインタープリターの構成ダイアログで、Docker オプションを選択します。

    1. サーバーフィールドに、使用する Docker の設定を指定します。詳細については、Docker デーモンの接続設定を構成するを参照してください。リストから構成を選択するか、the Browse button をクリックして、開いた Docker ページ上に新しい構成を作成します。

    2. イメージ名: フィールドで、使用するベース Docker イメージを指定します。リストから以前にダウンロードしたイメージまたはカスタムイメージのいずれかを選択するか、node:argon や mhart/alpine-node などのイメージ名を手動で入力します。後で実行構成を起動すると、Docker はマシン上で指定されたイメージを検索します。検索が失敗した場合、イメージは Docker レジストリページの Docker 公式イメージ(英語)リポジトリからダウンロードされます。

    3. Node.js インタープリターのパスフィールドには、指定されたイメージからのデフォルトの Node.js インタープリターの場所が表示されます。

    4. OK をクリックすると、JetBrains Rider は Node.js リモートインタープリターの構成ダイアログを閉じ、新しいインタープリター構成がリストに追加される Node.js インタープリターダイアログに移動します。OK をクリックして、実行構成に戻ります。

Node.js の実行 / デバッグ構成で Node.js インタープリターを構成する

  1. 実行 | 実行構成の編集に進みます。開いた構成の編集ダイアログで、ツールバーの the Add New Configuration button をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。

  2. Node インタープリターフィールドの横にある the Browse button をクリックします。Node.js インタープリターダイアログが開きます。

  3. ツールバーの the Add button をクリックし、コンテキストメニューからリモートの追加を選択します。

    Node.js with Docker: run/debug configuration, configure interpreter, select Add Remote

  4. 上記のようにリモート Node.js インタープリターを構成します。

Docker Compose 定義を持つ Docker コンテナーでリモート Node.js インタープリターを使用する

Docker Compose(英語) を使用すると、Node.js サーバーとアプリケーションコードを別々のサービスとして実行できます。必要に応じてコンテナーを追加することで各サービスを拡張できます。これにより、実稼働環境に似た動的環境で効率的な開発とテストを実行できます。

Vagrant インスタンスの Node.js インタープリター

Vagrant(英語) を使用すると、Node.js アプリケーションをすばやくブートストラップして、JetBrains Rider から実行、デバッグ、プロファイリングできます。

始める前に

  1. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのタブマーケットプレースに Node.js、Node.js リモートインタープリター、Vagrant プラグインをインストールします。

  2. Vagrant(英語) と Oracle の VirtualBox(英語) がコンピューターにダウンロード、インストール、構成されていることを確認してください。詳細については、Vagrant: 再現可能な開発環境の使用を参照してください。

  3. 次の実行可能ファイルの親フォルダーがシステム PATH 変数に追加されていることを確認します。

    • Vagrant から vagrant.bat または vagrant を選択してください。これは、Vagrant インストーラによって自動的に実行されます。

    • Oracle VirtualBox インストールからの VBoxManage.exe または VBoxManage。

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

推奨される方法は、設定 / 環境設定ダイアログでリモート Node.js インタープリターを構成することです。この場合、プロジェクトのデフォルトとしてインタープリターと関連するパッケージマネージャーを設定できます。

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

設定 / 環境設定で Node.js インタープリターを構成するダイアログ

  1. 設定 / 環境設定ダイアログ（Ctrl+Alt+S）を開き、言語 & フレームワーク | Node.js に移動します。

  2. Node インタープリターフィールドの横にある the Browse button をクリックします。

    Add interpreter - Browse button

  3. 現在構成されているすべてのインタープリターのリストが表示された Node.js インタープリターダイアログで、ツールバーの the Add button をクリックし、コンテキストメニューからリモートの追加を選択します。

    Configure Node.js remote interpreter: Add Remote

  4. 開いた Node.js リモートインタープリターの構成ダイアログで、Vagrant を選択します。

  5. 使用する環境を指す Vagrant インスタンスフォルダーを指定してください。

    技術的には、目的の環境の VagrantFile 構成ファイルが配置されているフォルダーです。この設定に基づいて、JetBrains Rider は Vagrant ホストを検出し、Vagrant ホスト URL 読み取り専用フィールドにリンクとして表示します。

    デフォルトでは、フィールドには現在のプロジェクトフォルダーが表示されます。

  6. Node.js インタープリターのパスフィールドで、Node.js 実行可能ファイルの場所を指定します。

    Configure remote Node.js interpreter in Vagrant environment: specify instance folder and location of Node executable

    Node.js 実行可能ファイルを見つけるには、埋め込みターミナル（Alt+F12）を開いて次のように入力します。

    vagrant ssh whereis node exit
    Locate Node.js executable in a Vagrant environment

  7. OK をクリックして、新しいインタープリターがリストに追加される Node.js インタープリターダイアログに戻ります。

  8. 新しく構成されたインタープリターをプロジェクトのデフォルトとして設定するには、リストでインタープリターを選択し、OK をクリックして Node.js ダイアログに戻ります。

    Remote Interpreters dialog: the new Node.js interpreter in a Vagrant environment added to the list

    JetBrains Rider は、たとえば実行 / デバッグ構成を作成するときに、Node インタープリターリストから Project エイリアスを選択するたびに、このインタープリターを自動的に使用します。

  9. 使用するパッケージマネージャーへのパスを指定します。

    Configure remote Node.js interpreter: package manager specified

    パッケージマネージャーを見つけるには、組み込みターミナル（Alt+F12）を開いて次のように入力します。

    vagrant ssh whereis <package manager> exit
    Locate a package manager in a Vagrant environment

Node.js の実行 / デバッグ構成で Node.js インタープリターを構成する

  1. 実行 | 実行構成の編集に進みます。開いた構成の編集ダイアログで、ツールバーの the Add New Configuration button をクリックし、コンテキストメニューから Node.js を選択します。「実行 / デバッグ構成: Node.js」ダイアログが開きます。

  2. Node インタープリターフィールドの横にある the Browse button をクリックします。Node.js インタープリターダイアログが開きます。

  3. ツールバーの the Add button をクリックし、コンテキストメニューからリモートの追加を選択します。

    Remote Interpreters dialog

  4. 上記のように、Vagrant 環境でリモート Node.js インタープリターを構成します。

サポートされている Node.js バージョン Node.js の実行とデバッグ

関連ページ：

Node.js

このページは、プラグインのインストールに従って、設定 | プラグインページのインストール済みタブで Node.js バンドルプラグインが有効になっている場合にのみ表示されます。次の Node.js バージョンは、JetBrains Rider 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細情報 Node インタープリターこのフィールドで...

言語およびフレームワーク: Node.js

Node.js は、サーバーやコマンドラインなど、ブラウザーの外部で JavaScript を実行するための軽量ランタイム環境です。JetBrains Rider は Node.js と統合されており、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、保守を支援します。Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、Node.js...

プラグインのインストール

プラグインは JetBrains Rider のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrai...

実行 / デバッグ構成: Node.js

作成: 次の Node.js バージョンは、JetBrains Rider 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細を参照してください。このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。始める前に：Node.js をダウンロードしてインストールします。Je...

Docker

Docker は、分離された再現可能な環境で実行可能ファイルをデプロイおよび実行するためのツールです。これは、たとえば、本番環境と同じ環境でコードをテストする場合に役立ちます。JetBrains Rider は Docker 機能を統合し、Docker イメージの作成、Docker コンテナーの実行、Docker Compose アプリケーションの管理、パブリックおよびプライベート Docker レジストリの使用など、IDE から直接実行するための支援を提供します。Docker プラグインを有効に...

Docker 接続設定

JetBrains Rider から Docker エンジン API にアクセスするための設定を指定します。Docker と JetBrains Rider の統合の使用方法の詳細については、「Docker」を参照してください。Docker プラグインを有効にするこの機能は、デフォルトで JetBrains Rider にバンドルされて有効になっている Docker プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、...