概要

Windows 11 で Docker Desktop を動かすまでの手順を、比較的初心者を対象とし、順を追って作業できるようにまとめました。

背景など

こんにちは、Docker Captainをしている @zembutsu です。この記事はさくらインターネットAdvent Calendar 2023の4日目の記事として書きました（気づいたら枠が空いていたので差し込みました）。

まっさらな状態のWindows 11を手に入れ、Docker Desktopを入れ直す機会があり、ついでにセットアップ手順も確認しました。

Docker Desktop for Windows 11 が動くPCとは

ドキュメントのシステム要件¹ によると、Windows 11で動かすには：

Windows 11 64bit: 21H2 以上（Home、Pro、Enterprise、Educationの各エディション）
メモリ 4GB
BIOS/UEFI でハードウェア仮想化に対応(hardware virtualization)

とあります。メモリは、そもそも Windows 11 自身が 4GB を動作環境としていますので、普通に Windows 11 が動けば特に気にする必要は無いでしょう。ハードウェア仮想化に対応しているかどうかは使っている CPU に依存します。もし BIOS/UEFI で無効になっていれば、有効化が必要です。

動作要件を満たしていれば、Docker Desktop のダウンロードとインストールに進みます。

以前のDocker Desktopは、事前にWSL2やカーネルファイル等のセットアップや設定が必要でした。WSL2とは、Windows Subsystem for LinuxはWindows上でLinuxを動かすための仕組みです。現在は、WSL2が入っていなくても、Docker Desktopのインストール中に自動でセットアップされます。
（詳しい方向けの補足情報：デフォルトではUbuntuがセットアップされます。他のLinuxディストリビューションを使いたい場合は、この段階で手動でもセットアップ可能です。また、自分でディストリビューションを決めた場合、Docker Desktop側でのWSL自動更新機能は無効にするかどうかの検討も必要です。）

Docker Desktop for Windows のダウンロードとインストール

ダウンロード

インストールをするには、Docker Desktopをインストールするプログラム（インストーラー）が必要です。Docker のウェブサイト https://www.docker.com/get-started/ からファイルをダウンロードできます。ページを開くと、次のような画像が開きますので【 Download for Windows 】（Windows用をダウンロード）をクリックします。

ブラウザでダウンロード始まり、終われば「ダウンロード」フォルダにファイルが入っています。エクスプローラーを起動して、「ダウンロード」を開くと、次のように【 Docker Desktop Installer 】のアイコンが見えますので、これをクリックします。

インストール

プログラムを起動すると、Windows の警告画面「ユーアーアカウント制御　このアプリがデバイスに変更を加えることを許可しますか？」という画面が出ます。「信頼済みの発行元：」が【 Docker Inc 】と表示されているのを確認した上で【はい】を選びます。インストール途中、もう一度この画面が出たら、同じように【はい】を押します。

しばらくすると、次のように設定画面が出ます。以下2つの項目にチェックが入っています。

「Use WSL 2 instead of Hyper-V (recommended)」（Hyper-Vの代わりにWSL 2 を使う：推奨）
「Add shortcut to desktop」（デスクトップにショートカットを追加）

すでに Hyper-V を使っている場合は、クリックしてチェックを外します。まっさらな状態からのインストールであり、特に理由も無ければ、そのまま WSL 2 を使う設定で大丈夫です。また、デスクトップのショートカットが不要であれば、外しておきます。

確認したら【 OK 】をクリックします。

あとは、自動的にインストールが進行します。WSL が入っていない場合は、画面の後ろ側でインストール作業をしています。時間が多少かかるかもしれませんが、完了するまで画面をそのままにして待ちます。

インストールに成功すると、「Installation succeeded」（インストール成功）を表示されますので、【 Close and restart 】（閉じて再起動）をクリックして、PCを再起動します。もし何か作業中で保存していないものがあれば、再起動前に保存するのをお忘れなく。

PC再起動後のセットアップ

再起動が終わると、自動的に Docker Desktop が起動します。そして「Docker Subscription Service Agreement」が表示されます。これはサブスクリプションの使用許諾で、概要は次の通りです。

Docker Desktop は、中小企業（従業員 250 人未満、かつ、年間売上高が 1,000 万米ドル未満）、個人利用、教育、非商用オープンソースプロジェクトは無料です。
それ以外の場合は、サブスクリプションの支払が必要です。
行政機関もサブスクリプションの支払が必要です。
Docker Pro、 Team、Business サブスクリプションには、 Docker Desktop の商業的利用を含みます。

内容を確認して【 Accept 】（受け入れる）をクリックします。

次に、インストールの最後で WSL 2 の自動更新をするか手動更新を行うか画面に表示されます。ここでは、特に理由がなければ、そのまま【 Finish 】をクリックします。

Docker Desktop を操作する前に

作業はあと少しです！

次は「Welcome to Docker Desktop」（Docker Desktop へようこそ）と表示されます。Docker Hub の ID を持っている場合は「Sign up」をクリックしてログインできます。ID を持っていない場合は【 Continue without signing in 】（サインインせずに継続）をクリックします。

そして、最後にアンケートが表示されます。「Tell us about the work you do」（どんなお仕事をしているか教えてください）と出ていますので、「What's your role?」（どんな役割？）のメニューから、必ず何かしらを選択します。そして【 Continue 】をクリックします。

