Docker rmi コマンド
docker rmiこのコマンドは、1つ以上のDockerイメージを削除するために使用します。
docker rmiこのコマンドは、ローカルに保存されたイメージの管理に非常に役立ち、不要になったイメージをクリーンアップしてストレージ領域を解放するのに役立ちます。
構文
docker rmi [OPTIONS] IMAGE [IMAGE...]
パラメータの説明:
IMAGE: 削除するイメージの名前またはID。イメージ名、イメージID、イメージダイジェストのいずれかを指定できます。OPTIONS: コマンドの動作を制御するためのオプションパラメータです。
一般的なオプション:
-a,--all-tags: リポジトリ名を指定すると、そのリポジトリ内のすべてのイメージを削除します。-f,--force: イメージがコンテナで使用されている場合でも、イメージを強制的に削除します。--help: ヘルプ情報を表示して終了します。--no-prune: タグのない親イメージを削除しません。-q,--quiet: クワイエットモード。削除するイメージの詳細情報を表示しません。
単一のイメージを削除する
docker rmi ubuntu:latest
ubuntu の latest タグが付いたイメージを削除します。
複数のイメージを削除する
docker rmi ubuntu:latest nginx:latest
ubuntu と nginx の latest タグが付いたイメージを削除します。
イメージの複数のタグを削除する
docker rmi ubuntu:latest ubuntu:18.04
ubuntu イメージの latest タグと 18.04 タグを削除します。
すべてのタグのイメージを削除する
docker rmi -a ubuntu
ubuntu リポジトリ内のすべてのイメージを削除します。
イメージを強制削除する
docker rmi -f ubuntu:latest
使用中であっても、ubuntu の latest タグが付いたイメージを強制的に削除します。
ダングリングイメージを削除する
docker rmi -d
タグのないすべてのダングリングイメージを削除します。
クワイエットモードですべてのイメージを削除する
docker rmi -q $(docker images -q)
クワイエットモードを使用してすべてのイメージを削除し、削除するイメージの情報を表示しません。
指定したリポジトリのすべてのイメージを削除する
docker rmi -a myrepo
myrepo リポジトリ内のすべてのイメージを削除します。
イメージを削除し、その子イメージを保持する
docker rmi --no-prune ubuntu:latest
ubuntu:latest イメージを削除しますが、その子イメージは保持します。
実例
既存のイメージを確認する:
docker images
出力:
REPOSITORY TAG IMAGE ID CREATED SIZE my_image latest d1e1b5a3a8a9 3 days ago 128MB my_image1 latest c3a4f5a3a8b8 4 days ago 256MB my_image2 latest a9e1d3a7c9b9 5 days ago 512MB
1つのイメージを削除する:
docker rmi my_image
出力:
Untagged: my_image:latest Deleted: sha256:d1e1b5a3a8a9...
複数のイメージを削除する:
docker rmi my_image1 my_image2
出力:
Untagged: my_image1:latest Deleted: sha256:c3a4f5a3a8b8... Untagged: my_image2:latest Deleted: sha256:a9e1d3a7c9b9...
よく使うシナリオ
- 不要なイメージのクリーンアップ: 不要になったイメージを削除して、ストレージ領域を解放します。
- イメージ管理: ローカルイメージライブラリを管理・保守し、必要なイメージだけを保持するようにします。
- 強制削除: イメージがコンテナで使用されているときに強制的に削除します(注意して使用してください)。
注意事項
- イメージの強制削除(
-fオプションを使用)の場合、そのイメージに依存するコンテナが実行できなくなる可能性があるため、注意して使用してください。 - デフォルトでは、
docker rmi未使用の親イメージが削除されます。希望しない場合は、--no-pruneオプションを使用できます。
docker rmiこのコマンドはDockerイメージ管理において非常に重要なツールです。このコマンドを使用すると、ユーザーは不要になったイメージを削除し、ストレージ領域を解放して、ローカルイメージライブラリを整理整頓された状態に保つことができます。適切なオプションを使用することで、イメージの削除プロセスを柔軟に管理できます。
その他の拡張
Docker コマンド大全