forked from mtusi2026/mtusi2026lab3
[+] add project
This commit is contained in:
@@ -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 описывает запуск, архитектуру, эксперименты и ограничения.
|
||||
|
||||
Reference in New Issue
Block a user