×

Создание виртуальной машины и первое подключение

 

ВВЕДЕНИЕ

 
Виртуальная машина в DevSpace — это обычная машина с собственной операционной системой: вы заходите в неё по SSH, ставите пакеты, правите конфигурационные файлы и запускаете что угодно. В отличие от управляемых сервисов платформа не вмешивается в то, что происходит внутри, и отвечает только за саму машину: процессор, память, диск, сеть и внешний адрес.
 
Машина собирается из двух объектов, которые создаются по отдельности:
 
  • VM Disk — диск с операционной системой. Его создают первым: платформа берёт готовый образ системы из своей коллекции и разворачивает на диск нужного размера
  • VM Instance — сама машина. Ей задают размер процессора и памяти, подключают созданный диск и настраивают доступ снаружи
 
Диск живёт отдельно от машины и переживает её удаление. Поэтому машину можно пересоздать с другими настройками, подключив тот же диск с данными.
 
Чем это отличается от привычной работы с виртуальными машинами:
 
  • диск создаётся отдельно от машины и переиспользуется, а не входит в неё неразрывно
  • внешний адрес выдаётся не самой машине, а балансировщику платформы, который пробрасывает на неё выбранные порты
  • вход по паролю в образах из коллекции выключен, доступ открывается SSH-ключом, который вы указываете при создании
  • на случай, когда сеть или SSH сломаны, в дашборде есть консоль VNC — это как монитор, подключённый к машине напрямую
 

ПЕРЕД НАЧАЛОМ

 
Понадобятся:
 
  • доступ к пространству DevSpace и право создавать в нём сервисы
  • SSH-клиент на рабочей станции
  • ваш публичный SSH-ключ — пароль для входа в образах не задан, и без ключа в машину можно будет попасть только через консоль VNC
 

ПОШАГОВОЕ РУКОВОДСТВО

 

Шаг 1. Создайте диск

 
Войдите в дашборд DevSpace и откройте раздел Marketplace. Найдите карточку VM Disk (категория IaaS, подпись «Virtual Machine disk») и откройте её. У формы две вкладки: Form (поля) и YAML (та же конфигурация текстом), под полем имени показан tenant-id вашего пространства.
 
Для примера в этой статье используются значения:
 
Поле
Значение
Зачем
 Name
demo01
Имя диска: строчные латинские буквы, цифры, дефисы. Станет частью имени ресурса (vm-disk-demo01) и будет видно в списке дисков при создании машины
 source
image → ubuntu-22.04
Откуда взять содержимое диска. Вариант image берёт готовый образ системы из коллекции платформы
 storage
25Gi
Размер диска
 storageClass
replicated
Класс хранилища. После создания изменить нельзя
 optical
выключено
Подключать диск как CD-привод, а не как обычный диск
 
Переключатель source задаёт, откуда берётся содержимое диска, и у него четыре варианта:
 
  • image — готовый образ системы из коллекции платформы
  • disk — копия другого диска, который уже есть в вашем пространстве. Так делают копию машины или откатываются к заранее подготовленному состоянию
  • http — образ скачивается по ссылке. Подходит для своего образа, выложенного на веб-сервере или S3-бакете без авторизации
 
Про свой образ по ссылке — в разделе «Диск из своего образа» после шага 2.
Размер диска по умолчанию — 5Gi, и для образа с системой этого может не хватить. Образ разворачивается на диск целиком, и если места мало, диск останется неготовым, а машина с ним не запустится. Для машины общего назначения берите от 25Gi — как в примере. Диск можно увеличить позже, уменьшить нельзя.
 

Шаг 2. Дождитесь готовности диска

 
Нажмите Deploy. Откроется карточка диска — дождитесь статуса Ready в шапке. Платформа в это время скачивает образ системы и разворачивает его на диск, так что на готовность уходит несколько минут.
 
У карточки диска всего две вкладки: Overview с текущей конфигурацией и Events с событиями. Запущенных компонентов у диска нет, поэтому вкладки Workloads здесь не будет — в отличие от остальных сервисов проверять нечего, достаточно статуса.
 

