第1章 Docker入門:コンテナの仕組みと基本コマンド

LPIC-3 305(352.1・352.3)相当

Dockerは、アプリケーションを「コンテナ」という独立した環境で動かすための仕組みです。コンテナはLinuxカーネルの機能で実現されているため、これまで学んだプロセスやファイルシステムの知識が、そのまま理解の土台になります。このページでは、仕組みの考え方から、最初に覚えたいコマンド、つまずきやすいエラーの対処までを順番に見ていきます。

このページの要点:
コンテナは「隔離されたLinuxプロセス」です。
イメージからコンテナを作り、docker psで状態を見て、docker logsとdocker execで中を調べる。
この流れを押さえると、基本的な操作と調査ができるようになります。

Dockerとは:コンテナと仮想マシンの違い

サーバーでアプリケーションを動かすとき、必要なライブラリやミドルウェアのバージョンが環境ごとに違うと、「開発環境では動いたのに本番では動かない」という問題が起こります。Dockerは、アプリケーションと、その実行に必要なファイル一式をひとまとめにして、どの環境でも同じように動かせるようにする仕組みです。

似た技術に仮想マシン(VM)があります。仮想マシンは、ハードウェアを仮想化して、その上でOSを丸ごと起動します。一方のコンテナは、ホストのLinuxカーネルをそのまま共有し、プロセスだけを隔離して動かします。OSを起動する手間がないぶん、数秒で立ち上がり、消費するリソースも少ない傾向があります。

比較項目コンテナ仮想マシン
カーネルホストと共有するゲストOSごとに持つ
起動時間数秒程度数十秒〜数分
サイズ数十MB〜数百MBが中心数GB以上になりやすい
隔離の強さプロセス単位の隔離OS単位で、より強い

コンテナを支えるLinuxカーネルの機能

コンテナは特別な魔法ではなく、Linuxカーネルが持つ機能の組み合わせで作られています。中心になるのは次の2つです。

名前空間(namespace)は、プロセスから見える範囲を区切る機能です。PID名前空間ならプロセスID、ネットワーク名前空間ならネットワークインターフェース、マウント名前空間ならファイルシステムの見え方が、コンテナごとに独立します。コンテナの中でpsを実行すると、自分のプロセスしか見えないのは、この機能によるものです。

cgroup(コントロールグループ)は、プロセスが使えるCPUやメモリの量を制限・計測する機能です。あるコンテナがメモリを使い切っても、ホスト全体が巻き込まれないように上限を設けられます。

$ docker run -d --name web nginx
$ ps aux | grep [n]ginx          # ホストから見ると、普通のプロセスとして見える
root      4321  0.0  0.1  11396  7424 ?  Ss  10:00  0:00 nginx: master process nginx -g daemon off;

このように、コンテナの中のプロセスは、ホストからは通常のプロセスとして見えます。「コンテナ=隔離されたプロセス」と捉えると、psやkill、ログ調査といった、これまでの知識がそのまま使えることが分かります。

イメージ・コンテナ・レジストリの関係

Dockerを使ううえで、最初に区別しておきたい用語が3つあります。

  • イメージ:
    アプリケーションと、実行に必要なファイル一式をまとめた、読み取り専用のひな形です。
  • コンテナ:
    イメージをもとに起動した実体です。
    1つのイメージから、複数のコンテナを作れます。
  • レジストリ:
    イメージを保管・配布する場所です。
    代表例がDocker Hubで、docker pullはここからイメージを取得します。

プログラムに例えると、イメージが「実行ファイル」、コンテナが「実行中のプロセス」にあたります。イメージ名はnginx:1.27のように、名前:タグの形で書きます。タグを省略するとlatestが使われますが、どのバージョンが入るかが時期によって変わるため、本番環境ではタグを明示するのが一般的です。

最初のコンテナを動かす

まずはDockerが使える状態かを確認し、動作確認用のコンテナを実行してみましょう。

$ docker --version
Docker version 27.3.1, build ce12230
$ docker run hello-world
Hello from Docker!
This message shows that your installation appears to be working correctly.

docker runは、手元にイメージがなければ自動で取得し、コンテナを作成して起動します。続いて、Webサーバーのnginxをバックグラウンドで起動します。

