Files

T

Sergey Antropoff 48df10b17e Prepare 0.1.0 for lab release: durable handlers, HTTP Compose, CI, and pulumi-tests.

- Harden DB-backed handlers and seed profiles; align client wire shapes for
  cluster resources, QEMU config, and node SSL fields
- Serve plain HTTP on Compose :8006; keep TLS optional (--profile tls) and
  terminate HTTPS at Kubernetes Ingress
- Add pulumi-tests (full contract surface majors 6–9 + BPG lifecycle) and
  make pulumi-tests
- Ship bilingual docs, CHANGELOG, SECURITY, CONTRIBUTING, and GitHub Actions
  (make ci + Compose/Helm validation)

2026-07-18 04:18:05 +03:00

2.3 KiB

Raw Blame History

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

Web UI

Open http://localhost:8006/ after make up.

The UI is a laboratory console for the simulator — not a full Proxmox VE management interface. It supports light and dark themes, PVE majors 6–9, request/response editing, history, and runtime contract apply.

Screenshots

Light theme — GET /cluster/resources on PVE 9.2.3:

Dark theme — same console with theme toggle:

Features

Endpoint tree and method selector driven by the selected catalog major
Contract-derived parameters and example payloads
Request editor, response viewer, and history
Password login with cookie + CSRF handling
Environment summary (runtime version, nodes, guests, storage)
Curl / request previews
PVE 6–9 API catalog with implementation coverage
Apply as runtime hot-swap for the active contract
Compatibility and readiness views
Demo-cluster load / unload / refresh
UPID task monitor (header control → status / log / “From last response”; requires login for authenticated task polls)
Link to OpenAPI at /docs

Backend helpers

Method	Path	Purpose
GET	`/ui/api/versions`	Catalog majors vs runtime
GET	`/ui/api/catalog?major=N`	Catalog for major 6–9
GET	`/ui/api/method?...`	Single method metadata
GET	`/ui/api/compatibility?major=N`	Coverage payload
POST	`/ui/api/contract/apply?major=N`	Hot-swap runtime contract
GET	`/ui/api/demo/state`	Demo dataset state
POST	`/ui/api/demo/load`	Load `demo-cluster`
POST	`/ui/api/demo/unload`	Unload → `minimal`

Version workflow

Pick major 6 / 7 / 8 / 9 in the catalog.
Inspect methods and coverage.
Apply as runtime when you want live /api2/* routes to match that major.
Confirm with /api2/json/version and /admin/compatibility.

Hot-swap is memory-only; restart restores CONTRACT_SNAPSHOT. Details: API versions.

Security note

UI and demo endpoints are intended for local development. They are not gated by a separate admin token in the current build. Do not expose the simulator port to untrusted networks.

2.3 KiB Raw Blame History Unescape Escape