Docker rmi コマンド

 Docker 命令大全Docker コマンド大全


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 命令大全Docker コマンド大全

その他の拡張