Add first VM guide

docs/FIRST_VM.md

@@ -0,0 +1,104 @@
+# Первая тестовая виртуальная машина
+
+Этот документ фиксирует проверку первого рабочего сценария Virtuality: сеть `br0`, libvirt storage pools и запуск тестовой VM.
+
+## Требования
+
+Перед созданием VM должны быть готовы:
+
+- KVM/QEMU;
+- libvirt;
+- Cockpit;
+- storage pools `virtuality-images` и `virtuality-iso`;
+- bridge `br0`;
+- default route через `br0`.
+
+Проверка:
+
+```bash
+sudo vhealth
+ip -br a
+ip route
+virsh pool-list --all
+```
+
+Нормальная сеть:
+
+```text
+enp2s0  UP
+br0     UP  10.0.0.200/24
+default via 10.0.0.1 dev br0
+```
+
+## Создание тестовой VM
+
+```bash
+cd ~/virtuality
+git pull
+sudo bash scripts/create_test_vm.sh
+```
+
+По умолчанию создаётся VM:
+
+```text
+Name:   test-alpine
+RAM:    1024 MB
+CPU:    1 vCPU
+Disk:   8 GB qcow2
+ISO:    Alpine Linux
+Network: br0
+Graphics: VNC
+```
+
+Можно задать имя:
+
+```bash
+sudo bash scripts/create_test_vm.sh test-alpine-2
+```
+
+## Проверка
+
+```bash
+virsh list --all
+sudo virsh vncdisplay test-alpine
+sudo vhealth
+```
+
+Если `vncdisplay` показывает `:0`, значит порт VNC — `5900`.
+
+Если показывает `:1`, значит порт VNC — `5901`.
+
+## Доступ через Cockpit
+
+Открыть:
+
+```text
+https://SERVER_IP:9090
+```
+
+Дальше:
+
+```text
+Virtual machines → test-alpine → Console
+```
+
+## Что считается успешным результатом
+
+Этап считается пройденным, если:
+
+- VM появилась в `virsh list --all`;
+- VM запущена;
+- консоль открывается в Cockpit или через VNC;
+- VM подключена к bridge `br0`;
+- `sudo vhealth` не показывает критических ошибок по Virtuality.
+
+## Следующий этап
+
+После первой тестовой VM можно переходить к разработке собственной панели управления Virtuality:
+
+- список VM;
+- статусы VM;
+- запуск/остановка;
+- просмотр storage pools;
+- создание VM через UI;
+- базовый журнал событий.