{"queryDurationMs":49,"svc":{"svcId":28,"svc":"Виртуальная машина","svcShort":"vc_vm_v3","code":null,"version":"master","orchestratorName":"VmV3","createUrl":"https://jenkins-master1.adl.nubes.ru/job/cloudServicesDev/job/vc/job/VmV3/job/create/job/master/buildWithParameters","isProductionReady":true,"resourceRealmTypeId":2,"iconSrc":null,"descr":"Создание виртуальной машины","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
```yaml
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
### Основной лог-файл:
```bash
/var/log/cloud-init.log
```
### Пакет не устанавливается:
- Проверьте доступность пакета в репозитории
- Убедитесь в правильности написания имени пакета
- Попробуйте установить вручную: `apt install <имя_пакета>` (Debian/Ubuntu) или `dnf install <имя_пакета>` (Rocky Linux)
### Команда не выполняется:
- Проверьте наличие требуемой утилиты в системе
- Убедитесь в правильности синтаксиса команды
- Попробуйте выполнить команду вручную для диагностики","operations":[{"svcOperationId":132,"operation":"create","url":"https://jenkins-master1.adl.nubes.ru/job/cloudServicesDev/job/vc/job/VmV3/job/create/job/master/buildWithParameters","descr":null,"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".
**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
```yaml
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
### Основной лог-файл:
```bash
/var/log/cloud-init.log
```
### Пакет не устанавливается:
- Проверьте доступность пакета в репозитории
- Убедитесь в правильности написания имени пакета
- Попробуйте установить вручную: `apt install <имя_пакета>` (Debian/Ubuntu) или `dnf install <имя_пакета>` (Rocky Linux)
### Команда не выполняется:
- Проверьте наличие требуемой утилиты в системе
- Убедитесь в правильности синтаксиса команды
- Попробуйте выполнить команду вручную для диагностики"},{"svcOperationId":159,"operation":"modify","url":"https://jenkins-master1.adl.nubes.ru/job/cloudServicesDev/job/vc/job/VmV3/job/modify/job/master/buildWithParameters","descr":null,"man":null},{"svcOperationId":133,"operation":"delete","url":"https://jenkins-master1.adl.nubes.ru/job/cloudServicesDev/job/vc/job/VmV3/job/delete/job/master/buildWithParameters","descr":null,"man":null},{"svcOperationId":134,"operation":"suspend","url":"https://jenkins-master1.adl.nubes.ru/job/cloudServicesDev/job/vc/job/VmV3/job/suspend/job/master/buildWithParameters","descr":null,"man":null},{"svcOperationId":135,"operation":"resume","url":"https://jenkins-master1.adl.nubes.ru/job/cloudServicesDev/job/vc/job/VmV3/job/resume/job/master/buildWithParameters","descr":null,"man":null},{"svcOperationId":164,"operation":"redeploy","url":"https://jenkins-master1.adl.nubes.ru/job/cloudServicesDev/job/vc/job/VmV3/job/redeploy/job/master/buildWithParameters","descr":"Полная потеря данных гарантирована
Но будет полностью сброшенная машина","man":null}]},"runDurationMs":49}