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

В этом разделе описаны стандартные действия пользователя при работе в 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-образов, отметьте необходимые объекты чекбоксами и нажмите на иконку Корзина в строке поиска.