f8d3cbdd59
Add the FastAPI app, PostgreSQL migrations, Docker/Helm packaging, API contracts, docs, client examples, and the unit/integration/compatibility test suite for local client and tooling labs without a real vCenter.
2.5 KiB
2.5 KiB
Language / Язык: English | Русский
Web UI
Open https://localhost/ after make up (gateway).
Internal simulator port is 8080; the lab UI is also on that host.
The UI is a laboratory console for the vSphere simulator — not a vSphere Client replacement. It supports light and dark themes, catalog majors 6–9 (vSphere 7–8.0U2 floors), request/response editing, history, and runtime contract apply.
Features
- Endpoint tree and method selector driven by the selected catalog major
- Contract-derived parameters and example payloads
- Request editor, response viewer, and history
- Session login via
POST /api/session(Basic) →vmware-api-session-idheader/cookie - Environment summary (runtime version, hosts, VMs, clusters, datastores, networks)
- Curl / request previews
- Coverage meter for the implemented REST registry
- Apply as runtime hot-swap for the active major floor
- Demo / seed load (large / demo-cluster profiles)
- Compact console at
/console.html - Link to OpenAPI at
/docs
Auth (lab)
| User | Password | Role |
|---|---|---|
administrator@vsphere.local |
VMware1! |
Administrator |
readonly@vsphere.local |
VMware1! |
ReadOnly |
operator@vsphere.local |
VMware1! |
VirtualMachinePowerUser |
vmadmin@vsphere.local |
VMware1! |
VirtualMachineAdministrator |
After sign-in, Send attaches vmware-api-session-id automatically.
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/vsphere/seed?profile=… |
Reseed small / large / demo-cluster |
Version workflow
- Pick major 6 / 7 / 8 / 9 in the catalog.
- Inspect methods and coverage.
- Apply as runtime when you want live routes gated to that major’s floor.
- Confirm with
/api/appliance/system/versionand/ui/api/compatibility.
Hot-swap is memory-only; restart restores the default settings. 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.