Windowsで開発コンテナーを設定する

開発コンテナーを使用すると、Docker コンテナーを完全な開発環境として使用できます。これは、リポジトリにチェックインされた devcontainer.json ファイルによって定義されます。 プロジェクトを開くすべてのユーザーは、ローカル コンピューターにインストールされている内容に関係なく、同じツール、拡張機能、設定を取得します。

このページでは、Windows固有のセットアップについて説明します。 開発コンテナーの概要と動作の詳細については、VS Code Web サイトの Dev Containers のドキュメント を参照してください。

前提条件

Windows上の開発コンテナーには、次のものが必要です。

• WSL 2 - Linux 用 Windows サブシステムバージョン 2。 WSL をまだインストール していない場合はインストールします。
• WSL 2 バックエンドが有効になっている Docker Desktop for Windows。 Docker Desktop をダウンロード し、インストーラーに従います。 セットアップ時に、Docker Desktop の設定 ([設定]>) で [WSL 2 ベースのエンジンを使用する] が選択されていることを確認します。
• Visual Studio Code — DOWNload VS Code。
• Dev Containers 拡張機能 - VS Code Marketplace から Dev Containers 拡張機能 をインストールします。

ファイルを保存する場所が重要

ファイルが Windows ファイル システム (C:\) にある場合、Docker は OS 間のファイル共有を介してアクセスします。これは非常に低速です。 ファイルが WSL 2 ファイル システムにある場合、Docker ではネイティブ Linux I/O が使用され、パフォーマンスは大幅に向上します。特にビルドおよびファイル監視ツールの場合はパフォーマンスが大幅に向上します。

WSL 2 ファイル システムに複製するには、[スタート] メニューまたは Windows ターミナルから WSL ディストリビューション (Ubuntu など) を開き、そこで複製します。

cd ~
mkdir projects && cd projects
git clone https://github.com/your-org/your-repo.git

次に、WSL から VS Code でそのフォルダーを開きます。

code your-repo

VS Code は WSL に接続し、 devcontainer.json が存在する場合は検出します。

開発コンテナーでプロジェクトを開く

VS Code でプロジェクトを開くと (WSL に接続されます):

1. F1 キーを押し、[開発コンテナー: コンテナーで再度開く] を選択します。
2. VS Code は、 .devcontainer/devcontainer.json で定義されているコンテナー イメージをビルドします (存在しない場合は追加するように求められます)。
3. ビルドが完了すると、VS Code は構成されたすべてのツールと拡張機能を使用してコンテナー内に再接続します。

ローカル環境に戻すには、 F1 キーを押し、[ 開発コンテナー: フォルダーをローカルに再度開く] を選択します。

既存のプロジェクトに開発コンテナーを追加する

プロジェクトにまだ devcontainer.json がない場合:

1. F1 キーを押し、[開発コンテナー: 開発コンテナー構成ファイルの追加] を選択します。
2. 基本イメージ (Node.js、Python、汎用 Debian/Ubuntu イメージなど) を選択します。
3. VS Code では、ソース管理にチェックインできる .devcontainer/devcontainer.json ファイルが作成されます。

devcontainer.json オプションの完全なリファレンスについては、Dev Container Specification サイト devcontainer.json リファレンスを参照してください。

Troubleshooting

Container は起動しますが、ファイルの変更は検出されませんプロジェクトはWindowsファイル システムに格納されている可能性があります。 WSL に移動します ( 上記の「ファイルの保存場所 」を参照してください)。

Docker Desktop が起動しないか、WSL 統合が見つからない Docker Desktop を開き、 設定>Resources>WSL 統合に移動し、インストールされている WSL ディストリビューションの統合を有効にします。

VS Code がコンテナーに接続できない VS Code を開く前に、Docker Desktop が実行されていることを確認します。 Docker Desktop システム トレイ アイコンを確認します。

次のステップ

• Dev Containers のドキュメント - VS Code チームからの完全なリファレンス
• devcontainer.json リファレンス — すべての構成オプション
• WSL 2 で Docker リモート コンテナーを始める - 全体的な WSL + Docker セットアップ ガイド
• WSL をインストール する — WSL をまだ設定していない場合