ДИСК ИЗ СВОЕГО ОБРАЗА

 
Этот раздел нужен, только если готовых образов из коллекции вам не хватает: например, у вас есть свой подготовленный образ с преднастроенной системой или дистрибутив, которого нет в списке. Для обычной машины пропустите его и переходите к шагу 3.
 
Образ должен быть диском виртуальной машины в формате qcow2 или raw, допустим и загрузочный ISO — он обрабатывается как raw. Образ можно передавать сжатым архиватором gz или xz, платформа распакует его сама. Форматы других систем виртуализации, например vmdk, не поддерживаются — конвертируйте такой образ заранее, скажем, утилитой qemu-img.
 
Образ по ссылке (source: http). Подходит, когда образ уже лежит на веб-сервере или в объектном хранилище и доступен по прямой ссылке без авторизации. Скачивает образ сама платформа, а не ваш компьютер, поэтому ссылка должна открываться с её стороны — внутренний адрес вашей сети не подойдёт.
 
При создании диска выберите в переключателе source вариант http и укажите ссылку в поле url:
 
Размер диска в поле storage задавайте с запасом относительно распакованного образа, а не файла по ссылке. Сжатый qcow2 в несколько десятков мегабайт разворачивается в сотни, и если места не хватит, диск останется неготовым.
 
Нажмите Deploy. Платформа начинает скачивать образ сразу, подключать диск к машине для этого не нужно. Пока идёт скачивание, в шапке карточки держится статус Progressing, а в блоке Details — строка вида «Running 'install' action with timeout of 10m0s». Статус Ready появляется, когда образ скачан и развёрнут на диск.
 
Процентов в карточке нет, виден только статус. Если нужен прогресс, посмотрите его из командной строки — подключение описано в статье Подключение к пространству через kubectl:
kubectl get dv vm-disk-<name> -o jsonpath='{.status.progress}{"\n"}'
 
На вкладке Events видно, как это происходит: сначала хранилище создаёт том (Provisioning, ExternalProvisioning), затем идёт импорт (ImportScheduled, ImportInProgress, ImportSucceeded) и том переходит в Bound.
Среди событий импорта попадаются два помеченных как Warning, и оба нормальны. Importer pod cannot be scheduled означает, что том ещё создаётся и запускать скачивание пока некуда — через несколько секунд импорт стартует сам. Completed: Import Complete помечено предупреждением, хотя означает успешное завершение импорта. Тревожиться стоит, если диск не доходит до Ready и в событиях есть ошибки про недоступность ссылки или нехватку места.
 
Для примера: образ cirros 0.6.3 с развёрнутым размером 112 МиБ на диск 1Gi класса replicated скачался и развернулся примерно за полторы минуты. Для крупного образа это дольше, а скорость зависит от сервера, с которого он забирается.
 

Шаг 3. Создайте виртуальную машину

 
Вернитесь в Marketplace и откройте карточку VM Instance (категория IaaS, подпись «Virtual machine instance»).
 
Для примера в этой статье используются значения:
 
Поле
Значение
Зачем
 Name
demo01
Имя машины. Станет частью имени сервиса (vm-instance-demo01)
 external
включено
Опубликовать машину наружу через балансировщик с внешним адресом
 externalMethod
PortList
Пробрасывать только перечисленные порты, а не весь трафик
 externalPorts
22
Порт SSH. Это значение уже стоит в форме
 externalAllowICMP
включено
Разрешить ping. Включено по умолчанию
 runStrategy
Always
Машина должна быть всегда запущена
 instanceType
u1.medium
Размер машины: процессор и память (справочник пресетов)
 instanceProfile
ubuntu
Профиль настроек под операционную систему машины
 disks
demo01 (25Gi)
Диск из шага 1. Нажмите + add в блоке disks и выберите его в списке
 sshKeys
ваш публичный ключ
Ключ для входа по SSH. Нажмите + add и вставьте строку целиком
instanceProfile подбирает настройки виртуального оборудования под конкретную операционную систему — тип дисковой шины, сетевой адаптер, раскладку устройств. Выбирайте профиль под систему своего диска: для образов Ubuntu — ubuntu, для Debian — debian, для семейства RHEL — rhel.9 или centos.stream9 и так далее. С неподходящим профилем система может не увидеть диск или сеть.
 
