Действия с образами в 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, существует два варианта.
В левом меню платформы перейдите
.Возле воркспейса, для которого нужно сгенерировать ключ, нажмите
и выберите Параметры разработчика.
Возле Docker CLI Key нажмите Сгенерировать ключ.
После генерации скопируйте ключ.
В левом меню перейдите
.Сгенерируйте ключ для Docker registry:
Если в Docker registry нет загруженных образов, вместо
виден значок
. Чтобы изменить ключ, необходимо сгенерировать новый, нажав Сгенерировать ключ для Docker CLI.
Если в Docker registry есть загруженные образы, нажмите
. В появившемся окне нажмите Сгенерировать ключ для Docker CLI.
После генерации скопируйте ключ.
Управление репозиториями
Основные сведения о репозиториях приведены в разделе Базовые концепции модуля Docker registry. Репозитории отображаются в виде карточек на странице репозиториев. Карточки содержат всю необходимую для пользователя информацию: дата создания и изменения репозитория, описание репозитория, теги и др.
Пользователи могут выполнять следующие действия с репозиториями:
Задавать описания.
Удалять из реестра.
Добавлять в избранное.
Описание для репозитория
Кликните по карточке репозитория.
Перейдите на вкладку Общая информация.
Задайте описание и нажмите Сохранить. Описание появится на карточке репозитория.
Удаление репозитория
Нажмите
на карточке репозитория.
В открывшемся меню нажмите Удалить. Или отметьте необходимые объекты чекбоксами и нажмите на иконку Корзина в строке поиска.
Добавление репозитория в избранное
Для добавления репозитория в избранное нажмите .
Выбранный объект будет отображаться первым на странице репозиториев.
Управление образами
Пользователи могут загружать локальные Docker-образы в реестр (push), а также скачивать необходимые Docker-образы из реестра на локальную машину (pull).
Загрузка Docker-образа в реестр
Для загрузки образа в реестр выполните следующие действия:
Перейдите
.Нажмите Push command.
В диалоге 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]
Загрузите необходимый образ в реестр, выполнив указанные команды из консоли. В результате будет создан репозиторий, в котором появится артефакт — образ контейнера с указанным тегом. Или артефакт будет загружен в существующий репозиторий с требуемым именем.
Просмотр Docker-образа в реестре
После загрузки становится доступна карточка. Внутри карточки доступны образы, загруженные в Docker-registry.
К карточке образа можно добавить описание.
Для добавления описания:
Зайдите в карточку образа.
Выберите вкладку Описание, добавьте его и сохраните.
К загруженному образу можно добавить тег.
Для добавления тега:
Зайдите в карточку образа.
Выберите требуемый артефакт.
Нажмите Добавить тег.
Введите название тега и нажмите Добавить.
Скачивание Docker-образа из реестра
Для скачивания Docker-образа из реестра на локальную машину:
Выберите необходимый Docker-образ.
Скачайте образ из реестра, выполнив соответствующую команду из консоли:
Используя тег:
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-образ:
Отметьте необходимые объекты чекбоксами.
Нажмите на иконку Корзина в строке поиска.