これでセットアップは完了です！ Docker Engine（Dockerコンテナやイメージを操作するプログラム）が起動中の表示に変わります。

次の画面に切り替われば、Docker Desktop を操作できます。

hello-world コンテナの実行

実際にコンテナが動くかどうか見てみましょう。虫眼鏡マークの検索ボックスで hello-world と入力すると、バッジのような公式マークが付いたイメージが見えます。これが Docker 公式イメージ(Official image）と呼ばれるものです。この列の右端の【 Run 】をクリックすると、コンテナを実行できます。

次の画面では詳細オプションを設定できます。ここでは、そのまま【 Run 】（実行）をクリックします。

あとは、自動的に hello-world Docker イメージをダウンロードし、このイメージを使う Docker コンテナを実行します。このコンテナは文字を出すだけですので、次のようにログの画面で実行結果を確認できます。

nginx コンテナの実行と、ファイアウォール設定の許可

もう1つコンテナを動かしてみましょう。Nginx の Docker イメージを使い、コンテナとして動かし、さらにブラウザで開きます。

先ほどと同様に、検索ボックスに nginx を入れます。検索したら、公式 Nginx イメージを見つけ【 Run 】をクリックします。

先ほどの手順とは異なり、【 Optional settings 】（オプション設定）をクリックします。そして出てくる項目のうち「Host port」に【 80 】を入れ、【 Run 】をクリックします。（すでにPC上でポート 80 を使用するプログラムを実行していると使えませんので、8080 など別の番号にします）

すると、次は「パブリックネットワークとプライベートネットワークにこのアプリへのアクセスをきょかしますか？」と表示が出ます。次の画面のように発行元が「Docker Inc.」と出ているのを確認し、【許可】をクリックします。

Nginx Dockerイメージをダウンロードした後、コンテナが起動します。次の画像のように、【 80:80 】と書かれているリンクをクリックします。この意味は、ホスト側、つまりPC側のポート 80 をコンテナ内のポート 80 に接続（マッピング）する意味があります。

リンク先をブラウザで開くと、次のように Nginx の初期画面が表示されます。

使用が終わったコンテナは「Actions」列にあるボタンをくりくし、停止・削除できます。

セットアップが終わったら？

「ハンズオンガイド」や「始め方」の公式ドキュメントの日本語訳がありますので、そちらを読み進めて慣れてみてはいかがでしょう。

Enjoy!

補足：「WSLでUbuntuを使いたいのですが？」

今回の手順インストールする WSL では、 docker-desktop と docker-deskto-data という名前の、 Docker Desktop を動かすことに特化した² Linux ディストリビューションが自動的にセットアップされます。

> wsl --list
Linux 用 Windows サブシステム ディストリビューション:
docker-desktop (既定)
docker-desktop-data

このように、何らかの Linux ディストリビューションが入っているかのように見えますが、実際の開発用とでは使えないでしょう。たとえば、 apt や dnf といったお馴染みのコマンドは使えません。

それでは、どのようにして Ubuntu を WSL で使えば良いのでしょうか。手順は2つあります。

Windows ストアで Ubuntu を探す

1つは、Windows ストアで Ubuntu を探します。アプリ「Windows Store」を起動し、検索画面で「Ubuntu」と入力します。【入手】をクリックするとダウンロードが始まります。

ダウンロードが終わったら、【開く】のボタンを押します。

ボタンを押すと、Ubuntu を初めて動かすための設定（初期化）が行われます。次のような画面が出てきたら「Enter new UNIX username:」（新しいUNIXユーザ名の入力）で、好きなユーザ名をに入力します（英語・数字・一部の記号）。これが、通常 Ubuntu 内で操作を行う（権限を持つ）ユーザ名になります。

その次の「New password:」と「Retype new password:」では、そのユーザ用のパスワードを設定します（ sudo コマンドを使うときにも、このパスワードを入力します）。ここではキーボードを操作しても画面には文字が出ません。入力後に「エンターキー」を押します。確認用のパスワードと含めて、同じ文字列を二度入力します。

入力が正しければ、「この操作を正しく終了しました。」と出て、もう少し待てば Ubuntu が使えるようになります。

以上で Ubuntu のセットアップは完了です。

しかし、これだけでは Ubuntu 内で docker コマンドが使えません。普通に使えるようにするには、次の手順に進みます。

WLS のデフォルトディストリビューションを Ubuntu に変更する

これまでの手順を進めてきた場合、デフォルトでは WSL 内では docker-desktop がデフォルトの WSL 用ディストリビューションです。 wsl -l -v コマンドを実行すると、次のように入っているディストリビューション一覧が表示されますが docker-desktop に * 印が付いており、これがデフォルトと分かります。

> wsl -l -v
  NAME                   STATE           VERSION
* docker-desktop         Running         2
  docker-desktop-data    Running         2
  Ubuntu                 Running         2

これを変更するには、コマンド wsl --set-default ubuntu と入力します。

> wsl --set-default ubuntu
この操作を正しく終了しました。

それから、再度ディストリビューション一覧を表示すると、今度は ubuntu に * マークが付いていて、設定の切り替わりを確認できます。

> wsl --list
Linux 用 Windows サブシステム ディストリビューション:
Ubuntu (既定)
docker-desktop-data
docker-desktop

あとは、Windows メニューから wsl を起動すると、ubuntu にログインした状態の画面が開き、かつ、 docker コマンドも使えるようになります。