5.2 KiB
Лабораторная 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 не
заявляются.