Поле externalMethod определяет, как машина видна снаружи:
 
  • PortList — наружу открыты только порты из списка externalPorts. Остальные закрыты, и это безопаснее
  • WholeIP — машине пробрасывается весь трафик внешнего адреса. Нужно, когда машина сама должна принимать произвольные протоколы, но тогда защиту от лишних подключений настраиваете вы сами внутри системы
 
Поле runStrategy задаёт, в каком состоянии платформа держит машину:
 
  • Always — машина всегда запущена, после сбоя или перезагрузки поднимается снова. Обычный выбор
  • Halted — машина создана, но выключена
  • Manual — состоянием управляете вы кнопками на карточке, платформа его не меняет
  • RerunOnFailure — машина перезапускается только после аварийного завершения, а корректное выключение изнутри остаётся выключением
  • Once — машина запускается один раз и после остановки больше не поднимается
 
Остальные поля можно оставить пустыми. Их назначение описано в разделе «Параметры».
 

Шаг 4. Убедитесь, что машина запущена

 
Нажмите Deploy. Откроется карточка машины — дождитесь статуса Ready в шапке. Рядом с ним появится состояние питания Running и кнопки Start, Restart, Stop, которыми машину можно выключить и включить, не меняя конфигурацию.
 
Статус Ready означает, что платформа применила конфигурацию. Фактическое состояние смотрите на вкладке Workloads карточки: в разделе Pods одна строка virt-launcher-vm-instance-demo01-… — это и есть запущенная машина. Она готова, когда в строке статус Running, а числа в счётчике совпадают: 1/1.
Если строка долго не доходит до Running, откройте вкладку Events. Самая частая причина — диск, которому не хватило места под образ системы (шаг 1).
 

Шаг 5. Получите адрес и подключитесь по SSH

 
На вкладке Services карточки найдите сервис vm-instance-demo01 — это балансировщик с внешним адресом в колонке External IP и проброшенным портом 22/TCP.
 
Подключитесь к машине. Имя пользователя в образах из коллекции совпадает с названием системы, для Ubuntu это ubuntu:
ssh ubuntu@<внешний-IP>
 
Вход выполняется по SSH-ключу из шага 3, пароль не спрашивается.
 

Шаг 6. Откройте консоль VNC

 
Вкладка VNC карточки показывает экран машины так, как его показывал бы монитор, подключённый к физическому серверу. Консоль работает независимо от сети машины и от SSH, поэтому через неё можно попасть в систему, когда:
 
  • сломана или неверно настроена сеть, SSH недоступен
  • вы ошиблись в правилах межсетевого экрана и закрыли себе доступ
  • нужно увидеть, что происходит при загрузке системы, или зайти в меню загрузчика
 
В левом верхнем углу консоли — индикатор подключения и имя машины, в правом — кнопки управления питанием, разворачивания на весь экран и переподключения к консоли.
Вконсоли система просит логин и пароль, а у образов из коллекции пароль не задан — вход в них открывается только по SSH-ключу. Чтобы консоль пригодилась в аварийной ситуации, задайте пароль заранее: либо изнутри машины командой sudo passwd ubuntu, либо при создании машины через поле cloudInit.
 

ПАРАМЕТРЫ

 

Диск (VM Disk)

 
Параметр
Что делает
Значение по умолчанию
Когда менять
 source.image.name
Образ системы из коллекции платформы
не задан
Основной способ создать диск для новой машины
 source.disk.name
Копия другого диска вашего пространства
не задан
Для копии машины или отката к подготовленному состоянию
 source.http.url
Ссылка, по которой скачать образ в формате qcow2, raw или ISO, в том числе сжатый gz или xz
не задан
Для своего образа, выложенного на веб-сервере и доступного без авторизации
 storage
Размер диска
5Gi
Почти всегда: под образ системы берите от 25Gi. Увеличить можно позже, уменьшить нельзя
 storageClass
Класс хранилища: replicated хранит копии данных на нескольких серверах, local быстрее
replicated
У диска машины своей репликации нет, поэтому по умолчанию replicated. local — когда машина легко пересоздаётся или данные дублирует приложение внутри неё. Параметр неизменяемый
 optical
