6.3 KiB
6.3 KiB
Отчёт — лабораторная 2
- Автор, группа: Соболев Даниил Романович, БПИ2302
- Целевая оценка; выбранный трек 5, если нужен: 4
- Commit/PR:
3c5af42f24 - Использованные источники, библиотеки и помощь ИИ: FastAPI, Uvicorn, Pydantic, psycopg3+pool, redis-py, argon2-cffi; контракт курса; помощь ИИ при переносе на PostgreSQL/сессии/Redis
Запуск из чистого clone
Prerequisites: Docker / Docker Compose; Python 3.9+ для make test / make test-own (stdlib).
cp .env.example .env
# Windows:
powershell -File scripts/make_secrets.ps1
# Unix:
# sh scripts/make_secrets.sh
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
Ожидание готовности: GET http://localhost:8080/health/ready → {"status":"ok"} (миграции применяются при старте API).
make test
# Windows: py -3 tests\smoke.py --base-url http://localhost:8080
make test-own
# Unix / Git Bash:
# chmod +x scripts/restart.sh && make test-persistence ACTION_SCRIPT=scripts/restart.sh
# Windows (cmd):
py -3 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://localhost:8080
Проверка expiry (отдельный прогон с коротким TTL):
# SESSION_TTL_SECONDS=5 в env-файле, затем recreate api и:
# SESSION_TTL_SECONDS=5 py -3 tests\own.py
# или: py -3 scripts\test_expiry_raw.py
EXPLAIN индекса истории (≥10 000 сообщений):
# из secrets/database_url заменить хост postgres → 127.0.0.1
set DATABASE_URL=postgresql://messenger:PASSWORD@127.0.0.1:15432/messenger
set CACHE_URL=redis://127.0.0.1:6379/0
py -3 scripts/explain_messages.py
# результат: evidence/explain.txt
Безопасная остановка (volumes сохраняются):
docker compose --env-file .env stop
# или down без -v
docker compose --env-file .env down
Намеренное удаление учебных данных:
docker compose --env-file .env down -v
Версии: python:3.12.7-slim-bookworm, postgres:16.4-bookworm, redis:7.4.1-bookworm; зависимости в requirements.txt.
Архитектура и решения
Клиент → API (FastAPI) → PostgreSQL (источник истины: users/chats/members/messages)
→ Redis (opaque Bearer-сессии, TTL + AOF everysec)
- Перенос из lab1: контракт users/chats/messages, keyset-cursor, формат ошибок, non-root Dockerfile, X-Request-Id.
- Изменения lab2:
password+ Argon2id;POST /auth/sessions(Basic); Bearer вместоX-User-Id; сессии в Redis. - Источник истины данных: PostgreSQL. Сессии — Redis (единственное хранилище сессий) с AOF, чтобы переживать
compose restart. - Транзакции: создание чата =
INSERT chats+INSERT chat_membersв одной транзакции; при неизвестном участнике — rollback. - Пул/таймауты:
psycopg_pool.ConnectionPool(min/max),connect_timeout; Redissocket_connect_timeout/socket_timeout. - Индекс истории:
messages (chat_id, created_at, id)под keysetWHERE chat_id=$1 AND (created_at,id)>($2,$3) ORDER BY created_at,id LIMIT n. - Ready: live = процесс; ready = accepting + ping Postgres + ping Redis.
- Конфиг:
.env+ secret-файлыDATABASE_URL_FILE/CACHE_URL_FILE(см..env.example).
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | make test |
PASS: lab2 public API scenario | evidence/smoke.txt |
| Persistence + сессия | make test-persistence ACTION_SCRIPT=scripts/restart.sh |
PASS: token и сообщение после restart | evidence/persistence.txt |
| Собственные тесты 4 | make test-own |
wrong password, logout, race username, concurrency, redis-down | evidence/own.txt |
| Expiry короткого TTL | SESSION_TTL_SECONDS=2 + make test-own |
401 после TTL | evidence/own.txt |
| EXPLAIN ≥10k | scripts/explain_messages.py |
Index Scan по messages_chat_created_id_idx |
evidence/explain.txt |
| Миграции идемпотентны | повторный up / restart API |
без дублей schema_migrations | логи API |
Эксперименты и отказы
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|---|---|---|---|
scripts/restart.sh (API+Postgres+Redis, volumes) |
те же данные и Bearer | persistence PASS | до готовности ≤90 с; без потери при сохранённых volumes |
docker compose stop redis |
ready 503; нет анонимного доступа | own redis-down PASS | после start redis ready снова ok |
| Гонка 8× одинаковый username | 1×201 + 7×409 | own username race PASS | без дублей username |
| 10×10 POST сообщений | 100 уникальных | own concurrency PASS | без потери подтверждённых |
Ограничения измерения: closed-loop smoke/own на localhost; tests/load.py — throughput HTTP-подтверждений, не точный счётчик COMMIT.
Ограничения и следующие шаги
- Один Docker-host: нет HA Postgres/Redis/API.
- Сессии только в Redis: flush/AOF-сбой без Postgres-backup сессий = повторный login (данные чатов в PG сохраняются).
- Нет lab3 LB/идемпотентности, вложений, TLS.
- Следующий шаг курса: горизонтальное масштабирование и общий session store.