tocdepth: 2

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

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

Управление репозиториями
Управление образами
Удаление Docker-образа из реестра

Сгенерируйте ключ для Docker CLI:
1. В левом меню платформы перейдите в ML Space → Воркспейсы.
2. Возле воркспейса, для которого нужно сгенерировать ключ, нажмите и выберите Параметры разработчика.
3. Возле Docker CLI Key нажмите Сгенерировать ключ.
4. После генерации скопируйте ключ.
1. В левом меню перейдите в Data Catalog → Artifact Registry → Docker registry.
2. Сгенерируйте ключ для Docker registry:
  - Если в Docker registry нет загруженных образов, вместо виден значок . Чтобы изменить ключ, необходимо сгенерировать новый, нажав Сгенерировать ключ для Docker CLI.
  - Если в Docker registry есть загруженные образы, нажмите . В появившемся окне нажмите Сгенерировать ключ для Docker CLI.
3. После генерации скопируйте ключ.
Аутентифицируйтесь в Docker registry.

Откройте терминал на вашем компьютере и аутентифицируйтесь в Docker CLI, используя команду:
```
docker login cr.ai.cloud.ru --username example@example.com --password examplepsswd
```
Где параметр example@example.com — это email пользователя, а examplepsswd — ключ, однократно передаваемый пользователю при нажатии на Сгенерировать ключ для Docker CLI.

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

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

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

Кликните по карточке репозитория.
Перейдите на вкладку Общая информация.
Задайте описание и нажмите Сохранить. Описание появится на карточке репозитория.

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

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

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

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

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

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

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

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

Перейдите в Data Catalog → Artifact Registry → Docker registry.
Нажмите 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-образом на платформе ML Space

Просмотр Docker-образа в реестре 

После загрузки становится доступна карточка. Внутри карточки доступны образы, загруженные в Docker-registry.

К карточке образа можно добавить описание.

Для добавления описания:

Перейдите в карточку образа.
Выберите вкладку Описание, добавьте его и сохраните.

Добавление тега к загруженному в реестр образу 

Для добавления тега:

Перейдите в карточку образа.
Выберите требуемый артефакт.
Нажмите Добавить тег.
Введите название тега и нажмите Добавить.

См.также

Документация Docker об использовании тегов (en)

Скачивание 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-образ:

Отметьте необходимые объекты чекбоксами.
Нажмите в строке поиска.

Примечание

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

Была ли статья полезной?

Спасибо за отзыв! Что можно улучшить?

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