⑥Docker・コンテナ

DockerをUbuntuにインストールして使い始める【セットアップ完全ガイド】

⑥Docker・コンテナ
記事内に広告が含まれています。

前の記事でDockerの概念を学びました。この記事では、UbuntuにDockerを実際にインストールして、最初のコンテナを動かすところまでひとつずつ丁寧に進めます。コマンドを1行ずつ何をしているのか説明しながら進めますので、初めてでも安心してください。

インストール前の確認

Ubuntuのバージョンを確認します。DockerはUbuntu 20.04・22.04・24.04に対応しています。

lsb_release -a

Description: Ubuntu 22.04.x LTS のような表示が出ればOKです。

Step 1:古いバージョンを削除する

以前にDockerをインストールしたことがある場合は削除します。初めての場合でも実行して問題ありません。

sudo apt-get remove docker docker-engine docker.io containerd runc

Step 2:必要なパッケージをインストール

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

ca-certificatesはHTTPS通信に必要な証明書、curlはURLからファイルをダウンロードするコマンド、gnupgはパッケージの署名を検証するツールです。

Step 3:DockerのGPGキーを追加

GPGキーは「このパッケージは本物の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

Step 4:Dockerのリポジトリを追加

このコマンドでDockerの公式リポジトリをaptのソースリストに追加します。これによりaptコマンドでDockerをインストール・更新できるようになります。

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

Step 5:Dockerをインストール

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
パッケージ名役割
docker-ceDocker本体(Community Edition)
docker-ce-clidockerコマンドラインツール
containerd.ioコンテナの実行エンジン
docker-buildx-pluginイメージビルドの拡張機能
docker-compose-plugindocker composeコマンドを使えるようにする

Step 6:インストールの確認

docker --version

Docker version 27.x.x のように表示されればインストール成功です。

Step 7:sudoなしでdockerコマンドを使えるようにする

デフォルトではdockerコマンドはroot権限が必要なため、毎回sudoをつける必要があります。以下の設定でsudoなしで使えるようになります。

sudo usermod -aG docker $USER

設定を反映させるために一度ログアウトして再ログインしてください。サーバーを再起動しても構いません。

Step 8:最初のコンテナを動かしてみよう

再ログイン後、いよいよ最初のコンテナを起動します。

docker run hello-world

このコマンドを実行すると、Dockerがhello-worldイメージをDocker Hubから自動でダウンロードし、コンテナを起動してHello from Docker!と表示します。このメッセージが出ればDockerが正常に動作しています!

よく使う基本コマンド

コマンド何をするか
docker pull イメージ名Docker Hubからイメージをダウンロード
docker imagesダウンロード済みイメージ一覧
docker run イメージ名イメージからコンテナを起動
docker run -it イメージ bashコンテナに入って操作(インタラクティブモード)
docker run -d イメージバックグラウンドで起動
docker ps起動中のコンテナ一覧
docker ps -a停止中も含む全コンテナ一覧
docker stop コンテナIDコンテナを停止
docker rm コンテナIDコンテナを削除
docker rmi イメージ名イメージを削除

つまずきやすいポイント

「permission denied」エラーが出る

permission denied while trying to connect to the Docker daemon socketと出る場合は、dockerグループへの追加が反映されていません。ログアウトして再ログインしてから再度試してください。それでも直らない場合はnewgrp dockerと打ってください。

「Cannot connect to the Docker daemon」エラーが出る

Dockerサービスが起動していない場合に発生します。sudo systemctl start dockerでDockerを起動し、sudo systemctl enable dockerでサーバー起動時に自動起動するよう設定してください。

まとめ

  • Dockerのインストールは公式リポジトリを追加してからapt-get installで行う
  • sudo usermod -aG docker $USERでsudoなしでdockerコマンドを使えるようにする(再ログイン必要)
  • docker run hello-worldで正常動作を確認できる
  • 「permission denied」エラーはログアウト&再ログインで解決できることが多い

Dockerがインストールできたら、次の記事ではDockerfileを使って自分だけのオリジナルイメージを作る方法を学びます。

コメント

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