windows環境にDockerをインストールする方法を紹介します。
windows環境では、WSL2+Docker環境を構築することでDockerをインストールすることできます。また、WSL2+DockerではDocker Desktopを利用せずにDockerを運用することができます。
windows11にWSL2+Docker環境を構築したので、windowsにDocker環境構築を考えている方は本記事をご参考ください。また、本記事の最後にDocker Desktopのインストール方法も紹介しておりますので、Docker Desktopを利用したい方は参考ください。
前提条件
WSL2のバックエンドとしてWindowsのエディション・バージョンが下記要件を満たす必要があります。また、WindowsでWSL 2機能を有効にする必要があります。詳細な手順については、Microsoftのドキュメントを参照してください。
Windows 10またはWindows 11でWSL 2を正常に実行するには、以下のハードウェアの前提条件が必要です。
私の動作環境は下記になります。
こちらの環境では紹介する方法でDocker環境構築が確認できております。
WLS2のインストール
PowerShellまたはコマンドプロンプトを管理者モードで開き、wsl --install
コマンド入力ます。こちらのコマンドでWSL2をインストールするだけでなく、Ubuntuもインストールしてくれます。
wsl --install
インストール済みの場合は念のためアップデートをします。
wls --update
WSL2でUbuntuが動作しているか確認をします。VERSIONが2になっていることを確認します。
wsl -l -v
NAME STATE VERSION
* Ubuntu Running 2
Dockerのインストール
WSL2を起動してUbuntuを起動します。起動方法はwsl -d <Distribution Name>
コマンドでWSL2を起動します。(私の場合はUbuntuになります。)
wsl -d Ubuntu
公式サイトの手順通りにインストールを行っていきます。
Dcokerのセットアップ
先ほど起動したUbuntuにインストールをするためにセットアップを行います。
apt
の更新とパッケージのインストール
$ sudo apt-get update
$ sudo apt-get install \
ca-certificates \
curl \
gnupg
Docker公式鍵を追加
$ sudo install -m 0755 -d /etc/apt/keyrings
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
$ sudo chmod a+r /etc/apt/keyrings/docker.gpg
レポジトリのセットアップ
$ echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Docker Engineのインストール
最新版のDocker Engineをインストールする。docker-composeもインストールします。
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
任意ですが、下記でユーザー権限でDockerを起動できます。
$ sudo usermod -aG docker $USER
Dockerのインストールが成功しているか確認します。
$ sudo docker run hello-world
下記の7-8行目にある表示があればDcokerのインストールが正常に完了しております。
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
2db29710123e: Pull complete
Digest: sha256:4e83453afed1b4fa1a3500525091dbfca6ce1e66903fd4c01ff015dbcb1ba33e
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
This message shows that your installation appears to be working correctly.
To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.
To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash
Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/
For more examples and ideas, visit:
https://docs.docker.com/get-started/
Docker Desktopのインストール方法
先ほどまでの手順でDockerはご利用できますが、Docker Desktopの利用を考えている方はインストール方法も紹介しますので、ご参照ください。
Docker Desktopの利用条件には注意が必要です。利用許諾に注意の上、Docker Desktopをご利用ください。
利用許諾についての詳細はブログ記事またはFAQをご覧ください。要点は下記の通りになります。
それではDocker Desktopをインストールしましょう。
公式HPよりインストーラをダウンロード
Docker Desktop Installer.exe
をダブルクリックし、インストーラを起動
確認画面が出たらUse WLS2 instead of Hyper-V
にチェックし、OKをクリック
インストールに成功したら、Closeをクリックします。
さいごに
最後までご覧いただきありがとうございます。
今回はWindowsにDocker環境を構築する方法について紹介しました。
今回の記事は、私自身が試したもので備忘録としても活用しております。誤った情報が含まれている場合は、お知らせいただけますと幸いです。
良き開発を!
コメント