Skip to content

Resource nubes_vc_vm_v3 · Service ID: 28 · Service Name: Виртуальная машина

Manual · Create params · Modify params · Output params · Operations · Example

MAN

Документация по разворачиванию ВМ в Личном кабинете

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

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

  • 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 (Rocky-9.6-x86_64-minimal) для серверных задач. - Размер системного диска: 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 является опциональным

Ограничения:

  • Не рекомендуется использовать продолжительные инструкции в cloud-init (таймаут 5 минут)
  • Не поддерживается запись файлов через cloud-init
  • Не реализовано создание резервных копий ВМ

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

Основной лог-файл:

/var/log/cloud-init.log

Пакет не устанавливается:

  • Проверьте доступность пакета в репозитории
  • Убедитесь в правильности написания имени пакета
  • Попробуйте установить вручную: apt install <имя_пакета> (Debian/Ubuntu) или dnf install <имя_пакета> (Rocky Linux)

Команда не выполняется:

  • Проверьте наличие требуемой утилиты в системе
  • Убедитесь в правильности синтаксиса команды
  • Попробуйте выполнить команду вручную для диагностики