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

62 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Отчёт — лабораторная 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`.
```sh
copy .env.example .env
```
В `.env` замените `POSTGRES_PASSWORD` на локальный пароль. Файл не коммитится. Затем:
```sh
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`.
```sh
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 тоже один. Это не отказ узла, а отказ процесса одной реплики.