7.8 KiB
Отчёт — лабораторная 3
- Автор, группа: Вотчицева Вероника, БВТ2302
- Целевая оценка; выбранный трек 5, если нужен: 4 (трек 5 не заявлялся)
- Commit/PR: ТУТ_ССЫЛКА_НА_PR
- Использованные источники, библиотеки и помощь ИИ:
- Python 3.12, FastAPI, SQLAlchemy (asyncpg), Redis, HAProxy, PostgreSQL.
- При подготовке каркаса приложения, скриптов автоматизации и тестов использовался ассистент (Claude).
Запуск из чистого clone
Prerequisites: Docker Desktop с плагином Compose V2 (с поддержкой флага --wait), Python 3.9+ для запуска проверочных скриптов.
# 1. Подготовка окружения
Copy-Item .env.example .env
docker compose config --quiet
# 2. Запуск стенда (сборка, миграции, запуск БД, Redis, 2 API и HAProxy)
docker compose up -d --build --wait --wait-timeout 120
# 3. Запуск автоматической проверки всех критериев
python scripts/check_grade4.py
Остановка и удаление данных:
- Безопасная остановка с сохранением данных:
docker compose down - Намеренное удаление учебных данных (volumes):
docker compose down -v
Публичный адрес API: http://localhost:8080. Проверка готовности: /health/ready.
Архитектура и решения
Веб-трафик поступает на HAProxy (единственная публичная точка входа), который распределяет запросы по двум независимым репликам API (api1 и api2) по алгоритму round-robin. Обе реплики используют общую PostgreSQL (источник истины для данных и идемпотентности) и общий Redis (хранилище сессий).
Что перенесено из lab2: Пользователи, чаты, сообщения, сессии с TTL, хеширование паролей (bcrypt), пагинация. Что изменено и добавлено:
- Горизонтальное масштабирование: Запущены две реплики API за HAProxy. Прямые порты API наружу не проброшены.
- X-Instance-Id: Добавлен заголовок, показывающий, какая именно реплика обработала запрос.
- Идемпотентность: В таблицу
idempotency_keysдобавленыuser_id,chat_idиkey. ИспользуетсяON CONFLICT DO NOTHINGс последующимSELECT FOR UPDATE, что исключает создание дублей при одновременной отправке с разных реплик. - Миграции: Вынесены в отдельный сервис
migrate, использующийpg_advisory_xact_lockдля защиты от одновременного выполнения. - Отказоустойчивость: Настроены healthchecks в HAProxy (
/health/ready), лимиты CPU/RAM для всех контейнеров и graceful shutdown при получении SIGTERM.
Соответствие .env.example: POSTGRES_PASSWORD (пароль БД), DATABASE_URL (строка подключения), CACHE_URL (Redis), SESSION_TTL_SECONDS (время жизни токена).
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | python tests/smoke.py |
PASS: lab3 public API scenario |
evidence/smoke.txt |
| Остальные пункты уровня 3 (2 реплики, LB) | python student-tests/run.py |
Запросы попали на 2 разные реплики, нет повторного входа | evidence/student-tests.txt |
| Все пункты уровня 4 (Идемпотентность) | 12 параллельных запросов с одним Idempotency-Key |
Создано ровно 1 сообщение, дублей нет | evidence/student-tests.txt |
| Все пункты уровня 4 (Отказ реплик) | python scripts/check_grade4.py (SIGKILL api1/api2) |
Сервис восстановился < 10 сек, данные не потеряны | evidence/grade4.json |
| Persistence (сохранность) | python tests/resilience.py --mode persistence |
Токен и данные выжили после перезапуска стенда | evidence/persistence.txt |
| Rolling Update (поочередная замена) | python scripts/check_grade4.py |
Замена контейнеров без прерывания трафика | evidence/grade4.json |
Эксперименты и отказы
Испытания проводились скриптом check_grade4.py на локальной машине (Linux/Windows, Docker). Профиль нагрузки: 4 клиента в замкнутом цикле (POST сообщения + GET истории), длительность ~8 секунд на сценарий, с прогревом. Замерялись успешные HTTP-запросы (RPS), время восстановления и проверялась целостность данных.
| Воздействие | Что ожидали | Что наблюдали | Время восстановления / потеря данных |
|---|---|---|---|
SIGKILL api1 |
Падение одной реплики, перевод трафика на api2 | ~190 RPS, 2 ошибки за время детекта, HAProxy убрал api1 из пула | 0.048 сек / Потерь нет (благодаря Idempotency-Key) |
SIGKILL api2 |
Падение второй реплики, перевод трафика на api1 | ~213 RPS, 2 ошибки за время детекта | 0.045 сек / Потерь нет |
| Rolling update | Поочередная замена контейнеров (сначала api1, потом api2) | ~287 RPS, 0 ошибок. Трафик ни разу не прервался | 2.470 сек (время замены) / Потерь нет |
Ограничения и следующие шаги
- Выдерживаемые отказы: Стенд успешно справляется с отказом одного процесса API (контейнера). HAProxy перекидывает трафик на живую реплику.
- Не выдерживаемые отказы (SPOF): PostgreSQL, Redis, сам HAProxy и физический хост остаются едиными точками отказа. Если упадёт БД, сервис вернёт 503.
- Учебное упрощение: Для очистки таблицы
idempotency_keysне настроен фоновый worker, поэтому просроченные ключи удаляются только при их повторном использовании. При огромном потоке уникальных запросов таблица будет расти. - Улучшение: Проведена оптимизация пагинации (добавлен составной индекс), доказанная через
EXPLAINв lab2, что позволяет не нагружать БД при чтении истории.