Dockerを使って開発や検証を行っていると、不要になったコンテナがどんどんたまっていきます。こうした不要なコンテナを放置していると、ディスク容量を圧迫したり、管理が煩雑になったりといった問題が発生します。
本記事では、Dockerで作成した不要なコンテナを削除するための基本的なコマンドdocker rmについて、具体的な使い方から注意点、便利なオプションまでをわかりやすく解説します。初心者の方にも安心して使えるよう、実際のコマンド例を交えながら紹介していきます。
docker rmコマンドとは？
docker rmは、Dockerで作成・停止されたコンテナを削除するためのコマンドです。
コンテナはdocker runなどで一度作成されると、停止してもその状態がホスト上に残ります。不要なコンテナを削除することで、環境を整理し、ディスク容量を確保することができます。
基本構文は以下の通りです：
docker rm [OPTIONS] CONTAINER [CONTAINER...]
ここでCONTAINERは、削除したいコンテナの名前またはIDを指定します。
基本的な使い方：停止中のコンテナを削除する
まず、停止中のコンテナのみが削除対象となることに注意が必要です。実行中のコンテナに対してdocker rmを実行すると、エラーになります。
例：コンテナ名を指定して削除
docker rm my_container
コンテナIDを指定することも可能です：
docker rm 1a2b3c4d5e6f
複数のコンテナを一括で削除することもできます：
docker rm container1 container2 container3
実行中のコンテナを強制削除する
実行中のコンテナを削除したい場合は、-fオプションを使って強制削除が可能です。ただし、強制削除は注意が必要です。実行中のプロセスが途中で停止し、データが失われる可能性があります。
docker rm -f running_container
このコマンドは、対象のコンテナを停止してから削除します。
すべての停止中コンテナをまとめて削除する
多くのコンテナを削除したいときに便利なのが、docker ps -aとawkを組み合わせる方法です。
ただし、もっと簡単な方法として、docker container pruneを使うのもおすすめです。
例1：docker ps -a と awk を使った削除
docker rm $(docker ps -a -q)
このコマンドは、停止中を含むすべてのコンテナIDを取得し、一括で削除します。
例2：docker container prune を使った削除
docker container prune
こちらは停止中のコンテナのみを削除します。実行前に確認メッセージが表示されるので、安全に使えます。
docker rmとdocker rmiの違い
docker rmはコンテナを削除するコマンドですが、docker rmiはイメージ（image）を削除するコマンドです。似ているようで対象が異なりますので、使い分けが重要です。
| コマンド | 対象 | 説明 |
|---|---|---|
docker rm | コンテナ | 作成・停止されたコンテナを削除 |
docker rmi | イメージ | コンテナ作成に使われた元のイメージを削除 |
イメージを削除する際は、該当のイメージを使用中のコンテナが存在しないことが条件です。
よくあるエラーと対処法
エラー1：「Conflict: You cannot remove a running container」
実行中のコンテナに対してdocker rmを使おうとすると出るエラーです。対処方法は以下の通りです：
docker rm -f コンテナ名またはID
または、事前に停止してから削除するのが安全です。
docker stop コンテナ名
docker rm コンテナ名
エラー2：「No such container」
指定したコンテナ名やIDが存在しない場合に出るエラーです。コンテナ一覧を確認してから再度実行しましょう：
docker ps -a
削除前に確認しておくべきこと
コンテナ削除は、基本的に取り消しができません。重要なデータがコンテナに保存されている場合は、ボリュームを利用してデータを外部に保存するよう設計しましょう。
また、イメージやボリュームの削除を一緒に行いたい場合は、docker system pruneを使うこともできます（※注意：すべての未使用データが削除されるので慎重に）。
まとめ：docker rmで環境をクリーンに保とう
Dockerの運用を効率的に行うためには、定期的なコンテナの整理が欠かせません。docker rmコマンドを使って、不要なコンテナを安全に削除することで、作業環境を常にクリーンに保つことができます。
以下が今回のポイントです：
docker rmは停止中のコンテナを削除するための基本コマンド。- 実行中のコンテナは
-fオプションで強制削除可能。 - 複数削除や一括削除には
docker ps -a -qとの組み合わせが便利。 docker rmとdocker rmiは対象が異なる。- 削除前にはデータのバックアップやボリュームの設計を忘れずに。
Docker操作に慣れてくると、こうした削除コマンドを組み合わせてシェルスクリプト化することもできます。ぜひ日々の運用に取り入れてみてください。