tocdepth

2

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

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

  1. Сгенерируйте ключ для Docker CLI:

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

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

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

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

  2. Аутентифицируйтесь в Docker registry любым из предпочитаемых способов.

    С помощью интерфейса ML Space можно аутентифицироваться в Docker CLI, используя команду:

    docker login cr.ai.cloud.ru --username example@example.com --password examplepsswd
    

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

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

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

Примечание

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

Запустили Evolution free tier
для Dev & Test
Получить