Files

T

inecs f8d3cbdd59 Initial commit: VMware vSphere API simulator scaffold.

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.

2026-07-18 04:42:11 +03:00

3.9 KiB

Raw Blame History

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

Web UI

Откройте https://localhost/ после make up (gateway). Внутренний порт симулятора — 8080; лабораторный UI также доступен на этом хосте.

UI — это лабораторная консоль для симулятора vSphere, а не замена vSphere Client. Она поддерживает светлую и тёмную темы, мажоры каталога 6–9 (уровни vSphere 7–8.0U2), редактирование запроса/ответа, историю и применение runtime-контракта.

Возможности

Дерево endpoint'ов и селектор метода, управляемые выбранным мажором каталога
Параметры и примеры payload, производные от контракта
Редактор запроса, просмотрщик ответа и история
Вход в сессию через POST /api/session (Basic) → заголовок/cookie vmware-api-session-id
Сводка окружения (версия runtime, хосты, ВМ, кластеры, datastore, сети)
Предпросмотр запросов в виде curl
Индикатор покрытия для реализованного реестра REST
Hot-swap Apply as runtime для активного уровня мажора
Загрузка demo / seed (профили large / demo-cluster)
Компактная консоль на /console.html
Ссылка на OpenAPI по адресу /docs

Аутентификация (лаборатория)

Пользователь	Пароль	Роль
`administrator@vsphere.local`	`VMware1!`	Administrator
`readonly@vsphere.local`	`VMware1!`	ReadOnly
`operator@vsphere.local`	`VMware1!`	VirtualMachinePowerUser
`vmadmin@vsphere.local`	`VMware1!`	VirtualMachineAdministrator

После входа кнопка Send автоматически прикладывает vmware-api-session-id.

Вспомогательные методы backend

Метод	Path	Назначение
GET	`/ui/api/versions`	Мажоры каталога в сравнении с 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`	Hot-swap runtime-контракта
GET	`/ui/api/demo/state`	Состояние демо-набора данных
POST	`/ui/api/demo/load`	Загрузить `demo-cluster`
POST	`/ui/api/vsphere/seed?profile=…`	Reseed `small` / `large` / `demo-cluster`

Workflow работы с версиями

Выберите мажор 6 / 7 / 8 / 9 в каталоге.
Изучите методы и покрытие.
Используйте Apply as runtime, когда нужно, чтобы живые маршруты были ограничены уровнем этого мажора.
Подтвердите через /api/appliance/system/version и /ui/api/compatibility.

Hot-swap хранится только в памяти; перезапуск восстанавливает настройки по умолчанию. Подробности: Версии API.

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

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

3.9 KiB Raw Blame History Unescape Escape