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

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

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

Основные сведения о репозиториях приведены в разделе Базовые концепции модуля 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. Нажмите на иконку Корзина в строке поиска.