Files
mtusi2026lab3/.github/pull_request_template.md
2026-11-15 22:00:21 +03:00

71 lines
5.8 KiB
Markdown
Raw Permalink 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
Автор / группа: Кондрашов Никита / БПИ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 описывает запуск, архитектуру, эксперименты и ограничения.