WSL 2 への Docker インストール - 最初のコンテナーのセットアップ

まずは PC をチェックしてください

WSL 2 バックエンドを備えた Docker デスクトップには 3 つのことが必要ですが、この 2 分間のチェックをスキップすると、一晩を無駄にしてしまいます。まず、Windows のバージョンです。Windows 10 バージョン 2004 以降、または Windows 11 が必要です。Win + R を押し、winver と入力して Enter を押すと、正確なバージョンが表示されます。

winver

次に、BIOS または UEFI で仮想化をオンにする必要があります。タスク マネージャーを開き、パフォーマンス、CPU の順に移動し、仮想化: 有効 を探します。 「無効」と表示されている場合は、どのソフトウェア設定も保存できません。まず BIOS で Intel VT-x または AMD SVM を有効にしてください。 3 番目に、約 4 GB の空き RAM と数 GB のディスクの予備を確保します。WSL 2 と Docker はマシンを共有します。マシンを置き換えることはありません。

何よりもまず WSL 2 をインストールしてください

Windows での Docker インストールの失敗のほとんどは、順序が間違っていたという退屈な理由で失敗します。 Docker Desktop はその下で WSL 2 が動作することを想定しているため、最初に基盤を構築します。管理者として PowerShell を開き、次の 1 つのコマンドを実行します。

wsl --install

終了させてから PC を再起動します。再起動はオプションではなく、仮想化コンポーネントが読み込まれます。再起動後、Ubuntu (デフォルトのディストリビューション) は独自のセットアップを完了し、Linux ユーザー名とパスワードを作成するよう求めます。

WSL 2 が本当に準備ができているかを確認する

Docker がマシンに近づく前に、次の 2 つのコマンドで基盤を確認します。

wsl --status
wsl -l -v

ディストリビューションのリストにはバージョン 2 が表示されます。 1 と表示されている場合は、デフォルトのバージョンを設定し、コマンド出力が示すようにディストリビューションを変換します。

wsl --set-default-version 2

各レイヤーは次のレイヤーに進む前にテストされるため、後で何か障害が発生した場合、どのレイヤーが問題を引き起こしているかを正確に知ることができます。

Docker デスクトップを最上位にインストールする

Docker Desktop は docker.com からのみダウンロードしてください。サードパーティのダウンロード サイトでは、ジャンク品と一般的なインストーラーがバンドルされています。インストーラーを実行し、[Hyper-V の代わりに WSL 2 を使用する] オプションをオンのままにします。ほとんどの PC では、デフォルトでチェックが入っています。

インストーラーが尋ねたら、インストーラーを閉じてログアウトするか、プロンプトが表示されたら再起動します。 Docker は Windows アカウントをローカルの docker-users グループに追加し、グループのメンバーシップは新たにサインインした場合にのみ有効になります。これは、ほとんどのガイドが省略している正直なチェックであり、サインアウトして再度サインインするまで Docker が起動を拒否する場合があるのはこのためです。

Docker Desktop を起動し、システム トレイのクジラのアイコンが安定し、 ダッシュボードにエンジンが動作中 であることが報告されるまで待ちます。最初の起動は遅いです。数分待ってください。 Docker サブスクリプション サービス契約画面に正直に同意します。これは本物のライセンスです。

最初のコンテナを実行する — Hello World

新しい PowerShell またはターミナル ウィンドウを開き、チェーン全体が機能することを証明する 2 つのコマンドを実行します。

docker --version
docker run hello-world

docker --version は、クライアントが PATH 上にインストールされていることを証明します。 docker run hello-world は、他のすべてを証明しています。Docker はローカルでイメージを見つけることができず、Docker Hub からイメージをダウンロードし、そこからコンテナを作成して実行し、Hello from Docker! メッセージを出力します。このメッセージが表示された場合、チェーンは端末、クライアント、WSL 2 内のエンジン、ネットワーク、レジストリでエンドツーエンドで動作します。