Files
mtusi2026lab3/.github/pull_request_template.md
T

6.1 KiB
Raw Blame History

Лабораторная 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+):

python -X utf8 scripts/manage.py start

Полная проверка и воспроизведение всех исследовательских серий, включая отрицательный перегрузочный опыт:

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.

Результаты проверок и ссылка на REPORT.md: отчёт, фактический статус — 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 помог с переносом, реализацией, инфраструктурой, тестами, исследованием и отчётом.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов своего уровня и выбранный трек 5 воспроизведены.
  • Все секреты находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.