WebStorm 2026.3 Help

チュートリアル: Dev Containers 入門

このチュートリアルでは、ローカルプロジェクト用の Dev Container 構成を作成し、コンテナーをビルドして、その中でプロジェクトを開きます。 最後に、実行中のコンテナーと、それに接続された IDE ウィンドウが用意されます。

始める前に

  • Docker がマシンにインストールされ、Docker デーモンが実行されています。 WebStorm は Docker 経由でコンテナーをビルドするため、デーモンが停止しているとビルドは失敗します。

  • Docker プラグイン がインストールされ、有効になっています。

  • ローカルプロジェクトが WebStorm で開かれています。

リモート Dev Containers を含む要件の完全な一覧については、 前提条件 を参照してください。

ステップ 1. プロジェクトを準備する

devcontainer.json は Dev Containers をビルドするために必要な構成ファイルなので、プロジェクト内に存在している必要があります。 ファイルはプロジェクトルートの .devcontainer フォルダーに配置されます。間に .devcontainer/.../.../devcontainer.json のような別のフォルダーが存在する場合もあります。

Dev Containers の作成をすばやく開始するには、シンプルなファイルを作成するか、IDE 内機能を使用してテンプレートから構成ファイルを作成する、という 2 つのオプションがあります。

Dev Container の最小要件は、ビルド元となるイメージです。

  1. プロジェクトビューで、プロジェクト名を右クリックして 新規 | ファイル を選択します。

  2. .devcontainer/devcontainer.json と入力して、プロジェクトルート下の .devcontainer ディレクトリに構成を作成します。

  3. エディターでファイルを開き、次のコードを追加します:

    { image: "ubuntu:latest" }
  1. プロジェクトビューで、プロジェクト名を右クリックして 新規 | Dev Container 構成 を選択します。

  2. 開いたダイアログに、WebStorm でデフォルトのコンテナー構成が表示されます。 デフォルトのテンプレートで Dev Container を作成できますが、必要に応じて Dev Container テンプレート ドロップダウンから他の言語固有テンプレートを選択することもできます。

    OK をクリックして、比較的シンプルな (ただしコメントが多い) devcontainer.json を作成します:

    // Default Ubuntu-based DevContainer Template. // For more customization options, see https://containers.dev/implementors/json_reference { name: "Default", image: "ubuntu:latest", customizations : { // Configure JetBrains IDE-specific properties jetbrains : { backend : "IntelliJ", settings : { // IDE settings can be added via “Show context actions”|“Add currently modified settings from IDE”. // A complete list of supported settings is also available through auto-completion }, plugins: [ // A set of plugin IDs. // Plugin ID can be found on the corresponding plugin’s page at https://plugins.jetbrains.com. ] } }, features: { "ghcr.io/devcontainers/features/git" : {}, // Add additional features to your project using auto-completion. }, // Comment out to connect as the root user. remoteUser: "ubuntu" }

ステップ 2. ビルドプロセスの準備

Dev Container をビルドする前に、使用する Dev Container 実装を検討してください:

  • Remote Development の古い実装では、 設定|詳細設定​​ の Dev Container プロジェクトをネイティブに開く オプションが無効になっていることを確認してください。

  • ネイティブモード実装を使用する場合は、 Dev Container プロジェクトをネイティブに開く オプションを 設定|詳細設定​​ で有効にします。

さらに、Remote Development 実装を使用する場合は、拡張バックエンド選択を提供するように IDE を設定することをおすすめします。

Dev Containers 用の特定の IDE バックエンドバージョンを選択する

  1. Ctrl+Alt+S を押して設定を開き、 詳細設定 を選択します。

  2. 右側のオプションで、 Dev Container セクションの下にある バックエンドのバージョンを自動的に選択する。 を無効にし、 OK をクリックして変更を保存します。

  3. このオプションを無効にすると、Dev Container のビルド後に複数のバックエンドバージョンが利用可能になります。

カスタムリモート開発バックエンドを使用するには (たとえば、未公開の IDE ビルドで問題を確認する場合)、次の操作を行います:

IDE バックエンドを手動でダウンロードする

  1. ダウンロード ページを開きます。

  2. 現在 Dev Containers でサポートされているのは Linux ベースのイメージのみのため、 Linux をオペレーティングシステムとして選択します。

  3. Docker Engine が実行されているホストに対応するアーキテクチャのアーカイブをダウンロードします。

  4. メインメニューで 移動 | どこでも検索 に移動するか、 Shift を 2 回押して検索ウィンドウを開きます。

  5. registry と入力し、 レジストリ… オプションを選択します。

  6. 開いたウィンドウで devcontainers.use.separate.project.panel キーを検索し、有効にします。 閉じる をクリックします。

  7. IDE を再起動します。

  8. レジストリキーを有効にした後、Dev Container ビルドを開始します。

  9. IDE とプロジェクトを選択 ウィンドウが開いたら、 インストールオプション リンクをクリックし、 インストーラファイルをアップロード アクションを選択します。

  10. IDE バージョン フィールドが アーカイブを選択 ファイルに変わります。

  11. ダウンロードした IDE バックエンドアーカイブへのパスを指定します。

  12. Dev Container ビルドプロセスを続行します。

ステップ 3. Dev Container のビルドを開始する

  1. .devcontainer/devcontainer.json を開きます。 ガターの Dev Containers アイコンをクリックし、 Dev Container を作成してソースをマウント… を選択します。 バックエンド IDE の選択を求められた場合は、WebStorm を選択します。

  2. ビルドが開始されると、ビルドプロセスを表示するために Services ビューが自動的に開きます:

  3. 選択した実装 (Remote Development とネイティブモード) に応じて、以降のフローは少し異なります。

    リストからバックエンドバージョンを選択し、それと Client がダウンロードされるまで待ちます:

    場合によっては、Dev Container のビルドとバックエンドデプロイプロセスに 10 秒を超える時間がかかると、Client は開かれません。代わりに、 接続 ボタン付きの通知が IDE に表示されます。 ボタンを押します。

    次のウィンドウで プロジェクトを信頼 ボタンを押し、Client が開くまで待ちます:

    開いているプロジェクトがすでに Dev Container 内のプロジェクトかどうかを確認するには? 左上の バックエンドのステータス詳細 ウィジェットで確認できます。

    バックエンドデプロイ手順がないため、Dev Container プロジェクトは IDE ですぐに開かれます。 設定 | 外観 & 振る舞い | システム設定 の プロジェクトを開く先 オプションが 確認する に設定されている場合、プロジェクトは確認後に開かれます。

    ネイティブモードを使用する Dev Container でプロジェクトが開かれているかどうかを確認するには、通常とは異なるプロジェクトルートパスと、エディター左上に Dev Container 情報を表示するウィジェットを確認してください。

    Dev Container ウィジェット
2026 年 11 月 6 日