Files
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

51 lines
2.7 KiB
Markdown

**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 / прочее | разное |