Files

5.2 KiB
Raw Permalink Blame History

Лабораторная 3

  • Автор / группа: Антонова Екатерина
  • Целевая оценка (3/4/5): 3
  • Трек 5: не заявлен
  • Использованные источники и помощь ИИ: задание лабораторной 3, COURSE.md, contracts/openapi.json, contracts/README.md, contracts/infrastructure.json, публичные тесты из tests/ и реализация лабораторной 2. Также использовалась официальная документация Docker Compose, PostgreSQL и Nginx. ИИ применялся как вспомогательный инструмент для проверки изменений и подготовки отчёта.

Что реализовано

Перенесены пользователи, чаты, участники, сообщения, PostgreSQL, миграции, Argon2id и Bearer-сессии из lab2. Добавлены две взаимозаменяемые API-реплики (api1, api2), Nginx как единственная публичная точка входа, проверки готовности и заголовок X-Instance-Id. Сессии, сообщения и идемпотентность хранятся в общей PostgreSQL. Повтор сообщения с одинаковым Idempotency-Key защищён уникальным ключом и транзакцией PostgreSQL; при конкурентном повторе возвращается тот же message ID.

Миграция 001_initial.sql создаёт основные таблицы, а 002_idempotency.sql создаёт общее хранилище ключей. Миграции запускаются отдельным одноразовым сервисом migrate до API-реплик и безопасны при повторном запуске.

Запуск из чистого clone

Требуется Docker Desktop с Compose:

cp .env.example .env
# замените POSTGRES_PASSWORD в .env на локальное значение
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
curl --fail http://localhost:8080/health/ready
make check
make validate
make test

Публичный порт есть только у load_balancer; api1, api2 и PostgreSQL доступны только во внутренней сети Compose. Для остановки одной реплики:

chmod +x scripts/restart.sh scripts/stop-one.sh
TARGET_INSTANCE_ID=api1 ./scripts/stop-one.sh
docker compose start api1

Для штатного теста отказа:

make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh

Удаление учебных данных выполняется только намеренно: docker compose down -v.

Доказательства критериев уровня 3

Критерий Команда / сценарий Результат
Контракт make check PASS
Compose и инфраструктура docker compose --env-file .env config --quiet PASS
Публичный API make test PASS: lab3 public API scenario
Две реплики docker compose ps, ответы smoke api1 и api2 healthy; ответы содержат разные X-Instance-Id
Общие сессии и данные перезапуск postgres, api1, api2, load_balancer без -v прежний Bearer и сообщение сохранились
Идемпотентность 20 параллельных POST с одним ключом 20 ответов, 1 уникальный message ID
Отказ API docker compose stop api1, затем make test smoke продолжил проходить через api2

В Windows tests/resilience.py не может запустить Unix-файл .sh напрямую через Popen (WinError 193). Поэтому локально отказ и сохранность были проверены эквивалентными командами Docker Compose; в Linux/CI hooks запускаются напрямую после chmod +x.

Архитектура и ограничения

Nginx распределяет запросы между api1 и api2 без sticky sessions. PostgreSQL volume является источником истины для пользователей, членства, сообщений, сессий и idempotency records. Остановка одной API-реплики не останавливает БД или вторую реплику; во время обнаружения отказа возможны краткие 502/таймауты, после чего Nginx направляет запросы на оставшуюся реплику. Отказ PostgreSQL, Docker host и высокодоступность самой БД в этой лабораторной не исследовались. Redis/Valkey и возможности уровня 4/5 не заявляются.