[+] add project

This commit is contained in:
2026-11-15 22:00:21 +03:00
parent 0ab3a341aa
commit 369c5c1660
45 changed files with 2442 additions and 57 deletions
+66 -14
View File
@@ -1,18 +1,70 @@
## Лабораторная 3
Автор / группа: TODO
Целевая оценка (3/4/5): TODO
Трек 5, если заявлен: TODO
Автор / группа: Кондрашов Никита / БПИ2304
Целевая оценка (3/4/5): 5
Трек 5: трек 1 — цена масштабирования API
Что реализовано и что перенесено: TODO
Команды запуска из чистого clone: TODO
Результаты проверок и ссылка на REPORT.md: TODO
Ограничения / известные ошибки: TODO
Источники и использование ИИ: TODO
Что реализовано и что перенесено: Перенесены пользователи, чаты, участники, сообщения, keyset-пагинация и Bearer-сессии из предыдущей лабораторной. Добавлены PostgreSQL, отдельный запуск миграций, Redis как общий кэш профилей, HAProxy и две API-реплики. Идемпотентность сообщений хранится в PostgreSQL: конкурентные запросы с одинаковым ключом создают одно сообщение, а повтор ключа с другим телом возвращает 409. Добавлены health/readiness checks, graceful shutdown, failover и последовательный перезапуск реплик.
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [ ] Контракт и публичные тесты не ослаблены.
- [ ] make check и make test выполнены; приложен реальный вывод.
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Команды запуска из чистого clone (выполнять из корня `mtusi2026lab3`):
```sh
[ -f .env ] || cp .env.example .env
mkdir -p secrets
[ -f secrets/database_password ] || openssl rand -hex 32 > secrets/database_password
chmod 600 secrets/database_password
docker compose --env-file .env config --quiet
docker compose --env-file .env build api migrate
docker compose --env-file .env up -d postgres redis
docker compose --env-file .env run --rm migrate
docker compose --env-file .env up -d --scale api=2 api load_balancer
docker compose --env-file .env ps
```
Дождаться статуса `healthy`, затем проверить сервис:
```sh
curl --fail http://localhost:8080/health/ready
make check
make validate
make test
make test-grade4
make test-persistence ACTION_SCRIPT=scripts/restart.sh
```
Проверка отказа каждой API-реплики:
```sh
for c in $(docker compose ps -q api); do
docker inspect --format '{{.Config.Hostname}}' "$c"
done
```
Подставить один из выведенных hostname в `TARGET_INSTANCE_ID`, восстановить две реплики после теста и повторить со вторым:
```sh
make test-failover-target TARGET_INSTANCE_ID=ВСТАВЬТЕ_HOSTNAME OUTPUT=evidence/failover-api1.json
docker compose --env-file .env up -d --scale api=2 api
make test-failover-target TARGET_INSTANCE_ID=ВСТАВЬТЕ_HOSTNAME OUTPUT=evidence/failover-api2.json
docker compose --env-file .env up -d --scale api=2 api
```
Для проверки rolling restart запустить `make load OUTPUT=evidence/rolling-restart-load.json` и `make rolling-restart` одновременно в двух терминалах. Эксперимент трека 5:
```sh
python3 scripts/benchmark.py --duration 10 --concurrency 8 --repeats 3
```
Результаты проверок и ссылка на REPORT.md: `make check`, `make validate`, Compose config, `make test`, `make test-grade4`, `make test-persistence`, отказы обеих реплик и rolling restart под нагрузкой выполнены. Smoke, контракт, конкурирующая идемпотентность и persistence прошли. Восстановление записей после отказов — 2,463 и 2,529 с; при rolling restart за 30 секунд выполнено 11 200 успешных запросов и зарегистрирована 1 ошибка. Подробные результаты и ограничения — в [REPORT.md](../REPORT.md), итоговый вывод проверок — в [evidence/acceptance.log](../evidence/acceptance.log). Результаты трека масштабирования — в [evidence/benchmark/summary.csv](../evidence/benchmark/summary.csv) и [графике](../evidence/benchmark/throughput.svg): при фиксированном бюджете 1 CPU/512 MiB throughput составил 319/267/186 RPS для 1/2/4 реплик; при удвоении бюджета для двух реплик — 564 RPS, дальнейшее увеличение до четырёх реплик дало 568 RPS.
Ограничения / известные ошибки: Локальный single-node Compose. PostgreSQL, HAProxy и Docker host не реплицированы; их отказ не проверялся. Нагрузочный тест closed-loop и характеризует только этот стенд и профиль.
Источники и использование ИИ: использованы контракт и тесты лабораторной, документация Docker Compose и HAProxy. ИИ использовался при исправлении ошибок, проверке изменений и подготовке документации.
- [x] Обязательный минимум лабораторной реализован; межлабораторные переходы описаны в REPORT.md.
- [x] Контракт и публичные тесты не ослаблялись.
- [x] `make check`, `make validate`, `make test` и дополнительные проверки выполнены; вывод сохранён в evidence.
- [x] Проверены persistence, отказ каждой API-реплики и rolling restart под нагрузкой.
- [x] Секреты находятся в локальных игнорируемых файлах; отчёт и тестовые доказательства не содержат токенов.
- [x] README задания сохранён; REPORT.md описывает запуск, архитектуру, эксперименты и ограничения.