5.7 KiB
Отчёт — лабораторная 2
- Автор, группа: Ромашко Владимир, БВТ2301
- Целевая оценка: 5, трек 1 — согласованность кэша
- Commit/PR: указать после публикации
- Источники и помощь ИИ: документация PostgreSQL, Redis, SQLAlchemy; использован ChatGPT
Запуск из чистого clone
Требуется Docker Desktop/Engine с Compose v2 и Python 3.9+.
Copy-Item .env.example .env
# Задать POSTGRES_PASSWORD в .env
docker compose up -d --build --wait --wait-timeout 120
python scripts/check_contract.py
python tests/smoke.py --base-url http://127.0.0.1:8080
docker compose exec -T api python -m unittest discover -s student-tests -v
python tests/resilience.py --mode persistence --base-url http://127.0.0.1:8080 --action-script scripts/restart.cmd
python student-tests/failures.py
python scripts/track1.py
Для Linux перед запуском: chmod +x scripts/restart.sh.
Остановка без удаления данных: docker compose down.
Удаление учебных volumes: docker compose down -v.
Архитектура и решения
Клиент → FastAPI → PostgreSQL и Redis.
PostgreSQL — источник истины для пользователей, чатов, участников и сообщений. SQLAlchemy ORM использует пул до 10 соединений, timeout пула 2 с, connect timeout 2 с, statement timeout 3 с.
Redis хранит сессии с TTL и кэш страниц истории. Включены AOF,
appendfsync always и именованный volume.
Пароли хешируются Argon2id. Basic используется только для создания сессии,
остальные защищённые запросы используют Bearer. X-User-Id игнорируется.
Миграции находятся в migrations/. Создание чата и участников выполняется
в одной транзакции. При создании сообщения версия истории увеличивается
в той же транзакции.
Ключ кэша истории содержит chat_id, версию истории, limit и cursor.
После записи старый ключ не используется. При ошибке кэша чтение выполняется
из PostgreSQL.
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | python tests/smoke.py |
PASS | evidence/track1-regression.txt |
| Сохранность после рестарта | tests/resilience.py |
Сессия и сообщения сохранены | evidence/track1-regression.txt |
| Миграции, ORM и транзакции | student-tests |
13 тестов OK; проверены rollback, гонка регистрации и повторные миграции | evidence/orm-tests.txt |
| Redis, TTL и отказы | student-tests/failures.py |
Redis/PostgreSQL возвращают 503 и восстанавливаются | evidence/track1-failures.txt |
| Индекс истории | python -m scripts.explain_history |
Index Scan по messages_history_idx на 10 000 сообщений |
evidence/explain.txt |
| Трек 1: stale read | python scripts/track1.py |
До защиты 5/5 stale read, после защиты 0/5 | evidence/cache-experiment.json |
| Трек 1: производительность | python scripts/track1.py |
SQL-команды: 600 без кэша и 300 с кэшем | evidence/cache-experiment.json |
| Трек 1: восстановление | python scripts/track1.py |
Redis перезапущен, read-after-write и logout сохранены | evidence/cache-restart.json |
Эксперименты и отказы
Гипотеза: версия истории в ключе Redis устранит stale read при позднем заполнении кэша.
Методика: 5 повторов управляемой конкурентной гонки; затем 3 серии по 300 чтений, concurrency 8, страница 100 сообщений, отдельный чат с 10 000 сообщениями.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|---|---|---|---|
| Конкурентная запись и чтение | Старый ключ не должен использоваться | 0/5 stale read после защиты | Не применимо |
| Redis stop/restart | Ошибка 503, затем восстановление | 503; сессия и сообщения доступны | 6.1 с, потери нет |
| PostgreSQL stop/start | Ошибка 503, затем восстановление | 503; API не доверяет анонимному запросу | 6.2 с, потери нет |
| Redis restart в треке 1 | Кэш восстановится из PostgreSQL | Read-after-write и logout прошли | 1.2 с, потери нет |
Ограничения и следующие шаги
Стенд рассчитан на один Docker-host и один экземпляр PostgreSQL/Redis. Cache stampede не исследовался. Нагрузочные результаты относятся к слою хранения, а не ко всему HTTP API.