Docker コンテナのライフサイクル入門：作成、起動、停止、削除

コンテナは作成から削除まで、いくつかの状態を経ます。これらの状態を理解すると、コンテナが「少し動いただけですぐ止まる」ことがある理由、停止したコンテナが名前を使い続ける理由、docker stop が 10 秒待つことがある理由がわかります。

コンテナの状態

Exited の後ろの括弧内の数字はメインプロセスの終了コードです。0 は正常終了を表します。詳しくは後述します。

コンテナが停止するタイミング

コンテナのライフサイクル ＝ メインプロセス（PID 1）のライフサイクルです。 メインプロセスが終了すると、コンテナも停止します。

よくある疑問について説明します。

$ docker run ubuntu:26.04

$ docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

$ docker ps -a
CONTAINER ID   IMAGE          COMMAND       CREATED                  STATUS                              PORTS     NAMES
66e6f85c66e0   ubuntu:26.04   "/bin/bash"   Less than a second ago   Exited (0) Less than a second ago             dreamy_solomon

docker run ubuntu:26.04 は何も出力せずに終了し、docker ps にも表示されません。docker ps -a を使うと、メインプロセスが /bin/bash であることを確認できます。しかし -it を付けていないため、bash は読み取る入力がなく、起動直後に終了します。そのため、コンテナも停止します（Exited (0)）。

-it を付けて対話型ターミナルを割り当てると、bash は入力を待ち続けます。

docker run -it ubuntu:26.04

nginx や PostgreSQL などのサービスのイメージでは、メインプロセスがフォアグラウンドで実行され続けるため、コンテナも動作し続けます。

作成と起動

docker run は実際には docker create（作成）と docker start（起動）を組み合わせたものです。それぞれを別々に実行することもできます。

$ docker create --name web nginx:1.30
ad99713ea5acddf70d854365e882fd0a3b6d4508d50da25993b94c9878f1c3bc

$ docker ps -a --filter name=web
CONTAINER ID   IMAGE        COMMAND                  CREATED                  STATUS    PORTS     NAMES
ad99713ea5ac   nginx:1.30   "/docker-entrypoint.…"   Less than a second ago   Created             web

$ docker start web
web

$ docker ps --filter name=web
CONTAINER ID   IMAGE        COMMAND                  CREATED                  STATUS                  PORTS     NAMES
ad99713ea5ac   nginx:1.30   "/docker-entrypoint.…"   Less than a second ago   Up Less than a second   80/tcp    web

作成後の状態は Created、起動後は Up です。--filter name=web は、名前に web を含むコンテナだけを表示します。

名前は重複できません

docker run を実行するたびに、新しいコンテナが作成されます。コンテナ名がすでに使われている場合、そのコンテナが停止中でもエラーになります。

$ docker run -d --name web nginx:1.30
docker: Error response from daemon: Conflict. The container name "/web" is already in use by container "ad99713ea5acddf70d854365e882fd0a3b6d4508d50da25993b94c9878f1c3bc". You have to remove (or rename) that container to be able to reuse that name.

Run 'docker run --help' for more information

以前のコンテナをもう一度起動するには、docker start web を使います。新しい設定で作り直すには、先に docker rm -f web を実行してから docker run を実行します。

停止：stop と kill の違い

stop を使うと、データベースがデータをディスクに書き戻したり、Web サーバーが処理中のリクエストを完了したりする時間をプログラムに与えられます。通常は stop を使い、プログラムが応答しなくなった場合にだけ kill を使います。

$ docker start web
web

$ docker kill web
web

$ docker ps -a --filter name=web
CONTAINER ID   IMAGE        COMMAND                  CREATED          STATUS                                PORTS     NAMES
ad99713ea5ac   nginx:1.30   "/docker-entrypoint.…"   14 seconds ago   Exited (137) Less than a second ago             web

kill されたコンテナの終了コードは 137 です（128 + 9。9 は SIGKILL の番号です）。

なぜ docker stop はときどき 10 秒待つのですか？

以下で、3 つのコンテナの停止にかかる時間を実際に比較します。

