55 lines
2.6 KiB
Markdown
55 lines
2.6 KiB
Markdown
# 14. Модель деплоя
|
||
|
||
## Назначение
|
||
Модель деплоя описывает запуск платформы в SaaS-режиме для нескольких tenants с общей frontend-сборкой и tenant-aware backend-конфигурацией.
|
||
|
||
## Поведение системы
|
||
- Одна frontend-сборка обслуживает несколько доменов.
|
||
- Tenant определяется на runtime по host.
|
||
- Backend/edge отдает соответствующий bootstrap и API конфигурацию.
|
||
- UI-режимы layout/widgets/footer/static pages переключаются только через bootstrap без перекомпиляции frontend.
|
||
|
||
## Обязательные параметры деплоя (JSON/env)
|
||
- supportedHosts
|
||
- defaultTenantPolicy
|
||
- apiGatewayBaseUrl
|
||
- bootstrapEndpoint
|
||
- observability (logs/metrics/traces)
|
||
|
||
## Опциональные параметры
|
||
- CDN policy
|
||
- региональные endpoint
|
||
- feature rollouts
|
||
- fallback tenant (только по утвержденной политике)
|
||
|
||
## Строгие правила
|
||
- Нельзя собирать отдельный frontend-бандл под каждый tenant как основной процесс.
|
||
- Нельзя использовать ручные правки frontend для запуска нового клиента.
|
||
- Деплой должен поддерживать zero-downtime обновления.
|
||
- Конфигурация окружений должна быть отделена от бизнес-данных tenants.
|
||
- В bootstrap и публичных API запрещено хранить секреты.
|
||
|
||
## Пример deployment-конфигурации (сокращенно)
|
||
```json
|
||
{
|
||
"environment": "production",
|
||
"supportedHosts": ["store-a.com", "store-b.com"],
|
||
"bootstrapEndpoint": "https://api.platform.com/bootstrap",
|
||
"apiGatewayBaseUrl": "https://api.platform.com",
|
||
"observability": {
|
||
"logs": true,
|
||
"metrics": true,
|
||
"traces": true
|
||
}
|
||
}
|
||
```
|
||
|
||
## Ответственность Frontend
|
||
- Корректно работать в multi-host режиме без перекомпиляции.
|
||
- Логировать runtime-ошибки tenant resolution/bootstrap.
|
||
|
||
## Ответственность Backend/DevOps
|
||
- Обеспечить маршрутизацию доменов на единый frontend runtime.
|
||
- Поддерживать tenant-aware конфигурацию на edge/API уровне.
|
||
- Обеспечить CI/CD с валидацией контрактов и smoke-тестами tenants.
|