Как начать работать с Container Registry

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

Подготовка к работеПодготовка к работе

Для создания реестра вам понадобится каталог в Yandex Cloud. Если каталога еще нет, перед созданием реестра необходимо создать новый каталог:

1. В консоли управления на панели сверху нажмите или и выберите нужное облако.

2. Справа от названия облака нажмите .

3. Выберите Создать каталог.

   

4. Введите имя каталога. Требования к имени:

   • длина — от 3 до 63 символов;
   • может содержать строчные буквы латинского алфавита, цифры и дефисы;
   • первый символ — буква, последний — не дефис.

5. (Опционально) Введите описание каталога.

6. Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.

7. Нажмите кнопку Создать.

   

Чтобы работать с Container Registry и Docker-образами, установите Yandex Cloud CLI и настройте Docker.

Создание реестра и базовые операции с Docker-образомСоздание реестра и базовые операции с Docker-образом

1. Создайте реестр в Container Registry:

   yc container registry create --name my-first-registry
   

   Результат:

   ..done
   id: crpc9qeoft23********
   folder_id: b1g0itj57rbj********
   name: my-first-registry
   status: ACTIVE
   created_at: "2018-12-25T12:24:56.286Z"
   

   Полученный ID далее будет использоваться для обращения к созданному реестру.

2. Аутентифицируйтесь в Container Registry с помощью Docker credential helper:

   1. Сконфигурируйте Docker для использования docker-credential-yc:

      yc container registry configure-docker
      

      Результат:

      Credential helper is configured in '/home/<user>/.docker/config.json'
      

      При конфигурации сохраняется информация о текущем профиле пользователя.

      Важно

      Credential helper работает только при использовании Docker без sudo. О том, как настроить запуск Docker от имени текущего пользователя без использования sudo, читайте в официальной документации Docker.

   2. Проверьте, что Docker сконфигурирован.

      В конфигурационном файле /home/<user>/.docker/config.json должна появиться строка:

      "cr.yandex": "yc"
      

3. Скачайте Docker-образ из репозитория Docker Hub:

   docker pull ubuntu
   

4. Присвойте скачанному Docker-образу тег вида cr.yandex/<идентификатор_реестра>/<имя_Docker-образа>:<тег>:

   docker tag ubuntu \
   cr.yandex/<идентификатор_реестра>/ubuntu:hello
   

5. Загрузите Docker-образ в репозиторий Container Registry:

   docker push \
   cr.yandex/<идентификатор_реестра>/ubuntu:hello
   

6. Запустите Docker-образ:

   docker run \
   cr.yandex/<идентификатор_реестра>/ubuntu:hello
   

Полезные ссылкиПолезные ссылки

• Создание реестра
• Аутентификация в Container Registry
• Создание Docker-образа
• Загрузка Docker-образа
• Скачивание Docker-образа
• Запуск Docker-образа на виртуальной машине