Initial commit: stateful OpenStack API laboratory simulator.

Ship Keystone auth, multi-service handlers (Yoga→Dalmatian), Compose/Helm packaging, API contract packs, and pytest/Pulumi coverage labs.
2026-07-18 04:26:48 +03:00
commit 6033967e6a
509 changed files with 464404 additions and 0 deletions
@@ -0,0 +1,59 @@
+**Language / Язык:** [English](../configuration.md) | [Русский](configuration.md)
+
+# Конфигурация
+
+## Переменные окружения
+
+| Переменная | По умолчанию | Назначение |
+|---|---|---|
+| `APP_HOST` | `0.0.0.0` | Адрес привязки |
+| `APP_PORT` | `8080` | Внутренний порт FastAPI (не публичный порт Keystone) |
+| `DATABASE_URL` | (compose/helm) | PostgreSQL DSN |
+| `TICKET_SIGNING_KEY` | lab secret | Материал подписи токенов (ротируйте в общих лабораториях) |
+| `LOG_LEVEL` | `INFO` | Уровень логирования |
+| `OPENSTACK_SERIES` | `dalmatian` | Серия contract-пакета при холодном старте |
+| `REQUEST_ID_HEADER` | `X-Request-ID` | Заголовок корреляции запросов |
+| `SEED_PROFILE` | `minimal` | Для `seed_cli` / Helm seed Job (`minimal` / `demo`) |
+
+## Compose
+
+| Файл | Роль |
+|---|---|
+| `docker-compose.yml` | Dev-стек (build + bind mounts) |
+| `docker-compose.release.yml` | Опубликованный Hub-образ |
+| `.env` / `.env.example` | Локальные переопределения |
+
+Сервисы:
+
+- **simulator** — FastAPI на внутреннем `8080`
+- **api-gateway** — nginx, публикующий реальные порты API OpenStack 1:1 ([ports.md](ports.md))
+- **postgres** — `postgres:17.5-bookworm` на хосте `127.0.0.1:5433`
+
+## Helm
+
+См. [kubernetes.md](kubernetes.md) и
+[`helm/openstack-api-simulator/values.yaml`](../../helm/openstack-api-simulator/values.yaml).
+
+Важные параметры:
+
+| Value | Назначение |
+|---|---|
+| `gateway.enabled` | Multi-port nginx (по умолчанию `true`) |
+| `config.openstackSeries` | Env `OPENSTACK_SERIES` |
+| `seed.profile` | `minimal` / `demo` |
+| `postgresql.enabled` | Встроенная БД |
+| `secret.ticketSigningKey` | Нужно ротировать для общих кластеров |
+
+## Contract-пакеты
+
+Расположение: `contracts/openstack/<series>/`.
+
+В каждой серии — per-service пакеты `api.json`, потребляемые schema-движком.
+Специализированные роутеры (Keystone, Nova, Neutron, …) остаются stateful для happy-path'ов.
+
+## Переопределения Web UI
+
+Environment drawer → **OpenStack API pack**:
+
+- Активация серии (hot remount)
+- Переопределение microversion по сервисам