Подключать диск как CD-привод
false
Для установочного образа, с которого машина загружается при первой установке системы
 

Машина: внешний доступ

 
Параметр
Что делает
Значение по умолчанию
Когда менять
 external
Публикует машину наружу через балансировщик с внешним адресом
false
Включайте, если к машине нужно подключаться из интернета. Машины одного пространства видят друг друга и без этого
 externalMethod
PortList — наружу открыты только порты из externalPorts, WholeIP — машине пробрасывается весь трафик адреса
PortList
WholeIP — когда машина принимает произвольные протоколы и вы сами закрываете лишнее внутри системы
 externalPorts
Список портов, которые пробрасываются при PortList
[22]
Добавьте порты своих служб, например 80 и 443 для веб-сервера
 externalAllowICMP
Разрешает ping и определение размера пакета в режиме PortList
true
Выключайте, только если машина не должна отвечать на ping
 

Машина: выполнение и ресурсы

 
Параметр
Что делает
Значение по умолчанию
Когда менять
 runStrategy
Состояние, в котором платформа держит машину: Always, Halted, Manual, RerunOnFailure, Once
Always
Manual — когда машину включаете вручную, Halted — чтобы создать машину выключенной
 instanceType
Размер машины: процессор и память (справочник пресетов)
u1.medium
По нагрузке. Размер меняется без пересоздания машины
 instanceProfile
Профиль виртуального оборудования под операционную систему машины
ubuntu
Под систему своего образа. С неподходящим профилем система может не увидеть диск или сеть
 resources.cpu / resources.memory
Явные процессор и память вместо размера из instanceType
не заданы
Когда готовые размеры не подходят Память указывайте с единицами измерения: 512Mi, 2Gi.
 resources.sockets
Число процессорных сокетов в машине
не задано
Для систем и лицензий, чувствительных к числу сокетов
 cpuModel
Модель процессора, которую видит система машины
не задана
Для программ, требующих конкретных инструкций процессора
 gpus
Список видеокарт, подключаемых к машине
[]
Пока не используется: узлов с GPU в DevSpace нет
 
Машина: диски, сеть и доступ
 
Параметр
Что делает
Значение по умолчанию
Когда менять
 disks
Диски, подключаемые к машине. У каждого диска указывается name — имя VM Disk из вашего пространства
[]
Подключите как минимум диск с системой. Дополнительные диски — для данных, которые должны пережить пересоздание машины
 disks[].bus
Тип шины, по которой диск виден системе внутри машины
не задан — выбирает платформа
Оставляйте пустым, работает в большинстве случаев. Варианты разобраны ниже
 networks
Дополнительные сети, к которым подключается машина
[]
Когда машине нужна отдельная сеть помимо сети пространства
 subnets
Устаревший параметр, заменён на networks
[]
Не используйте в новых машинах
 sshKeys
Список публичных SSH-ключей, которым разрешён вход
[]
Укажите хотя бы один: пароль в образах не задан
 cloudInit
Настройки первого запуска системы: пользователи, пароли, пакеты, команды
не заданы
Чтобы машина поднялась сразу настроенной
 cloudInitSeed
Строка, из которой вычисляется постоянный идентификатор машины
не задана
Когда программам внутри машины нужен неизменный идентификатор оборудования
 
Варианты bus:
 
Значение
Когда выбирают
 virtio
Обычный выбор для современных систем: драйвер есть в ядре Linux из коробки, работает быстрее остальных
 sata
Системы, которые не умеют virtio без дополнительных драйверов, — например старые сборки Windows
 scsi
Когда приложению или системе нужен SCSI-контроллер, в том числе для горячего подключения дисков
 usb
Редкие случаи совместимости, когда остальные варианты система не видит
 
Шина задаётся у каждого диска отдельно, так что системный диск и диск с данными могут быть на разных. Менять её у работающей машины не стоит: система внутри может не найти диск по новому адресу.
 

