docker rmi
読む時間の目安: 2 分
説明
1 つまたは複数のイメージを削除します。
利用方法
$ docker rmi [オプション] IMAGE [IMAGE...]
追加説明
ホストノードから 1 つまたは複数のイメージを削除（そしてタグづけ解除）します。 イメージに複数のタグがつけられている場合、パラメーターにそのタグを指定して本コマンドを実行すればそのタグだけが削除されます。 そのタグがイメージにとって唯一のものであれば、イメージとタグがともに削除されます。
このコマンドはイメージをレジストリから削除するものではありません。
実行中コンテナーのイメージは-fオプションをつけない限りは削除することができません。
ホスト上のイメージをすべて確認するには docker image ls コマンドを使います。
本コマンドの利用例については、以下に示す 利用例の節 を参照してください。
オプション
| 名前／省略形 | デフォルト | 説明 |
--force , -f |
イメージを強制的に削除します。 | |
--no-prune |
タグづけされていない親イメージは削除しません。 |
利用例
イメージの削除には、短い ID と長い ID、タグ、あるいは ダイジェスト値を指定します。 イメージを参照するタグが存在する場合は、イメージを削除する前にそのタグを削除しておかなければなりません。 ダイジェスト値による参照は、イメージをタグによって削除した際に、自動的に削除されます。
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)
test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)
test2 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)
$ docker rmi fd484f19954f
Error: Conflict, cannot delete image fd484f19954f because it is tagged in multiple repositories, use -f to force
2013/12/11 05:47:16 Error: failed to remove one or more images
$ docker rmi test1:latest
Untagged: test1:latest
$ docker rmi test2:latest
Untagged: test2:latest
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)
$ docker rmi test:latest
Untagged: test:latest
Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
-fフラグを使い、短いイメージ ID または長いイメージ ID を指定した場合、このコマンドは指定した ID に合致するイメージのタグづけを解除した上で、イメージすべてを削除します。
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
test1 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)
test latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)
test2 latest fd484f19954f 23 seconds ago 7 B (virtual 4.964 MB)
$ docker rmi -f fd484f19954f
Untagged: test1:latest
Untagged: test:latest
Untagged: test2:latest
Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
ダイジェスト値を使ってプルを行ったイメージにはタグが関連づけられていません。
$ docker images --digests
REPOSITORY TAG DIGEST IMAGE ID CREATED SIZE
localhost:5000/test/busybox <none> sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf 4986bf8c1536 9 weeks ago 2.43 MB
ダイジェスト値を使ってイメージを削除するには、以下のようにします。
$ docker rmi localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
Untagged: localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
Deleted: 4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125
Deleted: ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2
Deleted: df7546f9f060a2268024c8a230d8639878585defcc1bc6f79d2728a13957871b
上位コマンド
| コマンド | 説明 |
|---|---|
| docker | Docker CLI の基本コマンド |