Files
mtusi2026lab3-fork/REPORT.md
T
2026-11-02 20:05:33 +03:00

9.1 KiB
Raw Blame History

Отчёт — лабораторная 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-хоста.

Первичные источники