第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 daemon | Dockerのデーモンが起動していない | 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の知識が必要になります。先に基本操作に慣れておくと、理解がスムーズです。
プロセスの調べ方はpsコマンドの使い方、ログの確認は「Linuxのログを確認する方法」、サービスの管理はsystemctlコマンドの使い方、クラウド上での運用はAWS運用実践編もあわせてご覧ください。
この章の内容を練習できる課題
読んだ内容は、実際に打ってみると定着します。次の課題は、ブラウザの練習用ターミナルで、この章のコマンドを使って進めるものです。リンクを開くと、すぐに始まります。
- はじめてのコンテナを動かす(コンテナ(LPIC-3))
- コンテナの停止・再開・削除(コンテナ(LPIC-3))
- コンテナの中に入って調べる(コンテナ(LPIC-3))
- 起動直後に止まるコンテナの原因を調べる(コンテナ(LPIC-3))
- docker グループで、sudo なしで操作できるようにする(コンテナ(LPIC-3))
ほかの課題は、練習問題の一覧から選べます。