Действия с образами в Docker registry

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

Перед началом работы аутентифицируйтесь в Docker registry из консоли с помощью команды:

docker login cr.msk.sbercloud.ru --username example@example.com --password examplepsswd

Где параметр example@example.com — это email пользователя, а examplepsswd — ключ, однократно передаваемый пользователю при нажатии на Сгенерировать ключ для Docker CLI.

Чтобы сгенерировать ключ для Docker CLI, существует два варианта.

  1. В левом меню платформы перейдите ML Space → Воркспейсы.

    ../../../_images/s__select__ws.png
  2. Возле воркспейса, для которого нужно сгенерировать ключ, нажмите Кнопка с тремя вертикальными точками и выберите Параметры разработчика.

  3. Возле Docker CLI Key нажмите Сгенерировать ключ.

  4. После генерации скопируйте ключ.

    ../../../_images/s__devel_params.png

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

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

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

  • Задавать описания.

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

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

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

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

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

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

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

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

  2. В открывшемся меню нажмите Удалить. Или отметьте необходимые объекты чекбоксами и нажмите на иконку Корзина в строке поиска.

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

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

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

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

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

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

  1. Перейдите Data Catalog → Artifact registry → Docker registry.

  2. Нажмите Push command.

  3. В диалоге 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]
    
  4. Загрузите необходимый образ в реестр, выполнив указанные команды из консоли. В результате будет создан репозиторий, в котором появится артефакт — образ контейнера с указанным тегом. Или артефакт будет загружен в существующий репозиторий с требуемым именем.

Просмотр 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. Нажмите на иконку Корзина в строке поиска.