forked from mtusi2026/mtusi2026lab3
9.1 KiB
9.1 KiB
Отчёт — лабораторная 3
- Автор, группа: Антонова Ирина Андреевна, БПИ2301.
- Целевая оценка: 4; Compose + Nginx, две API-реплики.
- Commit/PR:
- Использованные источники, библиотеки и помощь ИИ: FastAPI, SQLAlchemy async, asyncpg, Pydantic, Uvicorn, redis-py; первоначальная lab2 подготовлена с Claude, перенос и проверки lab3 — с Codex. Основа: исправленная lab2 (отзыв после рестарта API и диапазон времени cursor сохранены).
Запуск из чистого clone
Для запуска и проверки стенда выполните следующие команды:
cp env.lab3.template .env
# Откройте .env и установите случайный POSTGRES_PASSWORD.
docker compose --env-file .env up -d --build
python3 scripts/replicas.py restore
python3 tests/smoke.py --base-url "http://localhost:8080"
docker compose --env-file .env --profile test run --rm --build tests
python3 scripts/lab3_evidence.py --base-url "http://localhost:8080"
Требования и роли компонентов:
- LB (nginx):
nginx:1.28.0-alpine, единственный опубликованный host-порт127.0.0.1:8080. - API (
api-a,api-b): Python 3.12.8, FastAPI + Uvicorn, подключены к edge и internal сетям без публикации портов наружу. - БД (
db):postgres:16.6-bookworm, данные хранятся в именованном томеpgdata. - Кэш (
redis):redis:7.4.1-bookworm, persistence отключена, потеря кэша допустима.
Для безопасной остановки стенда с сохранением данных (включая pgdata):
docker compose --env-file .env stop
Команда для полного удаления учебных данных (включая тома):
docker compose --env-file .env down -v
Архитектура и решения
- Источник истины: общая реляционная база данных PostgreSQL, где хранятся пользователи, чаты, сообщения и сессии. Сессии проверяются через БД, что исключает рассинхронизацию между репликами.
- Балансировка и отказоустойчивость: Nginx распределяет трафик между двумя репликами (
api-a,api-b) по алгоритму Round Robin без sticky session. Пользовательские запросы сопровождаются уникальным заголовкомX-Instance-Id. - Идемпотентность: Реализована для эндпоинта отправки сообщений (
POST /api/v1/chats/{chat_id}/messages) с помощью заголовкаIdempotency-Keyи транзакционных advisory locks в PostgreSQL. - Что перенесено из lab2: базовая бизнес-логика мессенджера, логика отзывов сессий и фильтрация по курсорам времени. Что изменено: добавлена поддержка двух реплик, встроенный скрипт health controller в Nginx, таблица
message_requestsдля общей идемпотентности и автоматические сценарии отказоустойчивости (failover и rolling update).
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | python3 tests/smoke.py --base-url "http://localhost:8080" |
Успешно пройдено через Nginx LB | evidence/lab3 |
| Остальные пункты уровня 3 | python3 scripts/lab3_evidence.py |
12 параллельных запросов с одинаковым ключом обработаны корректно (1 unique message, 409 conflict на дубликаты); последовательный отказ api-a и api-b пройден с нулевым уровнем ошибок[cite: 4, 5, 8] | evidence/lab3/05_concurrent_idempotency.json, evidence/lab3/06_failover_*.json |
| Все пункты уровня 4 | python3 scripts/lab3_evidence.py --base-url "http://localhost:8080" |
Успешная замена обеих реплик под нагрузкой (rolling update без потери данных и сессий), а также проверка persistence с прежним токеном[cite: 6, 7] | evidence/lab3/08_rolling_*.json, evidence/lab3/09_persistence.txt |
| Выбранный трек 5, если заявлен | Не заявлен | — | — |
Эксперименты и отказы
Нагрузочные тесты выполнялись в режиме closed-loop с 2 клиентами в локальном Docker-стенде (ограничения ресурсов: по 0.5 CPU / 256 MiB на API-контейнер, 1.0 CPU / 512 MiB на PostgreSQL).
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|---|---|---|---|
Отказ api-a (остановка контейнера hook-скриптом) |
Переключение трафика на api-b, отсутствие ошибок у клиента благодаря retry и тайм-аутам |
24/24 успешных попыток (0 ошибок), RPS ~0.97, подтвержденных сообщений: 13, дубликатов: 0[cite: 5] | Первое чтение восстановилось через 7.19 с, первая запись — через 9.25 с[cite: 5]; потери данных нет. |
Отказ api-b (остановка контейнера hook-скриптом) |
Переключение трафика на api-a, непрерывность сессий |
24/24 успешных попыток (0 ошибок), RPS ~0.97, подтвержденных сообщений: 13, дубликатов: 0[cite: 4] | Первое чтение восстановилось через 7.25 с, первая запись — через 9.34 с[cite: 4]; потери данных нет. |
Поочерёдное обновление реплик (rolling update) под нагрузкой |
Бесшовное пересоздание контейнеров без потери входящих запросов | 28/28 успешных попыток в каждом прогоне (0 ошибок, error_ratio: 0.0), дубликатов: 0[cite: 6, 7] |
Сессии и история сохранены, замена прошла штатно. |
Ограничения измерения: Замеры производились на одном локальном хосте под управлением Docker Desktop, поэтому абсолютные значения latency и RPS отражают производительность локального окружения, а не предельную нагрузочную способность продакшн-системы.
Ограничения и следующие шаги
- Что выдерживается: Отказ одного из процессов API (процесс завершается с кодом 0/exited), кратковременные сетевые сбои, повторные сетевые запросы с тем же
Idempotency-Keyв пределах 24 часов. - Что не выдерживается / учебные упрощения: Падение всего узла (host), отказ общей базы данных PostgreSQL (так как она является единой точкой отказа), а также смешанный rolling update со старыми версиями приложений из-за изменения контракта API в lab3.
- Следующие шаги: Вынесение базы данных в отказоустойчивый кластер (Master-Slave), добавление внешнего Redis-кластера с persistent-хранением сессий для полноценного масштабирования за пределы одного Docker-хоста.