Готовые примеры cloudInit

 
Поле cloudInit принимает конфигурацию cloud-init — её система читает при первом запуске. Конфигурация многострочная, вписывать её нужно на вкладке YAML: переключитесь на неё и добавьте блок в spec. Первая строка #cloud-config обязательна, без неё система примет текст за обычный файл и ничего не выполнит.
 
Задать пароль, чтобы войти в машину через консоль VNC:
  cloudInit: |
    #cloud-config
    password: <пароль>
    chpasswd: { expire: false }
    ssh_pwauth: true   
 
Завести своего пользователя с правами администратора и доступом по ключу:
  cloudInit: |
    #cloud-config
    users:
      - name: deploy
        groups: sudo
        sudo: ALL=(ALL) NOPASSWD:ALL
        shell: /bin/bash
        ssh_authorized_keys:
          - <ваш-публичный-ключ>   
 
Поставить пакеты и запустить службу сразу после первого старта:
  cloudInit: |
    #cloud-config
    package_update: true
    packages:
      - nginx
    runcmd:
      - systemctl enable --now nginx   
 
Отступы важны: содержимое идёт на две позиции правее, чем cloudInit, иначе конфигурация не разберётся. Выполняется она один раз — при первом запуске машины, а не при каждом перезапуске.
 

ПРИМЕР КОНФИГУРАЦИИ

 
Итоговые ресурсы, соответствующие шагам выше. Вкладка YAML формы показывает и принимает ту же конфигурацию.
 
Диск:
apiVersion: apps.cozystack.io/v1alpha1
kind: VMDisk
metadata:
  name: demo01
spec:
  # Готовый образ системы из коллекции платформы.
  source:
    image:
      name: ubuntu-22.04
 
  # Под образ системы 5Gi по умолчанию мало.
  storage: 25Gi
 
  # Неизменяемый параметр: выбирайте класс сразу.
  storageClass: replicated
 
  # Обычный диск, а не CD-привод.
  optical: false
 
Машина:
apiVersion: apps.cozystack.io/v1alpha1
kind: VMInstance
metadata:
  name: demo01
spec:
  # Внешний адрес с пробросом только перечисленных портов.
  external: true
  externalMethod: PortList
  externalPorts:
    - 22
  externalAllowICMP: true
 
  # Машина всегда запущена.
  runStrategy: Always
 
  # Размер машины и профиль оборудования под Ubuntu.
  instanceType: u1.medium
  instanceProfile: ubuntu
 
  # Диск с системой из первой части примера.
  disks:
    - name: demo01
 
  # Вход по ключу: пароль в образе не задан.
  sshKeys:
    - "<ваш-публичный-ключ>"
Производные ресурсы получают префиксы: диск — vm-disk-demo01, машина и её сервис — vm-instance-demo01.
 

ПРОВЕРКА

 
Подключитесь к машине и посмотрите систему и диск:
ssh ubuntu@<внешний-IP>
 
Внутри машины:
cat /etc/os-release
df -h /
 
Первая команда покажет версию системы, вторая — размер корневого раздела, близкий к размеру диска из шага 1.
 
Типовые ошибки: Permission denied (publickey) — в машине нет вашего ключа, добавьте его в sshKeys или войдите через консоль VNC. Таймаут подключения — внешний адрес ещё не выдан, порт не добавлен в externalPorts или машина ещё загружается. Диск долго не доходит до Ready — скорее всего, образу не хватило места.
 

ЧТО ДАЛЬШЕ

 
 
  • Настройка при первом запуске — поле cloudInit заводит пользователей, задаёт пароли, ставит пакеты и выполняет команды при первом старте машины. Готовые примеры — в разделе «Параметры».
  • Публикация служб — добавляйте порты своих служб в externalPorts, например 80 и 443 для веб-сервера. Отдельный внешний адрес для каждой службы не нужен.
  • Дополнительные диски — создайте ещё один VM Disk и подключите его в disks. Такой диск переживает пересоздание машины, поэтому данные держите на нём, а не на системном.
  • Масштабирование — instanceType меняется в той же форме, машина перезапустится с новым размером. Диск можно только увеличивать.
  • Удаление — машина и диск удаляются по отдельности. Удаление машины данные на диске не трогает, удаление диска удаляет их безвозвратно.