$ docker run -d --name web -p 8080:80 nginx
$ docker ps
CONTAINER ID   IMAGE   COMMAND                  STATUS         PORTS                  NAMES
3f2a9c1b7d4e   nginx   "/docker-entrypoint.…"   Up 5 seconds   0.0.0.0:8080->80/tcp   web
$ curl -I http://localhost:8080
HTTP/1.1 200 OK

-dはバックグラウンドで動かす指定、--nameはコンテナに名前を付ける指定です。-p 8080:80は「ホストの8080番ポートを、コンテナの80番ポートにつなぐ」という意味で、ホスト側:コンテナ側の順に書きます。この順番は取り違えやすいので、最初に意識しておくとよいでしょう。

よく使うDockerコマンド一覧

コマンド内容
docker ps起動中のコンテナを一覧表示する
docker ps -a停止中のものも含め、すべてのコンテナを表示する
docker images手元にあるイメージを一覧表示する
docker pull nginx:1.27レジストリからイメージを取得する
docker run -d --name web nginxイメージからコンテナを作成して起動する
docker stop webコンテナを停止する
docker start web停止中のコンテナを再び起動する
docker restart webコンテナを再起動する
docker logs -f webコンテナのログを追いかけて表示する
docker exec -it web bash起動中のコンテナの中でシェルを開く
docker inspect webコンテナの詳細な設定をJSONで表示する
docker statsコンテナごとのCPU・メモリ使用量を表示する
docker rm web停止中のコンテナを削除する
docker rmi nginx:1.27イメージを削除する

コンテナの中を調べる:logs・exec・inspect

コンテナが期待どおりに動かないとき、調査の入口になるのがログです。コンテナ内のアプリケーションが標準出力・標準エラーに書き出した内容は、docker logsで確認できます。

$ docker logs --tail 20 web        # 末尾20行だけ表示
$ docker logs -f web               # tail -f のように追いかける
$ docker logs --since 10m web      # 直近10分のログ

ログだけで原因が分からない場合は、docker execでコンテナの中に入り、設定ファイルやプロセスの状態を直接確認します。

$ docker exec -it web bash
root@3f2a9c1b7d4e:/# cat /etc/nginx/conf.d/default.conf
root@3f2a9c1b7d4e:/# exit

-iは標準入力をつなぐ指定、-tは端末を割り当てる指定で、対話的に操作するときはセットで使います。軽量なイメージにはbashが入っていないことがあり、その場合はshを指定します。

よくある間違い:
コンテナが起動直後に終了してしまう場合、docker psには表示されません。
docker ps -aで状態(Exited)と終了コードを確認し、docker logs コンテナ名で終了直前のエラーを調べましょう。

Dockerfileでイメージを作る

自分のアプリケーションを入れたイメージは、Dockerfileという設計図から作成します。ベースになるイメージを指定し、ファイルのコピーやパッケージのインストールといった手順を、上から順に書いていきます。

Dockerfile
FROM nginx:1.27
COPY index.html /usr/share/nginx/html/index.html
EXPOSE 80
$ docker build -t myweb:1.0 .       # カレントディレクトリのDockerfileからイメージを作成
$ docker run -d --name myweb -p 8081:80 myweb:1.0
命令役割
FROMベースにするイメージを指定する
RUNイメージの作成時にコマンドを実行する(パッケージのインストールなど)
COPYホストのファイルを、イメージの中へコピーする
WORKDIR以降の命令を実行する作業ディレクトリを指定する
ENV環境変数を設定する
EXPOSEコンテナが待ち受けるポートを、情報として記載する
CMDコンテナの起動時に実行するコマンドを指定する

RUNは「イメージを作るとき」、CMDは「コンテナを起動するとき」に実行される、という違いは混同しやすいポイントです。

データを残す:ボリュームとバインドマウント

コンテナ内に書き込んだデータは、コンテナを削除すると一緒に消えます。データベースの中身やアップロードされたファイルのように、残しておきたいデータは、コンテナの外に保存する必要があります。方法は主に2つです。

$ docker volume create dbdata
$ docker run -d --name db -v dbdata:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=example mysql:8.4
# ↑ ボリューム:Dockerが管理する領域に保存する

$ docker run -d --name web -v /home/user/site:/usr/share/nginx/html:ro nginx
# ↑ バインドマウント:ホストのディレクトリを、そのままコンテナに見せる(:ro は読み取り専用)

