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