Запуск Docker-образа на виртуальной машине с помощью Yandex Cloud Registry

1. Откройте терминал.

2. Создайте новый ключ с помощью команды ssh-keygen:

   ssh-keygen -t ed25519 -C "<опциональный_комментарий>"
   

   Вы можете передать в параметре -C пустую строку, чтобы не добавлять комментарий, или не указывать параметр -C вообще — в таком случае будет добавлен комментарий по умолчанию.

   После выполнения команды вам будет предложено указать имя и путь к файлам с ключами, а также ввести пароль для закрытого ключа. Если задать только имя, пара ключей будет создана в текущей директории. Открытый ключ будет сохранен в файле с расширением .pub, закрытый ключ — в файле без расширения.

   По умолчанию команда предлагает сохранить ключ под именем id_ed25519 в директории /home/<имя_пользователя>/.ssh. Если в этой директории уже есть SSH-ключ с именем id_ed25519, вы можете случайно перезаписать его и потерять доступ к ресурсам, в которых он используется. Поэтому рекомендуется использовать уникальные имена для всех SSH-ключей.

1. Установите Docker Engine. Воспользуйтесь инструкцией по установке и запуску Docker для вашей операционной системы.

2. После завершения установки добавьте текущего пользователя в группу docker:

   sudo groupadd docker
   sudo usermod -aG docker $USER
   newgrp docker
   

Чтобы группы успешно обновились, может потребоваться войти в ОС заново или перезагрузить компьютер.

Информацию о дополнительных настройках Docker в OS Linux см. в документации разработчика.

Если вы работаете на компьютере с графическим интерфейсом, вы также можете установить Docker Desktop для Linux.

1. В консоли управления выберите каталог, в котором хотите создать реестр.

2. Перейдите в сервис Cloud Registry.

3. Нажмите Создать реестр.

4. Выберите формат Docker.

5. Выберите тип реестра Local.

6. Укажите имя реестра. Требования к имени:

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

7. Нажмите Создать.

1. Перейдите в сервис Identity and Access Management.
2. В верхней части экрана перейдите на вкладку Сервисные аккаунты.
3. Нажмите Создать сервисный аккаунт.
4. Введите имя сервисного аккаунта docker-puller.
5. Нажмите Создать.
6. Перейдите в сервис Cloud Registry.
7. Выберите ранее созданный реестр.
8. Перейдите на вкладку Права доступа.
9. Нажмите Назначить роли.
10. В открывшемся окне выберите сервисный аккаунт docker-puller.
11. Нажмите Добавить роль и выберите роль cloud-registry.artifacts.puller.
12. Нажмите Сохранить.

1. Перейдите в сервис Identity and Access Management.
2. В открывшемся списке выберите сервисный аккаунт docker-puller.
3. На панели сверху нажмите Создать новый ключ и выберите Создать авторизованный ключ.
4. Нажмите Создать.
5. В открывшемся окне нажмите Скачать файл с ключами и нажмите Закрыть.

В результате на ваш компьютер скачается файл authorized_key.json, содержащий авторизованный ключ. Ключ понадобится позднее для настройки Docker на ВМ.

1. Перейдите в сервис Virtual Private Cloud.
2. Нажмите Создать сеть.
3. В поле Имя укажите docker-ycr-network.
4. В поле Дополнительно отключите опцию Создать подсети.
5. Нажмите Создать сеть.
6. Выберите созданную сеть docker-ycr-network.
7. Справа вверху нажмите Создать подсеть.
8. В поле Имя укажите docker-ycr-subnet-kz1-b.
9. В поле Зона доступности выберите зону доступности kz1-b.
10. В поле CIDR укажите 192.168.1.0/24.
11. Нажмите Создать подсеть.

1. Перейдите в сервис Compute Cloud.

2. Нажмите Создать виртуальную машину.

3. В блоке Образ загрузочного диска выберите один из образов и версию операционной системы на базе Linux.

4. В блоке Расположение выберите зону доступности, в которой будет создана ВМ.

5. В блоке Сетевые настройки:

   • В поле Подсеть выберите ранее созданные сеть и подсеть.
   • В поле Публичный IP-адрес оставьте значение Автоматически, чтобы назначить ВМ случайный внешний IP-адрес из пула Yandex Cloud.

6. В блоке Доступ укажите данные для доступа на ВМ:

   • В поле Логин введите имя пользователя.
   • В поле SSH-ключ вставьте содержимое файла открытого ключа.

7. В блоке Общая информация задайте имя ВМ: docker-vm.

8. В блоке Дополнительно выберите созданный сервисный аккаунт docker-puller.

9. Нажмите Создать ВМ.

1. Аутентифицируйтесь в Cloud Registry.

2. Создайте файл Dockerfile:

   echo "FROM ubuntu:latest" > Dockerfile
   echo "CMD echo 'Hello World'" >> Dockerfile
   

3. Соберите Docker-образ:

   docker build . -t registry.yandexcloud.net/<идентификатор_реестра>/ubuntu:hello
   

   Где <идентификатор_реестра> — идентификатор созданного ранее реестра.

   Результат:

   ...
   Successfully built db45********
   Successfully tagged registry.yandexcloud.net/cn1k31pgpovl********/ubuntu:hello
   

4. Загрузите Docker-образ в реестр:

   docker push registry.yandexcloud.net/<идентификатор_реестра>/ubuntu:hello
   

   Результат:

   e8bc********: Pushed 
   hello: digest: sha256:96d... size: 529
   

1. Подключитесь к ВМ по SSH.

2. Установите CLI и перезапустите терминал:

   curl -sSL https://storage.yandexcloud.net/yandexcloud-yc/install.sh | bash
   exec -l $SHELL
   

3. Создайте файл key.json и скопируйте в него содержимое файла авторизованного ключа сервисного аккаунта docker-puller:

   sudo nano key.json
   

4. Настройте CLI для сервисного аккаунта:

   yc config profile create docker-puller
   yc config set service-account-key key.json
   yc config set folder-id <идентификатор_каталога>
   

   В качестве folder-id укажите идентификатор каталога, в котором находится реестр.

   Результат:

   Profile 'docker-puller' created and activated
   

5. Установите Docker:

   sudo apt update
   sudo apt install docker.io
   

6. Добавьте текущего пользователя в группу docker и отключитесь от ВМ:

   sudo usermod -aG docker $USER
   exit
   

7. Заново подключитесь к ВМ по SSH.

8. Настройте Docker:

   mkdir -p ~/.docker
   cat > ~/.docker/config.json <<'EOF'
   {
     "credHelpers": {
       "registry.yandexcloud.net": "yc"
     }
   }
   EOF
   
   sudo tee /usr/local/bin/docker-credential-yc >/dev/null <<'EOF'
   #!/usr/bin/env bash
   exec yc cloud-registry docker-credential "$@"
   EOF
   
   sudo chmod +x /usr/local/bin/docker-credential-yc
   

9. Загрузите Docker-образ на ВМ:

   docker pull registry.yandexcloud.net/<идентификатор_реестра>/ubuntu:hello
   

   Результат:

   hello: Pulling from cn191rncdrhd********/ubuntu
   02de********: Pull complete
   Digest: sha256:96d...
   Status: Downloaded newer image for registry.yandexcloud.net/cn191rncdrhd********/ubuntu:hello
   registry.yandexcloud.net/cn191rncdrhd********/ubuntu:hello
   

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

    docker run registry.yandexcloud.net/<идентификатор_реестра>/ubuntu:hello
    

    Результат:

    Hello World