Files

T

Sergey Antropoff 0773f721ea Align sized cluster seeds and GET dumps with PVE wire shapes; restyle DATA panel.

- 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

2026-07-18 08:46:11 +03:00

4.6 KiB

Raw Permalink Blame History

Language / Язык: English | Русский

Web UI

Откройте 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 версий

Выберите мажор 6 / 7 / 8 / 9 в каталоге.
Изучите методы и покрытие.
Apply as runtime, когда нужно, чтобы живые маршруты /api2/* соответствовали этому мажору.
Подтвердите через /api2/json/version и /admin/compatibility.

Горячая замена только в памяти; перезапуск восстанавливает CONTRACT_SNAPSHOT. Подробнее: Версии API.

Замечание по безопасности

UI и demo-эндпоинты предназначены для локальной разработки. В текущей сборке они не защищены отдельным admin-токеном. Не выставляйте порт симулятора в недоверенные сети.

4.6 KiB Raw Permalink Blame History Unescape Escape