ボリュームは、Dockerが保存場所を管理してくれるため、データベースなどの永続データに向いています。バインドマウントは、ホスト上のファイルを直接編集しながら動作を確かめたい、開発時の用途でよく使われます。

注意:
バインドマウントでは、ホストとコンテナでファイルの所有者(UID)が一致せず、Permission deniedになることがあります。
ls -lnで数値のUIDを確認し、コンテナ内の実行ユーザーと合っているかを調べましょう。

Docker Composeで複数コンテナをまとめて管理する

Webサーバーとデータベースのように、複数のコンテナを組み合わせて使う場面では、Docker Composeが便利です。構成をcompose.yamlというファイルに書いておけば、1つのコマンドでまとめて起動・停止できます。

compose.yaml
services:
  web:
    image: nginx:1.27
    ports:
      - "8080:80"
  db:
    image: mysql:8.4
    environment:
      MYSQL_ROOT_PASSWORD: example
    volumes:
      - dbdata:/var/lib/mysql
volumes:
  dbdata:
$ docker compose up -d       # まとめて起動
$ docker compose ps          # 状態を確認
$ docker compose logs -f web # 特定のサービスのログを見る
$ docker compose down        # まとめて停止・削除

長いdocker runのオプションを毎回入力する必要がなくなり、構成をファイルとして残せるため、手順の共有や再現がしやすくなります。古い資料ではdocker-compose(ハイフンあり)と書かれていることがありますが、現在はdocker compose(スペース区切り)が標準です。

Linuxの知識が活きる場面

Dockerのトラブル対応では、Linuxの基本的な調査手順がそのまま役に立ちます。

  • プロセスの確認:
    コンテナ内のプロセスは、ホストのps auxやtopにも表示されます。
    負荷の高いプロセスが、どのコンテナのものかを突き止める手がかりになります。
  • ポートの確認:
    ss -tlnpで、ホストのどのポートが待ち受けているかを確認できます。
    ポートの競合を調べるときに使います。
  • ディスクの確認:
    イメージやログは/var/lib/docker以下に溜まります。
    df -hで逼迫に気付いたら、docker system dfで内訳を確認します。
  • サービスの確認:
    Docker自体はsystemdのサービスとして動いています。
    systemctl status dockerやjournalctl -u dockerで、デーモン側の状態を調べられます。

コンテナは仕組みが見えにくく感じられますが、土台はLinuxのプロセスとファイルシステムです。基礎を固めておくほど、原因の切り分けが速くなります。

Dockerでよくあるエラーと対処

エラーメッセージ考えられる原因確認・対処
permission denied while trying to connect to the Docker daemon socket実行ユーザーに、Dockerを操作する権限がないsudoを付けるか、ユーザーをdockerグループへ追加して、ログインし直します。
Cannot connect to the Docker daemonDockerのデーモンが起動していないsystemctl status dockerで状態を確認し、sudo systemctl start dockerで起動します。
port is already allocatedホスト側のポートを、別のコンテナやプロセスが使用中docker psとss -tlnpで使用元を調べ、ポート番号を変えるか、使用中のものを停止します。
The container name "/web" is already in use同じ名前のコンテナが、停止状態で残っているdocker ps -aで確認し、不要ならdocker rm webで削除します。
no space left on deviceイメージや停止中のコンテナ、ログでディスクが埋まっているdocker system dfで内訳を確認し、不要なものをdocker system pruneで整理します。
pull access denied / manifest unknownイメージ名やタグの誤り、または認証が必要名前とタグの綴りを確認します。非公開のイメージはdocker loginが必要です。

不要になったコンテナとイメージを片付ける

Dockerを使い続けていると、停止したコンテナや使わなくなったイメージが少しずつ溜まり、ディスクを圧迫します。定期的に状況を確認して、整理しておきましょう。

$ docker system df               # イメージ・コンテナ・ボリュームの使用量を確認
$ docker container prune         # 停止中のコンテナをまとめて削除
$ docker image prune             # タグのない不要なイメージを削除
$ docker system prune            # 停止中のコンテナ・未使用のネットワーク・不要なイメージをまとめて削除
注意:
docker system pruneに--volumesを付けると、使われていないボリュームも削除されます。
データベースのデータなど、必要なボリュームが含まれていないかを、実行前にdocker volume lsで確認しましょう。

