UbuntuにDocker Engineをインストールする手順|WSL対応 | Snow System

Ubuntu環境(ネイティブのLinux環境や、Windows 11のWSL2上で動作するUbuntu)にDockerを導入する際、Ubuntuの標準APTリポジトリからインストールしてしまうと、バージョンが古かったり最新のDocker機能が使えなかったりすることがあります。

安全かつ最新のDocker環境を構築・運用するためには、Docker公式のAPTリポジトリを設定してインストールするのがベストプラクティスです。

かつて広く使われていた apt-key add を用いた手順は、Ubuntuのセキュリティ強化により現在では非推奨となっています。本記事では、公式ドキュメントに準拠した最新のkeyrings方式によるGPGキー登録から、Docker Engine本体・Composeプラグインの導入、WSL2環境での自動起動設定までを体系的に解説します。

目次

  1. UbuntuへのDocker Engine導入概要
  2. 事前準備:古いバージョンの削除
  3. Docker公式APTリポジトリのセットアップ
  4. Docker Engineのインストール
  5. インストールの動作確認(hello-world)
  6. WSL2環境特有の推奨設定(systemdと非root実行)
  7. まとめ:公式リポジトリを使って安全にDockerを運用しよう
  8. 参考情報
  9. 次に読むおすすめ記事

UbuntuへのDocker Engine導入概要

本手順では、以下の最新コンポーネントを一括で導入します。

  • docker-ce: Docker Engine本体(Community Edition)
  • docker-ce-cli: Dockerコマンドを実行するためのCLIツール
  • containerd.io: コンテナランタイム
  • docker-buildx-plugin: 高度なビルド機能を提供するBuildxプラグイン
  • docker-compose-plugin: docker compose コマンドを提供する最新Compose v2プラグイン

Ubuntu 22.04 LTS、Ubuntu 24.04 LTS、およびWSL2上のUbuntu環境のいずれでも共通して利用できる手順です。

事前準備:古いバージョンの削除

以前にUbuntu標準パッケージのDocker(docker.io 等)を導入したことがある場合は、パッケージ競合を防ぐためにアンインストールしておきます。

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

未インストールのパッケージがあってもエラーにはならずスキップされるため、安心して実行してください。

Docker公式APTリポジトリのセットアップ

Docker公式リポジトリから安全にパッケージを取得できるように、リポジトリ情報を登録します。

1. 必要なツールのインストール

HTTPS経由でリポジトリを取得するための基本ツールを導入します。

sudo apt-get update
sudo apt-get install -y ca-certificates curl

2. Docker公式GPGキーの追加

リポジトリの署名検証に使うGPGキーをダウンロードし、/etc/apt/keyrings ディレクトリに保存します。

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

3. APTリポジトリの登録

システムのアーキテクチャ(x86_64やarm64)とUbuntuのコードネームを自動判定して、Docker公式リポジトリのソースリストを作成します。

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

登録後、パッケージリストを更新します。

sudo apt-get update

Docker Engineのインストール

リポジトリの準備が整ったら、Docker Engineおよび関連ツールをインストールします。

sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

インストール完了後、バージョン確認コマンドを実行して正常に導入されたことを確認します。

docker --version

Docker version 27.x.x, build ... のように最新バージョンが表示されれば成功です。

インストールの動作確認(hello-world)

公式テスト用イメージである hello-world を実行し、コンテナが正常に起動・終了するかテストします。

sudo docker run hello-world

コンテナイメージが自動でダウンロードされ、画面に Hello from Docker! というメッセージが表示されれば、Docker Engineは正常に動作しています。

WSL2環境特有の推奨設定(systemdと非root実行)

WSL2のUbuntu環境でDockerを利用する場合、日々の開発体験を快適にするために以下の2点を設定しておくことを強く推奨します。

1. systemdの有効化(Dockerデーモンの自動起動)

WSL2を起動した際にDockerデーモン(dockerd)が自動で起動するように、WSLの設定ファイル /etc/wsl.conf を確認・編集します。

sudo nano /etc/wsl.conf

以下の記述を追加または確認してください。

[boot]
systemd=true

設定を反映するには、WindowsのPowerShellで一度 wsl --shutdown を実行して再起動します。

再起動後、以下のコマンドでDockerサービスが自動起動しているか確認できます。

sudo systemctl status docker

2. 一般ユーザーのdockerグループ追加(sudoなし実行)

毎回 sudo docker ... と入力する手間を省くため、現在ログインしている一般ユーザーを docker グループに追加します。

sudo usermod -aG docker $USER

設定を反映するため、一度シェルを再起動するか、以下のコマンドを実行します。

newgrp docker

これで、sudo を付けずに docker ps や docker run が実行できるようになります。

まとめ:公式リポジトリを使って安全にDockerを運用しよう

UbuntuにDocker Engineを導入する際は、公式APTリポジトリを利用することで、セキュリティアップデートや新機能の恩恵を素早く受けることができます。

WSL2環境でもsystemdの標準サポートにより、ネイティブLinuxとまったく同じ感覚で快適にコンテナ開発が行えるようになりました。

今後はコンテナを活用して、Webアプリやデータベースなどの開発環境を構築していきましょう。

参考情報

次に読むおすすめ記事

UbuntuにDocker Engineを導入した後は、複数コンテナを一元管理するDocker Composeの使い方や、Windows 11での開発環境ロードマップもあわせてご覧ください。