$ time docker stop web
web
real	0m 0.10s
user	0m 0.01s
sys	0m 0.00s

$ docker run -d --name slow alpine:3.23 sh -c "sleep 300"
Unable to find image 'alpine:3.23' locally
3.23: Pulling from library/alpine
d0c1d894c237: Pull complete
Digest: sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0
Status: Downloaded newer image for alpine:3.23
170d08a64bb8ec1519d183f8c20508d669358eea4d5a978fa4f4675ffcec41ab

$ time docker stop slow
slow
real	0m 10.17s
user	0m 0.00s
sys	0m 0.01s

$ docker run -d --name slow2 --init alpine:3.23 sh -c "sleep 300"
d1854be4790b5fc9375004e05708d27a27d56c2c540a8159424351985db20ef9

$ time docker stop slow2
slow2
real	0m 0.13s
user	0m 0.00s
sys	0m 0.01s

Linux には PID 1 に関する特別なルールがあります。PID 1 が SIGTERM を自分で処理しない場合、このシグナルは無視されます。そのため、自作イメージで docker stop のたびに 10 秒待たされる場合、通常はメインプロセスが PID 1 として実行されており、プログラム内で SIGTERM を処理していません。たとえば、node server.js をメインプロセスとして直接実行する Node.js プログラムでも、実測では同じく 10 秒待つ必要があります。Dockerfile 命令リファレンスの実際の比較を参照してください。解決するには、プログラム内で SIGTERM を処理するか、--init を追加します。

終了コード

$ docker run --name exit3 alpine:3.23 sh -c "exit 3"

$ docker ps -a --filter name=exit3
CONTAINER ID   IMAGE         COMMAND            CREATED        STATUS                              PORTS     NAMES
84996cca5ec5   alpine:3.23   "sh -c 'exit 3'"   1 second ago   Exited (3) Less than a second ago             exit3

$ docker inspect --format '{{.State.ExitCode}}' exit3
3

メインプロセスが終了したときのコードが、Exited (...) に表示されます。よくあるコードは次のとおりです。

一時停止と再開

$ docker start web
web

$ docker pause web
web

$ docker ps --filter name=web
CONTAINER ID   IMAGE        COMMAND                  CREATED          STATUS                           PORTS     NAMES
ad99713ea5ac   nginx:1.30   "/docker-entrypoint.…"   15 seconds ago   Up Less than a second (Paused)   80/tcp    web

$ docker unpause web
web

pause はコンテナ内のすべてのプロセスを凍結します（終了はしません）。状態には (Paused) と表示されます。使う機会はあまりありませんが、メモリ内の状態を保ったまま、一時的に CPU を解放したい場合に適しています。

コンテナを削除する

$ docker rm web
Error response from daemon: cannot remove container "web": container is running: stop the container before removing or force remove

$ docker rm -f web
web

実行中のコンテナはそのまま削除できません。先に stop するか、-f で強制削除してください（kill の後に rm するのと同じです）。

停止済みのコンテナをまとめて削除する

しばらく練習すると、docker ps -a に停止済みのコンテナがたくさんたまります。

$ docker ps -a
CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS                        PORTS     NAMES
75ee00dc4081   nginx:1.30     "/docker-entrypoint.…"   1 second ago     Up Less than a second         80/tcp    web
5dfb843c0b40   alpine:3.23    "sh -c 'echo startin…"   26 seconds ago   Exited (1) 24 seconds ago               flaky
84996cca5ec5   alpine:3.23    "sh -c 'exit 3'"         27 seconds ago   Exited (3) 26 seconds ago               exit3
d1854be4790b   alpine:3.23    "sh -c 'sleep 300'"      29 seconds ago   Exited (143) 28 seconds ago             slow2
170d08a64bb8   alpine:3.23    "sh -c 'sleep 300'"      39 seconds ago   Exited (137) 29 seconds ago             slow
66e6f85c66e0   ubuntu:26.04   "/bin/bash"              43 seconds ago   Exited (0) 42 seconds ago               dreamy_solomon