学習の進め方

Dockerは、実際にコンテナを起動して、止めて、中を調べる、という操作を繰り返すことで身につきます。当サイトの練習用ターミナルはDockerのコマンドには対応していないため、手元のPCやクラウド上のLinux環境にDockerをインストールして試してみましょう。

あわせて、土台になるLinuxの操作に不安がある場合は、プロセス管理・ログの確認・権限の考え方を先に固めておくと、コンテナの挙動が理解しやすくなります。仮想化とコンテナの位置づけは中級の「仮想化環境のゲストとしてのLinux」でも扱っています。

Dockerに関するよくある質問

Dockerと仮想マシンは何が違いますか?

仮想マシンはハードウェアを仮想化し、その上でゲストOSを丸ごと動かします。コンテナはホストのLinuxカーネルを共有し、プロセスを隔離して動かす方式です。そのためコンテナは起動が速く、使うメモリやディスクも少なく済む傾向があります。

コンテナを停止すると、中のデータは消えますか?

docker stopで停止しただけでは消えません。docker rmでコンテナを削除すると、コンテナ内に書き込んだデータは失われます。残したいデータは、ボリュームやバインドマウントでコンテナの外に保存します。

docker runとdocker startの違いは?

docker runはイメージから新しいコンテナを作成して起動します。docker startは、すでに作成済みで停止しているコンテナを再び起動します。runを繰り返すと、そのたびに新しいコンテナが増える点に注意が必要です。

sudoなしでdockerコマンドを使えますか?

ユーザーをdockerグループに追加すると使えるようになります。ただし、このグループのユーザーは実質的にroot相当の操作ができるため、追加する相手は慎重に選ぶ必要があります。

DockerとPodmanの違いは?

PodmanはRHEL系で標準的に使われるコンテナ管理ツールで、常駐するデーモンを必要としない点が特徴です。基本的なコマンドはdockerとほぼ同じ書き方で使えるため、ここで覚えた内容の多くはPodmanでも活かせます。

Linuxの知識がなくてもDockerは使えますか?

コマンドを実行するだけなら可能ですが、トラブルが起きたときの調査では、プロセス・ログ・権限・ネットワークといったLinuxの知識が必要になります。先に基本操作に慣れておくと、理解がスムーズです。

この記事を書いた人:
こすけ(コマンド学習道場 運営者)。
AWSの運用保守に携わるエンジニアで、保有資格はCCNA・AWS-SAA・LPIC-3(305)。
詳しくは運営者情報をご覧ください。
関連するページ:
プロセスの調べ方はpsコマンドの使い方、ログの確認は「Linuxのログを確認する方法」、サービスの管理はsystemctlコマンドの使い方、クラウド上での運用はAWS運用実践編もあわせてご覧ください。

この章の内容を練習できる課題

読んだ内容は、実際に打ってみると定着します。次の課題は、ブラウザの練習用ターミナルで、この章のコマンドを使って進めるものです。リンクを開くと、すぐに始まります。

ほかの課題は、練習問題の一覧から選べます。

確認クイズ

Q1. コンテナと仮想マシンの違いとして、正しいものはどれですか?

解説:
コンテナは、ホストのカーネルを共有し、名前空間とcgroupでプロセスを隔離します。
OSを丸ごと起動する仮想マシンに比べて、起動が速く、消費するリソースも少ない傾向があります。

Q2. docker run -d -p 8080:80 nginxの-p 8080:80は、何を意味しますか?

解説:
-pはホスト側:コンテナ側の順に書きます。
この例では、ホストの8080番ポートへの通信が、コンテナの80番ポートへ届きます。

Q3. コンテナが起動直後に終了してしまい、docker psに表示されません。最初に確認するコマンドとして適切なものはどれですか?

解説:
docker psに表示されるのは、起動中のコンテナだけです。
-aを付けると、終了したコンテナの状態と終了コードも表示されます。
原因は、docker logs コンテナ名で確認します。

Q4. コンテナを削除しても、データベースのデータを残したい場合に使う仕組みはどれですか?

解説:
コンテナ内に書き込んだデータは、コンテナを削除すると一緒に消えます。
残したいデータは、ボリュームやバインドマウントを使って、コンテナの外に保存します。