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

58 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
**Language / Язык:** [English](../faq.md) | [Русский](faq.md)
# FAQ
## Это настоящий vCenter / ESXi?
Нет. Это симулятор API и состояния. Хосты, VM, datastores и сети —
устойчивые модели PostgreSQL, а не ESXi-хосты или процессы KVM/vmkernel.
## Вы действительно покрываете vSphere Automation API?
**Runtime** всегда обслуживает полную зарегистрированную route table (1077 маршрутов:
104 deep handlers + DB-backed stub surface для остальных) — см.
[Поверхность API](api-surface.md). **Catalog** majors 6–8 — намеренно
низкопокрытые исторические floors (2.9%9.6%); только major 9 (8.0 U2 / Automation
9.1 surface) объявлен как 100% в catalog. См.
[Версии API](api-versions.md) и [Совместимость](compatibility.md).
## Можно ли использовать это в CI для Terraform / Ansible / pyvmomi / custom clients?
Да. Это основной сценарий использования. Засейте профиль и направьте клиентов на
HTTPS gateway `:443` (REST `/api`/`/rest` или SOAP `/sdk`). См.
[Клиенты](clients.md).
## Почему некоторые NSX / Supervisor / vSAN / SAML calls «успешны» без remotes?
Эти области сохраняют **локальное, засеянное** состояние симулятора (см. таблицу
«Platform surfaces» в [Покрытие API](api-coverage.md)). Они намеренно не
обращаются к реальному NSX Manager, Tanzu Supervisor или IdP.
## Означает ли registry coverage perfect vSphere parity?
Это означает, что каждый зарегистрированный маршрут имеет устойчивый обработчик
или DB-backed stub и проходит verification suites проекта. Точное совпадение
краевых случаев с физическим ESXi-кластером может отличаться; используйте
`/ui/api/compatibility` и собственные client tests для certification claims.
## Где Web UI?
[https://localhost/](https://localhost/) после `make up` (gateway).
## Можно ли развернуть в Kubernetes?
Да. Используйте Helm chart в `helm/vmware-api-simulator` с опубликованным
образом Hub. Поддерживаются Ingress + cert-manager Let's Encrypt — см.
[Kubernetes / Helm](kubernetes.md).
## Что такое `ENABLE_PVE_STUB`?
Опциональная, выключенная по умолчанию legacy Proxmox VE `/api2/*` stub-плоскость,
унаследованная из общей platform lineage. Нативная vSphere REST/SOAP всегда
включена и является основной поверхностью проекта независимо от этого флага.
## Какие VM использует seed `small`?
`web-01`, `web-02`, `db-01`, `app-01`, `jumpbox` — см.
[Профили seed](seed-profiles.md).