8.9 KiB
Лабораторная 2
Автор / группа: Тюнин Илья БВТ2303 Целевая оценка (3/4/5): 5 Трек 1, если заявлен: Трек 1 «Согласованность кэша» — при 32 конкурентных чтениях холодной страницы × 5 повторностей: 160 SQL-запросов истории в naive против 5 в protected (−96,9 %), read-after-write подтверждён, сессия и история переживают рестарт Redis
Что реализовано
- PostgreSQL 16.4 — источник истины:
users,chats,chat_members,messages; версионируемые миграции001_initial.sql,002_timestamp_precision.sql; rawpg.Poolс ограниченным пулом, connection/statement timeout и параметризованными запросами, без ORM. - Транзакционные границы: создание чата (валидация участников + chat + membership) и отправка сообщения (membership + insert +
message_version) — в одной транзакции с rollback; проверено отсутствие частичных данных. - Redis 7.4.2 с AOF — серверные Bearer-сессии с TTL, expiry и logout; одновременно версионированный кэш истории с lock на конкретную страницу
(chat_id, message_version, cursor, limit)и fallback в PostgreSQL при недоступности Redis. - Аутентификация по контракту lab2: Basic только на
POST /auth/sessions(UTF-8, первый:), Bearer на бизнес-endpoint,X-User-Idне аутентифицирует и не подменяет владельца, Argon2id, opaque-токен 256 бит. - Воспроизводимый стенд: Compose с pinned-образами, именованными volumes, healthchecks, сервисом миграций перед API, конфигурацией через
.env. - Наблюдаемость: token-gated
GET /internal/metricsиPOST /internal/metrics/reset— SQL-метки, операции Redis, cache hit/miss/lock wait, session get/set/del, request count, агрегаты латентности; деградации кэша и зависимостей пишутся счётчиками иwarn-логами, а не проглатываются. - Перенесено из lab1 с объявленным переходом: health, регистрация/пользователи, чаты и участники, сообщения, keyset-пагинация — переведены на новую аутентификацию.
Подробности решения — REPORT.md (архитектура, схема, транзакции, политика кэша, команды, ограничения).
Проверки уровня 3/4 — evidence/level3-4-verification.md.
Трек 1 — evidence/track1-cache-consistency.md и evidence/track1-explain.md.
Навигация по доказательствам — evidence/README.md.
Ручной клиент для разбора API — bruno/README.md.
Команды запуска из чистого clone
cp .env.example .env
password=$(openssl rand -hex 32)
sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$password/" .env
sed -i "s|^DATABASE_URL=.*|DATABASE_URL=postgresql://messenger:$password@postgres:5432/messenger|" .env
sed -i "s/^METRICS_TOKEN=.*/METRICS_TOKEN=$(openssl rand -hex 16)/" .env
unset password
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build # postgres/redis healthy, migrate exit 0, api healthy
curl -fsS http://localhost:8080/health/ready
Пояснения по переменным и паролю существующего volume — .env.example и REPORT.md § «Конфигурация и секреты».
Результаты проверок (фактический вывод)
make check PASS
make validate PASS
make test BASE_URL=http://localhost:8080 PASS: lab2 public API scenario
make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS: preserved confirmed data and existing session
(cd app && npm run build) PASS
(cd app && npm test) 5 files, 13 tests passed
(cd app && npx tsc --noEmit) PASS
integration suite (реальные PostgreSQL/Redis) 7 passed | 1 skipped
то же с SESSION_TTL_SECONDS=2 8 passed (expiry → 401)
коллекция Bruno (bru run -r --env local) 28 запросов, 56 проверок — все зелёные
Трек 1 (32 конкурентных GET × 5 повторностей, CACHE_MISS_DELAY_MS=75):
| Режим | SQL messages.history |
Cache hits | Ошибок | p50, мс |
|---|---|---|---|---|
| naive | 160 | 0 | 0 | ≈ 89 |
| protected | 5 | 155 | 0 | ≈ 20 |
Отдельно проверены: гонка одинакового username (201 + 409, в таблице ровно 1 строка, unique-индекс), rollback при неизвестном участнике чата (400, строк не осталось), отказы Redis и PostgreSQL (/health/ready 503, анонимный доступ не выдаётся, процесс API жив, после старта — 200 с тем же токеном), EXPLAIN (ANALYZE, BUFFERS) на 10 002 сообщениях (Index Scan по messages_chat_created_id_idx, keyset-предикат в Index Cond).
- Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- Контракт и публичные тесты не ослаблены (
contracts/иtests/не изменялись). make checkиmake testвыполнены; приложен реальный вывод (выше и в evidence).- Сценарии отказов/безопасности своего уровня воспроизведены (отказы Redis/PostgreSQL, expiry, logout/replay, spoofing, rollback — журнал).
- Все секреты и приватные ключи находятся вне Git:
.envи локальные секреты покрыты.gitignore, в отчёте и evidence нет токенов и паролей. - README задания сохранён,
REPORT.mdсодержит инструкцию именно этого решения.
Ограничения / известные ошибки
- Метрики локальны процессу API и сбрасываются при его рестарте; при нескольких репликах их нельзя суммировать как распределённый снимок.
- Измерения трека 1 — closed-loop на одном хосте (32 конкурентных читателя, 5 повторностей): это не production-пропускная способность.
redis-dataхранит действующие сессии: удаление volume осознанно разлогинивает пользователей; AOF плюс сохранённый volume — проверенная граница durability.CACHE_MODE=naiveиCACHE_MISS_DELAY_MSпредназначены только для эксперимента и задаются переменными окружения при пересоздании контейнераapi(например,CACHE_MODE=naive CACHE_MISS_DELAY_MS=75 docker compose --env-file .env up -d api); задержка влияет только на naive-путь.- Порты PostgreSQL/Redis наружу не публикуются, поэтому интеграционный набор запускается с адресами контейнеров (команда в REPORT.md § «Команды проверок»).
- Сырые прогоны бенчмарка не коммитятся (локальные идентификаторы); их хеши — в
evidence/track1-cache-consistency.md§8.