83 lines
5.7 KiB
Markdown
83 lines
5.7 KiB
Markdown
# Отчёт — лабораторная 2
|
||
|
||
- Автор, группа: Ромашко Владимир, БВТ2301
|
||
- Целевая оценка: 5, трек 1 — согласованность кэша
|
||
- Commit/PR: указать после публикации
|
||
- Источники и помощь ИИ: документация PostgreSQL, Redis, SQLAlchemy; использован ChatGPT
|
||
|
||
## Запуск из чистого clone
|
||
|
||
Требуется Docker Desktop/Engine с Compose v2 и Python 3.9+.
|
||
|
||
```powershell
|
||
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.
|