5.6 KiB
Отчёт — лабораторная 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 тоже один. Это не отказ узла, а отказ процесса одной реплики.