forked from mtusi2026/mtusi2026lab3
71 lines
5.8 KiB
Markdown
71 lines
5.8 KiB
Markdown
## Лабораторная 3
|
||
|
||
Автор / группа: Кондрашов Никита / БПИ2304
|
||
Целевая оценка (3/4/5): 5
|
||
Трек 5: трек 1 — цена масштабирования API
|
||
|
||
Что реализовано и что перенесено: Перенесены пользователи, чаты, участники, сообщения, keyset-пагинация и Bearer-сессии из предыдущей лабораторной. Добавлены PostgreSQL, отдельный запуск миграций, Redis как общий кэш профилей, HAProxy и две API-реплики. Идемпотентность сообщений хранится в PostgreSQL: конкурентные запросы с одинаковым ключом создают одно сообщение, а повтор ключа с другим телом возвращает 409. Добавлены health/readiness checks, graceful shutdown, failover и последовательный перезапуск реплик.
|
||
|
||
Команды запуска из чистого 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 описывает запуск, архитектуру, эксперименты и ограничения.
|