docker rmi

目次

説明

1つまたは複数の イメージ(image) を 削除(remove) します。

使い方

$ docker rmi [OPTIONS] IMAGE [IMAGE...]

補足説明

ホスト・ノード上の1つまたは複数のイメージを 削除(remove) （かつ、 タグ削除(un-tag) ）します。イメージに複数のタグがある場合は、このコマンドのパラメータとしてタグを使うと、そのタグのみ削除します。タグが1つのイメージに対してしかない場合は、イメージとタグの両方を削除します。

これは、レジストリからはイメージを削除しません。また、 -f オプションを使わない限り、実行中のコンテナからイメージを削除できません。ホスト上にある全てのイメージを表示するには、 docker image ls コマンドを使います。

コマンドの使用例は、以下の 使用例のセクション をご覧ください。

オプション

名前, 省略形	デフォルト	説明
--force , -f		イメージの強制削除
--no-prune		タグの付いていない親イメージを削除しない

使用例

ショート ID かロング ID、タグ、digest を使ってイメージを削除できます。イメージがタグによって参照されている場合、イメージを削除する前にそれらの削除が必要です。Digest の参照値はイメージのタグを削除する時、自動的に削除されます。

$ 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
Untagged: test1:latest
$ docker rmi test2
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
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

取得したイメージがタグ付けされていなくても、digest を確認できます。

$ docker images --digests
REPOSITORY                     TAG       DIGEST                                                                    IMAGE ID        CREATED         SIZE
localhost:5000/test/busybox    <none>    sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf   4986bf8c1536    9 weeks ago     2.43 MB

digest を使ってイメージを削除するには、次のようにします。

$ docker rmi localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
Untagged: localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
Deleted: 4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125
Deleted: ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2
Deleted: df7546f9f060a2268024c8a230d8639878585defcc1bc6f79d2728a13957871b

親コマンド

コマンド	説明
docker	Docker CLI の基本コマンド

参考

docker rmi

https://docs.docker.com/engine/reference/commandline/rmi/