$ docker container prune -f
Deleted Containers:
5dfb843c0b400146827fe138890ee4d62a24104cad5531aff4100fc471b0727f
84996cca5ec5bfe7ca51c6365b60ef89e49055cf06a3f0dd3a49f9e50e08d6f4
d1854be4790b5fc9375004e05708d27a27d56c2c540a8159424351985db20ef9
170d08a64bb8ec1519d183f8c20508d669358eea4d5a978fa4f4675ffcec41ab
66e6f85c66e0f2b586c5919a900a0e16d6f0fc49535d35fa7d30f77747f1ce0e

Total reclaimed space: 24.58kB

container prune は停止済みのコンテナだけを削除するため、実行中の web には影響しません。また、上の終了コードと見比べてください。slow は強制終了されたため 137、--init を追加した slow2 は SIGTERM を正常に受け取ったため 143 です。

使い捨てのコンテナを終了後に自動削除するには、実行時に --rm を追加します。

docker run --rm alpine:3.23 echo "使い終わったら破棄"

再起動ポリシー：--restart

サーバーの再起動時やプログラムのクラッシュ時に、コンテナを自動的に再起動するかどうかを --restart で設定します。

on-failure の動作を確認する

次のコンテナは起動するたびに starting と出力してからコード 1 で終了し、繰り返しクラッシュするプログラムを再現します。

$ docker run -d --name flaky --restart on-failure:3 alpine:3.23 sh -c "echo starting; exit 1"
5dfb843c0b400146827fe138890ee4d62a24104cad5531aff4100fc471b0727f

$ docker ps -a --filter name=flaky
CONTAINER ID   IMAGE         COMMAND                  CREATED          STATUS                      PORTS     NAMES
5dfb843c0b40   alpine:3.23   "sh -c 'echo startin…"   25 seconds ago   Exited (1) 23 seconds ago             flaky

$ docker inspect --format '{{.RestartCount}} {{.State.Status}} {{.State.ExitCode}}' flaky
3 exited 1

$ docker logs flaky
starting
starting
starting
starting

ログには starting が 4 回あります。最初の起動に加えて 3 回再起動したためです（RestartCount は 3）。上限に達すると Exited (1) の状態で停止します。Docker は再起動のたびに待ち時間を徐々に長くし、ホストが頻繁な再起動でダウンしないようにします。

実行中のコンテナの再起動ポリシーを変更する

長期間稼働するサービスには、通常 unless-stopped をおすすめします。すでに実行中のコンテナも変更できます。

$ docker run -d --name web --restart unless-stopped nginx:1.30
75ee00dc4081f4c2849562fbd89edfdd9386839a161ea9d66956eaa41257d4cf

$ docker inspect --format '{{.HostConfig.RestartPolicy.Name}}' web
unless-stopped

$ docker update --restart always web
web

$ docker inspect --format '{{.HostConfig.RestartPolicy.Name}}' web
always

Linux でコンテナを起動時に自動起動するには、Docker 自体も起動時に自動起動する必要があります。sudo systemctl enable docker を実行してください。Docker Desktop では、設定で「Start Docker Desktop when you sign in」を有効にします。

コマンド一覧

次のセクションでは、docker run のよく使うオプションを詳しくまとめます。

まとめ

• コンテナの状態：created、running、paused、exited、restarting。
• メインプロセスが終了するとコンテナも停止します。docker stop はまず SIGTERM を送信し、10 秒後に SIGKILL を送信します。
• メインプロセスが PID 1 で SIGTERM を処理しない場合、stop は10秒間待機します。--init で解決できます。
• 長期間稼働するサービスには --restart unless-stopped を指定します。

練習問題

練習 1：docker run -d --name t1 alpine:3.23 sh -c "exit 3" でコンテナを起動すると、状態と終了コードはどうなりますか？

練習 2：docker run -d --name t2 alpine:3.23 sleep 300 を起動し、time docker stop t2（先にコンテナを作り直してください）と --init を付けた場合で、停止にかかる時間を比べてください。

更新日 2026年10月14日