Files
mtusi2026lab3/.github/pull_request_template.md
T

49 lines
3.6 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 — Брезгунова — на 5
Автор / группа: Брезгунова Анжелика, БВТ2303.
Целевая оценка: 5. Трек 1 — цена масштабирования.
Приложение из lab2 перенесено в отдельный репозиторий lab3. Две и более API
реплики работают за HAProxy с общими PostgreSQL-сессиями, данными и атомарной
идемпотентностью сообщений. Добавлены X-Instance-Id, отдельный migration job,
readiness/DNS, graceful shutdown, проверка отказа каждой реплики и
последовательной замены контейнеров под нагрузкой. Папки lab1/lab2 сохранены.
Исследование сравнивает 1/2/4 реплики при фиксированном суммарном CPU/RAM и
при увеличении ресурсов, измеряет насыщение PostgreSQL и эффект общего кэша
неизменяемого доступа к чату. Сырые JSON, CPU/RAM/pool counters, графики и
ограничения приведены в [REPORT.md](REPORT.md) и [evidence/](evidence/).
Запуск из чистого clone:
```sh
python -X utf8 scripts/bootstrap.py
docker compose --env-file .env up -d --build --wait
python -X utf8 student-tests/verify.py
python -X utf8 student-tests/research.py --duration 20 --repeats 3
```
Проверки: Dockerfile запускает go test/vet; полный OpenAPI validator;
публичные smoke/persistence/failover; 24 конкурентных повтора и конфликтная
гонка body; последовательные SIGTERM каждой реплики; SIGKILL; rolling
replacement; потеря Redis с fallback. Фактические результаты доступны
в `evidence/verification.json`, `checks/`, `resilience-summary.json`.
Ограничения: один Docker-host, DB, LB и disk остаются SPOF. Node/DB failover
не заявляется. Closed-loop исследование имеет coordinated omission, короткие
локальные серии не являются production capacity. Кэш чата корректен при
неизменяемых участниках; для изменения membership потребуется инвалидация.
Несовместимые DDL/API изменения требуют отдельного expand/contract плана.
Источники: собственная lab2, официальные Docker/HAProxy/PostgreSQL docs;
закреплённые зависимости go.mod/go.sum. Codex помог с реализацией, тестами,
экспериментами и оформлением; объяснения защиты находятся в DEFENSE.md.
- [x] Минимум lab2 и обязательный контракт lab3 сохранены.
- [x] Публичные contracts/tests/README не ослаблены; lab1/lab2 не изменены.
- [x] Offline/smoke/persistence/failover и собственные проверки выполнены.
- [x] Отказ каждой реплики и замена под нагрузкой воспроизведены.
- [x] Трек 1 завершён: raw data, графики, граница насыщения и измеренное улучшение.
- [x] Секреты находятся вне Git и build context; tokens не сохраняются.
- [x] REPORT/RUNBOOK/DEFENSE содержат команды и объяснения.