docs(report): document session revocation limit on Redis failure

This commit is contained in:
kk10
2026-10-20 22:07:06 +03:00
parent fb97bf7d34
commit fa9562a05e
+6 -2
View File
@@ -60,7 +60,7 @@ docker compose down -v
Схема: клиент → `load_balancer` (Nginx, единственная публичная точка входа, `127.0.0.1:8080`) → `api` × `API_REPLICAS` (по умолчанию 2) → `redis` (кэш сессий) и `postgres` (источник истины). Одноразовый `migrate` (goose) выполняется до старта API; реплики миграции не запускают. Порты API и Redis наружу не публикуются. Порт PostgreSQL открыт только на `127.0.0.1` для тестов с хоста.
Источник истины - PostgreSQL. API не хранит локального состояния: сессии доступны всем репликам через общее хранилище, режим выбирается переменной `SESSION_STORE` (`postgres` | `redis`). Все проверки и эксперименты lab3 выполнены с `SESSION_STORE=redis`: Redis хранит кэш сессий с TTL = min(60 с, оставшийся срок сессии), при промахе или недоступности Redis сессия читается из PostgreSQL. Разные запросы одного пользователя обслуживаются разными репликами без повторного входа. Sticky session не используются.
Источник истины - PostgreSQL. API не хранит локального состояния: сессии доступны всем репликам через общее хранилище, режим выбирается переменной `SESSION_STORE` (`postgres` | `redis`). Все проверки и эксперименты lab3 выполнены с `SESSION_STORE=redis`: Redis хранит кэш сессий с TTL = min(60 с, оставшийся срок сессии), при промахе или недоступности Redis сессия читается из PostgreSQL. Инвалидация кэша: при logout сессия удаляется из PostgreSQL, затем ключ из Redis; сбой удаления ключа логируется и не отменяет logout, устаревший ключ истекает по TTL. Разные запросы одного пользователя обслуживаются разными репликами без повторного входа. Sticky session не используются.
Идемпотентность отправки сообщения общая для всех реплик и хранится в PostgreSQL: таблица `idempotency_keys`, область ключа - пользователь + метод + путь чата + `Idempotency-Key`. Проверка ключа и вставка сообщения выполняются в одной транзакции в `MessageService`. Повтор с тем же ключом и телом возвращает исходный результат без дубля, в том числе при конкурентных запросах через разные реплики; тот же ключ с другим телом даёт `409`.
@@ -150,7 +150,11 @@ RPS в таблицах считается по успешным ответам
**Выдерживается:** отказ одной реплики из двух, замена реплик под нагрузкой, повтор POST без дубля (`Idempotency-Key`), перезапуск стенда без потери данных.
**Не выдерживается или не реализовано:** отказ PostgreSQL, Redis или Nginx (по одному экземпляру); проверки Nginx пассивные, окно обнаружения отказа до ~3 с; повтор POST Nginx делает только до передачи запроса реплике.
**Не выдерживается или не реализовано:**
- Отзыв сессии при сбое Redis. Logout удаляет сессию из PostgreSQL (источник истины), затем ключ из Redis. Если Redis недоступен, ошибка логируется, logout возвращает 204, а прежний токен может приниматься до истечения кэша (до 60 с). Окно не закрыто: для этого нужна проверка сессии в БД на каждый запрос, но тогда кэш теряет смысл.
- Отказ PostgreSQL, Redis или Nginx (по одному экземпляру).
- Проверки Nginx пассивные, окно обнаружения отказа до ~3 с.
- Повтор POST Nginx делает только до передачи запроса реплике.
**Ограничения измерений:**
- Генератор и стенд на одной машине делят CPU; при 20 воркерах потолок генератора около 1600 RPS.