Files
mtusi2026lab3/.github/pull_request_template.md
T

74 lines
6.1 KiB
Markdown
Raw 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
Автор / группа: Максим Ситосенко / БВТ2303.
Целевая оценка (3/4/5): **5**.
Трек 5, если заявлен: **1 — цена масштабирования**.
Что реализовано и что перенесено: из собственной lab2 перенесены Go API,
PostgreSQL, миграции, Argon2id и общие Bearer-сессии в Valkey с TTL/AOF.
Сохранены валидация, членство в чатах и cursor-пагинация. Добавлены HAProxy,
две взаимозаменяемые API-реплики, динамический Docker DNS, readiness,
X-Instance-Id и согласованный SIGTERM. Порты API наружу не публикуются.
Обязательный Idempotency-Key защищает отправку сообщений общей транзакцией
PostgreSQL, включая конкурентные повторы через разные реплики. Миграции
вынесены в отдельный сервис. Проверены отказ каждой API и поочерёдная замена
контейнеров под нагрузкой. Исследованы 1/2/4 реплики при фиксированном и
растущем бюджете ресурсов, насыщение и настройка пула соединений.
Команды запуска из чистого clone (Docker с Linux Engine, Compose, Python 3.9+):
```powershell
python -X utf8 scripts/manage.py start
```
Полная проверка и воспроизведение всех исследовательских серий, включая
отрицательный перегрузочный опыт:
```powershell
python -X utf8 scripts/verify.py --include-overload
```
Сценарий сам собирает Linux runner, выполняет исходные make check/validate/test,
собственные и race-тесты, persistence, failover и исследование. Перезапуски
сохраняют volumes. Короткая проверка уровней 3/4 — тот же вызов с
`--no-research` вместо `--include-overload`. На Linux используется `python3`.
Ручная демонстрация: `. .\scripts\manual.ps1`, инструкция — [MANUAL.md](../MANUAL.md).
Результаты проверок и ссылка на REPORT.md: [отчёт](../REPORT.md),
фактический статус — [verification.json](../evidence/verification.json)
(`complete: true`), реальный вывод, raw JSON/CSV и графики — в `evidence/`.
Публичные smoke, OpenAPI, persistence и failover, собственные и race-тесты
пройдены. 16 конкурентных повторов через две API вернули одно Message;
проверены конфликт тела, независимость ключей по пользователю/чату и отзыв
сессии. Публичный failover: восстановление записи за 2.024 s, 137 успешных
записей, 4 переходные ошибки, без потерь подтверждений и дублей. После
перезапуска всех сервисов прежняя сессия и данные сохранились; обе API
последовательно остановлены и заменены под нагрузкой.
Трек 5 завершён: 45 замеров, по три повтора конфигурации. При фиксированном
бюджете 1/2/4 API дали 886.9/771.3/739.9 median RPS; увеличение ресурсов API
не сняло общее ограничение DB. Контроль DB_POOL_MAX 1 → 8 при 32 клиентах:
618.8 → 739.9 median RPS (+19.57%), ошибок нет. При этом p95 ухудшился
74.2 → 92.7 ms: улучшен throughput, не все задержки. Опыт при 64 клиентах
с ростом ошибок сохранён как отрицательный. Методика, CPU/RAM, диапазоны
повторов, диагностика насыщения и границы выводов приведены в REPORT.md.
Ограничения / известные ошибки: локальный HTTP, один физический host;
LB, PostgreSQL, Valkey и storage остаются SPOF, отказ узла не заявлен.
Поочерёдная замена проверена для контейнеров текущей версии; миграция 002
требует первоначального окна остановки, 003 добавляет таблицу. Нагрузочный
генератор closed-loop, перцентили рассчитаны только для успешных запросов;
история и состояние кэша накапливаются, cursor не гарантирует snapshot.
Промышленный предел RPS и универсальное ускорение не заявляются.
Источники и использование ИИ: Docker Compose, HAProxy, PostgreSQL,
Valkey и Argon2id — ссылки и версии в REPORT.md; Codex помог с переносом,
реализацией, инфраструктурой, тестами, исследованием и отчётом.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов своего уровня и выбранный трек 5 воспроизведены.
- [x] Все секреты находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.