Files
mtusi2026lab3/REPORT.md
T
PoRATL e0e1a1e6c1 Добавить балансировку и идемпотентность для лабораторной 3.
Две реплики API за HAProxy, общий PostgreSQL и повтор сообщения без дубля.
2026-11-13 07:30:46 +00:00

5.6 KiB
Raw Blame History

Отчёт — лабораторная 3

  • Автор, группа: Лобашов Валентин, БПИ2303
  • Целевая оценка; выбранный трек 5, если нужен: 3
  • Commit/PR: TODO после публикации
  • Использованные источники, библиотеки и помощь ИИ: ASP.NET Core, Npgsql 9.0.4, Konscious.Security.Cryptography.Argon2 1.3.1, PostgreSQL 16.11, HAProxy 2.8.14, контракт репозитория. Реализацию и черновик отчёта подготовил ассистент Cursor.

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

Нужны Docker Desktop и интернет для первой сборки. Образы: mcr.microsoft.com/dotnet/sdk:10.0.401, mcr.microsoft.com/dotnet/aspnet:10.0.12, postgres:16.11, haproxy:2.8.14.

copy .env.example .env

В .env замените POSTGRES_PASSWORD на локальный пароль. Файл не коммитится. Затем:

docker compose --env-file .env up -d --build

Поднимаются PostgreSQL, две реплики API и HAProxy. Снаружи открыт только 127.0.0.1:8080 на балансировщике. Порты реплик наружу не публикуются. Миграция применяется при старте каждой реплики под advisory lock, повторный запуск данные не дублирует. Готовность: GET http://127.0.0.1:8080/health/ready.

python tests/smoke.py --base-url http://127.0.0.1:8080

Перезапуск без удаления volume: sh scripts/restart.sh. Остановка одной реплики: TARGET_INSTANCE_ID=<значение X-Instance-Id> sh scripts/stop-one.sh. Вернуть её: docker compose --env-file .env start api. Удаление учебных данных: docker compose --env-file .env down -v.

На Windows .sh напрямую не запускается. Те же действия: docker compose --env-file .env restart postgres api lb и остановка контейнера, чей X-Instance-Id совпал.

Архитектура и решения

Из lab2 перенесены PostgreSQL, Argon2id, Basic только для входа и Bearer для остальных запросов. Сессии общие в PostgreSQL, локальной памяти для них нет.

Клиент ходит только на HAProxy. Две реплики api отвечают по очереди. У каждой свой X-Instance-Id на всё время процесса; заголовок есть у каждого ответа API. HAProxy проверяет /health/ready раз в секунду и убирает реплику после одной неудачи. Таймаут к реплике 2 секунды, затем запрос уходит на другую.

Idempotency-Key обязателен только для POST сообщения. Ключ уникален в пределах пользователя, метода и пути чата. Тот же текст в течение IDEMPOTENCY_TTL_SECONDS (по умолчанию 86400) возвращает то же сообщение. Другой текст с тем же ключом даёт 409. Запись сообщения и ключа — одна транзакция, поэтому неуспешный запрос ключ не занимает.

SESSION_STORE=postgres. DATABASE_URL задаёт строку Npgsql внутри compose. DATABASE_URL_FILE читается, если переменной нет. API_REPLICAS по умолчанию 2.

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke через LB python tests/smoke.py --base-url http://127.0.0.1:8080 PASS evidence/smoke.txt
Две реплики, одна сессия 40 запросов /users/me 2 разных X-Instance-Id evidence/failover.txt
Остановка одной реплики scripts/stop-one.sh по TARGET_INSTANCE_ID скрипт вернул 0, следующие чтения идут на другую реплику, сообщение на месте evidence/failover.txt
Свои тесты lab2 dotnet test src/Messenger.slnx 3 пройдено evidence/dotnet-test.txt

Проверялось 2026-11-13, Docker Desktop, compose-проект 3.

Эксперименты и отказы

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
docker stop одной реплики API вторая продолжает читать и писать, подтверждённое сообщение остаётся 5 успешных чтений другой реплики, сообщение на месте в пределах 10 с; сообщение не потеряно

Ограничения и следующие шаги

Оценка 3 не включает лимиты CPU/RAM, rolling update и замер RPS по каждой реплике. База одна: падение PostgreSQL останавливает обе реплики. HAProxy тоже один. Это не отказ узла, а отказ процесса одной реплики.