Подключиться
Yandex Container Registry

Политика автоматического удаления Docker-образов

Статья создана
,
улучшена

Политика удаления Docker-образов позволяет задать правила, в соответствии с которыми Docker-образы будут удаляться автоматически.

Важно

Задать политику удаления можно только для репозитория. Политика применяется к Docker-образам, имена которых в точности совпадают с именем репозитория. Совпадение по префиксу не поддерживается. Нельзя задать политику для группы репозиториев, реестра, каталога или облака.

Статусы политики удаления

Примечание

Политика по умолчанию создается в статусе DISABLED. Как активировать политику, читайте в разделе Изменить статус политики удаления.

Политика удаления может находится в следующих статусах:

  • ACTIVE — политика активна и регулярно удаляет Docker-образы по установленным правилам.
  • DISABLED — политика выключена и не удаляет Docker-образы в репозитории. Политики в этом статусе можно использовать для подготовки и тестирования правил.

У репозитория может быть только одна активная политика и несколько выключенных. Активную политику можно выключить в любой момент.

Для активных и выключенных политик можно делать тестовые запуски (dry-run), чтобы проверить, какие Docker-образы будут удалены в соответствии с правилами.

Правила политики удаления

Для удаления Docker-образы сначала фильтруются по тегам, а затем проверяются на соответствие условиям.

Важно

Необходимо указать хотя бы один фильтр по тегу и задать хотя бы одно условие удаления.

Чтобы сконфигурировать политику удаления, задайте следующие параметры:

  1. Фильтрация Docker-образа по тегам:

    • tag_regexp — тег для указания фильтра в виде регулярного выражения.

      Примеры использования tag_regexp:

      • .* — все образы с тегами.
      • prefix.* — образы с тегами, которые начинаются на prefix.

    • untagged — тег для применения правила к Docker-образам без тегов.

  2. Условия для удаления Docker-образов:

    • expire_period — период времени, который должен пройти с момента создания Docker-образа, чтобы он подходил для автоматического удаления. Период должен быть кратен 24 часам.
    • retained_top — количество Docker-образов (подпадающих под заданный фильтр по тегам), которое необходимо оставить, даже если expire_period уже истек.

Разрешение конфликтов правил

  • Если Docker-образ, отфильтрованный по тегу, подпадает только под одно правило для удаления, он удаляется в соответствии с настройками этого правила.
  • Если Docker-образ, отфильтрованный по тегу, подпадает под несколько конфликтующих правил, он будет удален, только если этого требуют все правила. Если есть хотя бы одно правило, по которому Docker-образ не должен быть удален, — он останется.
В этой статье: