Команда docker rmi

Справочник команд Docker

docker rmiКоманда используется для удаления одного или нескольких образов 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

Удалить образ с тегом latest с именем ubuntu.

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

docker rmi ubuntu:latest nginx:latest

Удалить образы с тегом latest для ubuntu и nginx.

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

docker rmi ubuntu:latest ubuntu:18.04

Удалить теги latest и 18.04 образа ubuntu.

Удалить образ вместе со всеми его тегами

docker rmi -a ubuntu

Удалить все образы в репозитории ubuntu.

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

docker rmi -f ubuntu:latest

Принудительно удалить образ с тегом latest из ubuntu, даже если он используется.

Удалить висячие образы

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

Удалить образ:

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

Другие расширения