Sergey Antropoff
0773f721ea
- Scale small/large/big seeds (3×50 / 10×1000 / 20×2000) with proportional backups, snapshots, HA, replication, Ceph capacity, and OSD totals (10 / 100 / 500) plus matching node disks and crush/pg metadata - Enrich handler responses for apt, certificates, qemu/lxc status, storage, SDN, metrics export, and related cluster/node dumps - Flatten nested body_example fields into PARAMS and sync the request body via dotted paths (oVirt-style) - Restyle DATA controls as size cards with full-width Reset to minimal / Refresh stats; unload reloads the minimal cluster
107 lines
4.6 KiB
Markdown
107 lines
4.6 KiB
Markdown
**Language / Язык:** [English](../web-ui.md) | [Русский](web-ui.md)
|
||
|
||
# Web UI
|
||
|
||
Откройте [http://localhost:8006/](http://localhost:8006/) после `make up`.
|
||
|
||
UI — лабораторная консоль симулятора, а не полноценный интерфейс управления Proxmox VE.
|
||
Поддерживаются светлая и тёмная темы, мажорные версии PVE **6–9**, редактирование
|
||
запросов/ответов, история и runtime apply контракта.
|
||
|
||
## Скриншоты
|
||
|
||
Главный экран консоли (тёмная тема, PVE 8.4.5):
|
||
|
||
|
||
|
||
Светлая / тёмная темы:
|
||
|
||
|
||
|
||
|
||
|
||
Панель Endpoints (методы каталога выбранного мажора):
|
||
|
||
|
||
|
||
Каталог API — мажоры 6–9, покрытие и **Apply as runtime**:
|
||
|
||
|
||
|
||
Редактор запроса (`POST /cluster/config`):
|
||
|
||
|
||
|
||
Параметры запроса из контракта:
|
||
|
||
|
||
|
||
Аутентификация (`root@pam` / API-токен):
|
||
|
||
|
||
|
||
Сводка окружения (runtime, кластер, гости):
|
||
|
||
|
||
|
||
История запросов:
|
||
|
||
|
||
|
||
Справка / ledger совместимости:
|
||
|
||
|
||
|
||
Загрузка demo-кластера:
|
||
|
||
|
||
|
||
Монитор задач UPID:
|
||
|
||
|
||
|
||
## Возможности
|
||
|
||
- Дерево эндпоинтов и выбор метода по выбранному мажору каталога
|
||
- Параметры и примеры payload, производные от контракта
|
||
- Редактор запросов, просмотр ответов и история
|
||
- Вход по паролю с обработкой cookie + CSRF
|
||
- Сводка окружения (runtime-версия, узлы, гости, storage)
|
||
- Превью curl / запросов
|
||
- Каталог API PVE **6–9** с покрытием реализации
|
||
- **Apply as runtime** — горячая замена активного контракта
|
||
- Представления совместимости и готовности
|
||
- Загрузка / выгрузка / обновление demo-кластера
|
||
- Монитор задач UPID (кнопка в шапке → status / log / «From last response»;
|
||
для опросов задач нужна аутентификация)
|
||
- Ссылка на OpenAPI по `/docs`
|
||
|
||
## Backend-хелперы
|
||
|
||
| Method | Path | Назначение |
|
||
|---|---|---|
|
||
| GET | `/ui/api/versions` | Мажорные версии каталога vs runtime |
|
||
| GET | `/ui/api/catalog?major=N` | Каталог для мажора 6–9 |
|
||
| GET | `/ui/api/method?...` | Метаданные одного метода |
|
||
| GET | `/ui/api/compatibility?major=N` | Payload покрытия |
|
||
| POST | `/ui/api/contract/apply?major=N` | Горячая замена runtime-контракта |
|
||
| GET | `/ui/api/demo/state` | Состояние demo-набора данных |
|
||
| POST | `/ui/api/demo/load` | Загрузить `demo-cluster` |
|
||
| POST | `/ui/api/demo/unload` | Выгрузить → `minimal` |
|
||
|
||
## Workflow версий
|
||
|
||
1. Выберите мажор **6 / 7 / 8 / 9** в каталоге.
|
||
2. Изучите методы и покрытие.
|
||
3. **Apply as runtime**, когда нужно, чтобы живые маршруты `/api2/*` соответствовали
|
||
этому мажору.
|
||
4. Подтвердите через `/api2/json/version` и `/admin/compatibility`.
|
||
|
||
Горячая замена только в памяти; перезапуск восстанавливает `CONTRACT_SNAPSHOT`.
|
||
Подробнее: [Версии API](api-versions.md).
|
||
|
||
## Замечание по безопасности
|
||
|
||
UI и demo-эндпоинты предназначены для локальной разработки. В текущей сборке они не
|
||
защищены отдельным admin-токеном. Не выставляйте порт симулятора в недоверенные сети.
|