Официальная инструкция по развёртыванию ВМ (Nubes)

Источник: официальный сайт Nubes — сохранено для использования в разработке — 2026-01-29

Описание

Данный сервис позволяет разворачивать виртуальные машины (ВМ) непосредственно из Личного кабинета (ЛК).

Доступные операции

create — Создание виртуальной машины
delete — Удаление виртуальной машины
resume — Запуск виртуальной машины
suspend — Остановка виртуальной машины

Параметры для развёртывания ВМ

Обязательные параметры

vappUid — UUID vApp, в которой будет создаваться виртуальная машина. Пример: WZ00400
vmName — Уникальное имя виртуальной машины. Пример: test-vm
vmCpu — Количество ядер процессора. Должно быть больше 0. Пример: 1
vmRam — Объем оперативной памяти в гигабайтах. Должно быть больше 0. Пример: 1
accessPortList — Белый список портов для доступа к виртуальной машине извне в формате JSON. Пример: ["22","10050"]
imageVm — Образ операционной системы для развёртывания. Доступные значения: RockyLinux_9-16G-cloudinit, Ubuntu_22-20G, Debian_13-20G
userLogin — Логин пользователя для SSH-доступа. По умолчанию: myuser
userPublicKey — Публичный SSH-ключ пользователя в формате OpenSSH. Пример: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC...
needAddZabbixTemplate — Значение истина/ложь, определяющее будет ли добавлен хост в Zabbix. Пример: true

Опциональные параметры

accessIpList — Белый список IP-адресов для доступа к виртуальной машине в формате JSON. Если оставить пустым, ВМ будет доступна со всех адресов. Пример: ["192.168.1.1", "10.0.0.5"]
vmDisk — Размер дополнительного диска в гигабайтах. Должно быть больше 0. Пример: 50
ipSpaceName — Внешний IP-адрес. Если не требуется — укажите значение "no-needed" (в нём не будет работать сбор метрик Zabbix).
cloudInit — YAML-скрипт для кастомизации системы через cloud-init.

Доступные образы операционных систем

RockyLinux_9-16G-cloudinit — Базовый образ Rocky Linux 9 (системный диск 16 ГБ). Поддержка cloud-init. Минимальные требования: 1 vCPU, 1 ГБ RAM.
Ubuntu_22-20G — Образ Ubuntu Server 22.04 LTS (системный диск 20 ГБ). Поддержка cloud-init. Минимальные требования: 1 vCPU, 1 ГБ RAM.
Debian_13-20G — Образ Debian 13 (Trixie) (системный диск 20 ГБ). Поддержка cloud-init. Минимальные требования: 1 vCPU, 1 ГБ RAM.

Пример использования Cloud-init

users:
  - name: myuser
    sudo: ALL=(ALL) NOPASSWD:ALL
    groups: sudo
    shell: /bin/bash
    ssh-authorized-keys:
      - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC...

packages:
  - nginx

runcmd:
  - systemctl enable --now nginx
  - systemctl restart nginx

Результат выполнения

После успешного развёртывания в Личном кабинете появится новая виртуальная машина с заданными характеристиками. SSH-доступ осуществляется с использованием указанных логина и публичного ключа.

Важные примечания и ограничения

Для отключения внешнего IP укажите значение "no-needed" в параметре ipSpaceName.
Параметр cloudInit является опциональным.
Не рекомендуется использовать продолжительные инструкции в cloudInit (таймаут ~5 минут).
Не поддерживается запись файлов через cloudInit (ограничение платформы).
Не реализовано создание резервных копий ВМ через данный сервис.

Диагностика проблем с Cloud-init

Основной лог-файл: /var/log/cloud-init.log.
Пакет не устанавливается:
- Проверьте доступность пакета в репозитории.
- Убедитесь в правильности написания имени пакета.
- Попробуйте установить вручную: apt install <имя_пакета> (Debian/Ubuntu) или dnf install <имя_пакета> (Rocky Linux).
Команда не выполняется:
- Проверьте наличие требуемой утилиты в системе.
- Убедитесь в правильности синтаксиса команды.
- Попробуйте выполнить команду вручную для диагностики.

Если нужно, могу также автоматически добавить ссылку на этот документ в docs/registry/resources/vm.md и/или в индекс документов — подтвердите, если хотите вставить ссылку (это предполагает изменение существующего файла).

6.2 KiB Raw Blame History