docker rmi

Удаляет одно или несколько образов

Использование

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

Обратитесь к разделу параметров для обзора доступных OPTIONS для этой команды.

Описание

Удаляет (и снимает теги) одно или несколько образов с хост-узла. Если образ имеет несколько тегов, использование этой команды с тегом в качестве параметра удаляет только тег. Если тег является единственным для образа, удаляются и образ, и тег.

Это не удаляет образы из реестра. Вы не можете удаляет образ работающего контейнера, если не используете параметр -f. Чтобы просмотреть все образы на хосте, используйте команду образ Docker ls.

Примеры использования этой команды см. в разделе примеров далее.

Параметры

Имя, сокращенно

По умолчанию

Описание

--force, -f

Принудительное удаление образа

--no-prune

Не удаляйте непомеченных родителей

Примеры

Вы можете удаляет образ, используя его короткий или длинный идентификатор, его тег или его дайджест. Если образ имеет один или несколько тегов, ссылающихся на него, вы должны удаляет их все, прежде чем образ будет удалено. Ссылки на дайджесты автоматически удаляются при удалении образа по тегу.

$ 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 и указываете короткий или длинный идентификатор образа, эта команда снимает теги и удаляет все образа, соответствующие указанному идентификатору.

$ 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