Сценарии использования

В данном разделе описаны стандартные действия пользователя при работе в Docker registry.

Управление репозиториями

Основные сведения о репозиториях приведены в разделе Базовые концепции. Репозитории отображаются в виде карточек на странице репозиториев. Карточки содержат всю необходимую для пользователя информацию: дата создания /изменения репозитория, описание репозитория, теги и др.

Пользователи могут выполнять следующие действия:

  • Задавать описания для репозиториев.

  • Удалять репозитории из реестра.

  • Добавлять репозитории в избранное.

Задание описания для репозитория

Чтобы задать описание:

  1. Кликните по карточке репозитория.

  2. Перейдите на вкладку Общая информация.

  3. Задайте описание и нажмите Сохранить. Описание появится на карточке репозитория.

Удаление репозитория

Для удаления репозитория:

  1. Нажмите кнопку Кнопка с тремя вертикальными точками на карточке репозитория.

  2. В открывшемся меню нажмите кнопку Удалить.

Или отметьте необходимый объект / объекты чекбоксами и нажмите на иконку Корзина в строке поиска.

Добавление репозитория в избранное

Для добавления репозитория в избранное нажмите Кнопка Избранное. Выбранный объект будет отображаться первым на странице репозиториев.

Управление образами

Пользователи могут загружать локальные Docker-образы в реестр (push), а также скачивать необходимые Docker-образы из реестра на локальную машину (pull).

Загрузка Docker-образа в реестр

Для загрузки образа в реестр выполните следующие действия:

  1. Нажмите на кнопку Push-команда.

  2. В диалоге push command приведены команды для присваивания образу тега и загрузки его в реестр.

    docker tag SOURCE_IMAGE[:TAG] REGISTRY_HOST/TARGET_REGISTRY/REPOSITORY[:TAG]
    # SOURCE_IMAGE --- имя локального образа на компьютере пользователя
    # TAG --- тег этого локального образа
    # REGISTRY_HOST/TARGET_REGISTRY/ --- хост и реестр пользователя, куда загружается образ
    # REPOSITORY --- репозиторий, в который загружается образ
    # TAG --- тег для образа в реестре
    
    docker push REGISTRY_HOST/TARGET_REGISTRY/REPOSITORY[:TAG]
    
  3. Загрузите необходимый образ в реестр, выполнив указанные команды из консоли. В результате будет создан репозиторий с указанным именем, в котором появится артефакт — образ контейнера с указанным тегом. Или артефакт будет загружен в существующий репозиторий с указанным именем.

Просмотр Docker-образа в реестре

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

К карточке образа можно добавить описание.

Для добавления описания:

  1. Зайдите в карточку образа.

  2. Выберите вкладку Описание, добавьте его и сохраните.

К загруженному образу можно добавить тег.

Для добавления тега:

  1. Зайдите в карточку образа.

  2. Выберите требуемый артефакт.

  3. Нажмите Добавить тег.

  4. Введите название тега и нажмите Добавить.

Скачивание Docker-образа из реестра

Для скачивания Docker-образа из реестра на локальную машину:

  1. Выберите необходимый Docker-образ.

  2. Скачайте образ из реестра, выполнив соответствующую команду из консоли:

  • Используя тег:

    docker pull REGISTRY_HOST/TARGET_REGISTRY/REPOSITORY[:TAG]
    # REGISTRY_HOST/TARGET_REGISTRY/ -- хост и реестр пользователя, откуда скачивается образ
    # REPOSITORY -- репозиторий, откуда скачивается образ
    # TAG -- тег Docker-образа
    
  • Используя хеш:

    docker pull REGISTRY_HOST/TARGET_REGISTRY/REPOSITORY@sha256:HASH_SUM
    

Удаление Docker-образа из реестра

Чтобы удалить Docker-образ:

  1. Перейдите в репозиторий, из которого нужно удалить образ, кликнув по карточке репозитория.

  2. В репозитории нажмите значок Кнопка с тремя вертикальными точками в строке Docker-образа, который необходимо удалить.

  3. В открывшемся меню нажмите кнопку Удалить.

Для удаления нескольких версий Docker-образов, отметьте необходимые объекты чекбоксами и нажмите на иконку Корзина в строке поиска.