Dockerの導入方法(詳細ガイド)

Docker の導入方法(詳細ガイド)


目次

  1. Mac 編:Docker Desktop のインストール
  2. Mac 編:Homebrew 経由でのインストール
  3. Ubuntu 編:Docker Engine のインストール(apt リポジトリ)
  4. Ubuntu 編:ワンコマンドスクリプトでのインストール
  5. Colima による代替案(Mac の CLI 環境)
  6. 動作確認とトラブルシューティング
  7. 参考URL・ドキュメント

1. Mac 編:Docker Desktop のインストール(GUI)

システム要件

項目 要件
OS macOS 12 (Monterey) 以降(最新バージョン + 直前の 2 バージョン対応)
メモリ 4 GB 以上(推奨)
CPU Apple Silicon (M1/M2/M3) または Intel チップ対応

手順①:公式サイトからダウンロード

  1. ブラウザでDocker 公式サイトにアクセス
  2. 「Download for Mac」をクリック
  3. 自分の Mac に合ったインストーラーを選択
  4. Apple Silicon 製 Mac(M シリーズ): Mac with Apple silicon
  5. Intel 製 Mac: Mac with Intel chip

手順②:DMG ファイルを開いてインストール

# ダウンロードした Docker.dmg をダブルクリックで開く
# Docker.app を Applications フォルダへドラッグ&ドロップ

デフォルトのインストール先:/Applications/Docker.app

手順③:Docker Desktop の起動

  1. Applications フォルダから Docker.app をダブルクリック
  2. 「Docker Subscription Service Agreement」画面で「Accept」を選択
  3. 以下の設定をプロンプトに従って選択
  4. Use recommended settings(推奨、パスワード入力が必要)
  5. Use advanced settings(詳細設定:CLI ツールの場所、デフォルト socket、特権付きポートマッピング等)
  6. 「Finish」をクリック

Docker Desktop が起動するまでの確認

  • メニューバーに🐳クジラのアイコンが表示される
  • 左下に Engine running と表示されれば準備完了
  • 初回起動時はネットワーク設定等に数分かかる場合がある

2. Mac 編:Homebrew 経由でのインストール(CLI)

ターミナルから Docker Desktop を導入する手順。

インストールコマンド

brew install --cask docker

起動

open /Applications/Docker.app

メニューバーに🐳アイコンが表示されれば成功。初回起動時に管理者パスワードの入力が求められる。


3. Ubuntu 編:Docker Engine のインストール(apt リポジトリ)

システム要件

項目 要件
OS Ubuntu 24.04 LTS (Noble) / 22.04 LTS (Jammy) 以降の 64 ビット版
アーキテクチャ amd64, arm64, armhf, s390x, ppc64le 対応
カーネル 3.10 以降

ステップ①:使用前のパッケージを削除

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)

古い非公式パッケージを削除し、衝突を防ぐ。

ステップ②:Docker 公式リポジトリのセットアップ

GPG キーの追加

sudo apt update
sudo apt 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

リポジトリの追加

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

ステップ③:Docker パッケージのインストール

最新版をインストール

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

特定バージョンをインストール

# 利用可能なバージョンの一覧を確認
apt list --all-versions docker-ce

# 例: 5:29.4.1-1~ubuntu.24.04~noble の場合
VERSION_STRING=5:29.4.1-1~ubuntu.24.04~noble
sudo apt install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin

ステップ④:Docker サービスの確認

# 動作確認
sudo systemctl status docker

# 停止している場合は手動で開始
sudo systemctl start docker

4. Ubuntu 編:ワンコマンドスクリプトでのインストール( convenience script )

開発環境向けの手軽な方法。本番環境への使用は推奨されない

インストール手順

# スクリプトをダウンロードして実行
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh

事前チェック(dry-run)

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh --dry-run

--dry-run オプションで実際に何が行われるか事前に確認できる。


5. Colima による代替案(Mac の CLI 環境)

Docker Desktop の GUI に依存したくない場合に使える代替手段。Colima は Mac 上で Linux 仮想マシン(VM)を自動作成し、その中で Docker Engine を実行するツール。

インストール手順

# Homebrew で Colima と関連パッケージをインストール
brew install colima
brew install docker
brew install docker-compose
brew install docker-buildx

起動方法

# 仮想マシン(VM)の作成と起動
colima start

# Docker CLI の確認
docker --version

# Docker Compose CLI の確認
docker compose version

停止・再起動

colima stop          # 停止
colima start          # 再起動
brew services start colima   # 自動起動設定

参考: 2025 年1月に Docker Desktop にマルウェア被害が報告された件を踏まえ、CLI 環境を重視するユーザーの間で Colima の採用が増加している。


6. 動作確認とトラブルシューティング

Docker のバージョン確認

docker --version

docker: command not found が表示される場合:
– Docker Desktop が起動していない可能性 → open /Applications/Docker.app で起動後、再試行
$PATH が通っていない可能性がある

hello-world コンテナの実行(動作確認)

# Mac, Linux 共通
docker run hello-world

以下のメッセージが表示されればインストール成功:

Hello from Docker!
This message shows that your installation appears to be working correctly.

Ubuntu で非 root ユーザーとして Docker を使う(任意)

sudo usermod -aG docker $USER

適用にはログアウト・再ログインが必要。

Mac : Rosetta のインストール(Apple Silicon 環境)

softwareupdate --install-rosetta

Rosetta 2 は Apple Silicon Mac で x86_64 アーキテクチャのツールを動かすために必要。


7. Docker Desktop for Linux(Ubuntu 向け GUI 版)

Ubuntu でも Docker Desktop(GUI アプリ)を利用できる。

インストール手順

# リポジトリセットアップを先に実行(Step 3 参照)

# DEBIAN パッケージのダウンロード・インストール
sudo apt-get update
sudo apt-get install ./docker-desktop-amd64.deb

デフォルトのインストール先:/opt/docker-desktop

起動後に Docker CLI が自動で設定され、ターミナルから docker コマンドが利用可能になる。


まとめ:使い分けガイド

用途 おすすめ方法
Mac で手軽に始めたい Docker Desktop(GUI / DMG)
Homebrew ユーザーの Mac brew install --cask docker
Ubuntu サーバー向け apt リポジトリ経由で Docker Engine
Ubuntu クイック試したい convenience script(get.docker.com
GUI 不要の Mac 環境 Colima + Docker CLI
Ubuntu で GUI が欲しい Docker Desktop for Linux (DEB)

Reference / URL


本ドキュメントは Docker 公式ドキュメントおよび Community Blog 記事を基に作成しています(2025 年 4 月時点)
macOS の場合、最新 + 直前の2メジャーバージョンの macOS に Docker Desktop は対応しています。

コメント

タイトルとURLをコピーしました