Windows11でWSL2とDocker Desktopを導入する手順

Windows11環境でWSL2を使用する理由と導入の重要性

Windows11では、WSL2（Windows Subsystem for Linux） がLinuxコンテナ開発を劇的に簡素化します。Docker DesktopはWSL2経由でLinux環境を扱えるため、仮想マシンや別のPCを用いる必要がなくなります。この導入により、Windows上で本格的なLinux開発ワークフローを構築できるようになるのが最大の利点です。特に、最新バージョンでのWSL2とDocker Desktopの連携が推奨されるため、設定ミスを防ぐための準備が不可欠です。

システム要件確認と事前準備

WSL2を活用するには、まず環境が整っているか確認します。Windows10/11共通の手順で、必要な設定を行います。

Windowsバージョンチェック手順

WSL2を使用するためには、Windows 10バージョン21H2以上またはWindows 11が必要です。コマンドプロンプトまたはPowerShellで以下のコマンドを実行します。

出力結果の「OSビルド」が 22621以上（Windows11の場合）または 22000以上（Windows10 21H2以降）かどうか確認してください。

WSL2の有効化方法

WSL2を有効にするには、Hyper-VとVirtual Machine Platformを有効化する必要があります。以下の手順で設定します。

1. PowerShellを管理者権限で起動

2. 次のコマンドを実行
   powershell
dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

3. システム再起動後、WSL2を初期化
   powershell
wsl --install

Linuxディストリビューションのインストール

WSL2ではUbuntuなどのLinuxディストリビューションが必要です。Microsoft StoreからUbuntu 22.04 LTSをダウンロードし、インストールします。

注意: WSL2が有効になっていない状態でLinuxをインストールすると、Docker Desktopの連携に失敗する可能性があります。
代替オプション: DebianやCentOSなど他のLTSバージョンも利用可能です（公式リポジトリで確認してください）。

Docker Desktop Installer.exeの公式ダウンロード方法

最新版のDocker Desktopは、公式サイトから入手します。

最新版の入手サイト

https://www.docker.com/products/docker-desktop/ にアクセスし、「Download for Windows」をクリック。ZIPファイルまたはインストーラーをダウンロードします。

バージョンチェックポイント

公式リリース情報から、最新バージョン（例: Docker Desktop 4.x以上）を使用することを推奨します。過去バージョンはWSL2との互換性が保証されないため、トラブルが発生する可能性があります。

WSL2とDocker Desktopの連携設定手順

Docker DesktopをWSL2環境で動作させるには、設定ファイルを編集します。

Dockerデーモン起動確認

WSL2でLinuxディストリビューションを開き、以下を実行してDockerサービスが起動しているか確認します。

「active (running)」と表示されない場合は、Docker Desktopの設定からWSL2バックエンドを指定します。

WSL2バックエンド設定変更

PowerShellで以下のコマンドを実行し、WSL2をデフォルトに設定します。

その後、Docker Desktopの「Settings」→「Resources」→「WSL Integration」で、インストールしたLinuxディストリビューションを選択します。

インストールコマンドの実行手順

Docker Desktopをインストール後、PowerShellまたはコマンドプロンプトで初期化を行います。

PowerShellでの基本コマンド

公式ガイドに従い、以下を実行します。

インストール完了後に自動起動されます。起動しない場合は、タスクバーのDockerアイコンから「Start Docker Desktop」を選択します。

エラーメッセージの見分け方

以下のようなエラーが表示される場合、WSL2が正しく設定されていない可能性があります。

• "WSL2 is not enabled on this machine."
  → wsl --set-default-version 2 を再度実行します。

• "Cannot start service Docker..."
  → Windowsの「サービス」でDockerサービスを起動し、権限を確認してください。

hello-worldイメージで動作確認

インストールが完了したら、Docker CLIで基本的な操作を試してみましょう。

Docker CLI操作手順

1. PowerShellまたはWSL2ターミナルを開く
2. 以下のコマンドを実行
   bash
docker run hello-world

出力に「Hello from Docker!」と表示されれば、インストールは成功です。

ログ出力の解釈方法

エラーメッセージが表示された場合、以下のように対処します。

• "Cannot connect to the Docker daemon..."
  → Dockerサービスが起動していないか確認します。

• "no matching manifest for..."
  → コンテナイメージのアーキテクチャ（x86_64など）に不一致がある可能性があります。

まとめ

本記事では、最新版Docker DesktopをWSL2環境でスムーズにインストールする手順を解説しました。以下のポイントを確認してください：

• WSL2の有効化 を忘れないこと
• 公式リリースバージョン を使用すること
• DockerデーモンとWSL2の連携設定 に注意すること

手順に沿ってインストールし、WSL2環境でのコンテナ開発を開始してください。問題が発生した場合はコメント欄で質問を受け付けています。

システム要件比較表

リンクと参考情報

• Microsoft公式: WSLインストールガイド
• Docker公式: WSL2設定手順
• WSL2 vs Docker Desktop: 対応状況確認ツール

重要事項: 本記事の内容は、現在の最新情報を基に作成されており、将来的な変更やバージョンアップに伴う手順違いが生じる可能性があります。公式ドキュメントを常に参照してください。