Windows11(WSL2)上のUbuntuにDocker EngineをインストールしてLinuxコンテナを実行してみる

Posted at 2024-07-15

Windows環境上でDockerを利用する場合は

① WindowsにDocker Desktopをインストールして利用する（Windowsコンテナ、LinuxコンテナはWSL2と連携）
②Windows上のWSL2でLinux環境を用意して、その上にDocker Engineをインストールして利用する（Linuxコンテナ）
③ Windows上にDocker Engineをインストール（Windowsコンテナ）

の方法がありますが、今回は②の方法でインストールを行い、Linuxコンテナを実行してみます。

Docker Desktop有償化について

環境用意としては、Docker Desktopをインストールするのが一番簡単でてっとり早いかと思いますが、

2024年7月現在、Docker Desktopが無償利用に一定の条件があるため。
今回はDocker Desktopではなく、Docker Engineをインストールして利用してみます。

なおDockerのサブスクリプションとライセンスについては、下記のよくある質問に説明があります。

Dockerに関するよくある質問

参考Webサイト

今回利用する環境

Windows 11 23H2
WSL2上のUbuntu 22.04
Docker Engine - Community 27.0.3

WSL2のインストールについて

Windows11にWSL2環境の用意については下記記事を参照して用意してください。

Windows 11にWSL2をインストールする

Docker Engineのインストールについて

Install Docker Engine on Ubuntu

本記事では上記手順を参照し、Ubuntu22.04にDocker Engineをインストールします。

なお、公式ドキュメントを確認するともろもろを一発でインストールしてくれるスクリプトも提供されているようですが、今回は利用しません。

Install using the convenience script

なおこのインストールスクリプトについては、本番環境での利用は非推奨となっていました。

古いバージョンの削除

Uninstall old versions

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

まずは上記コマンドで古いバージョンがインストールされている場合、こちらを削除するようです。

上記コマンドでは下記のパッケージがインストールされていたら削除しています。

docker.io
docker-compose
docker-compose-v2
docker-doc
podman-docker

実施している環境は以前にDockerをインストールしていなかったため、対象はありませんでした。

Dockerエンジンのインストール

Install using the apt repository

本記事ではaptリポジトリを利用してインストールしていきます。

リポジトリの登録

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update