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
commit f8d3cbdd59
422 changed files with 361335 additions and 0 deletions
@@ -0,0 +1,50 @@
+**Language / Язык:** [English](../ports.md) | [Русский](ports.md)
+
+# Порты vCenter в этом симуляторе
+
+Справочник: [vSphere Networking Ports](https://ports.esp.vmware.com/) (vCenter Server).
+
+`api-gateway` (nginx) публикует **основной HTTPS-listener vCenter** плюс
+HTTP-грань для лабораторных нужд. Каждый опубликованный порт проксирует к
+одному и тому же процессу FastAPI, который сам маршрутизирует по path REST
+(`/api`, `/rest`) и SOAP (`/sdk`) — отдельного порта на протокол нет. Gateway
+также выставляет `X-VMware-Service` / `X-Forwarded-Port`, чтобы клиенты и
+будущие роутеры могли определить, какой порт был использован.
+
+## Опубликовано через Compose (`api-gateway`)
+
+| Сервис | Порт контейнера | Порт хоста (dev compose) |
+|---|---:|---:|
+| HTTP-грань для лабораторных нужд | 80 | 80 |
+| vCenter HTTPS (основная точка входа UI/API) | 443 | 443 |
+
+Порты хоста совпадают с реальными defaults vCenter, чтобы удалённые клиенты
+ходили на `https://<host>/` и `http://<host>/` без нестандартного порта.
+При необходимости переопределяйте в release compose через `HTTP_PORT` /
+`HTTPS_PORT`.
+
+Также публикуется Compose (не через gateway):
+
+| Сервис | Порт хоста (dev compose) |
+|---|---:|
+| PostgreSQL | `5434` (только localhost) |
+
+Внутренний процесс симулятора (не публикуется на хост): `8080`.
+
+## Раскладка путей на HTTPS
+
+| Поверхность | Префикс пути | Статус |
+|---|---|---|
+| vSphere REST | `/api/…`, `/rest/…` | реализовано (базовый инвентарь + сессия) |
+| SOAP / VIM SDK | `/sdk` | реализовано (подмножество RetrieveServiceContent / Login / RetrieveProperties) |
+| HttpNfcLease / NFC | `/nfc/…` | lab transfer handshake на том же HTTPS-слушателе |
+| Лабораторная консоль | `/` | да |
+| Health | `/health/live`, `/health/ready` | да |
+
+## Задокументировано, но пока не опубликовано
+
+| Сервис | Порты |
+|---|---|
+| VAMI / управление appliance | 5480 |
+| Управление хостом ESXi (если будет симулировано позже) | 443 (отдельный хост) |
+| Syslog / прочее | разное |