Files
mtusi2026lab3/.github/pull_request_template.md
T

71 lines
9.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.
Целевая оценка (3/4/5): **5**.
Трек 5, если заявлен: **Трек 1 — «Цена масштабирования»**.
### Что реализовано и что перенесено
Из лабораторной 2 перенесены Go API, PostgreSQL, Redis-сессии, аутентификация с Argon2id, ACL чатов, сообщения, пагинация, миграции, frontend и собственные тесты.
Добавлены две API-реплики за HAProxy с общей БД и сессиями, реальные `X-Instance-Id`, транзакционная идемпотентность POST, readiness и graceful shutdown. Миграции запускаются отдельным сервисом. Настроены CPU/RAM-лимиты всех сервисов, приватные сети API и хранилищ, остановка выбранной реплики и поочерёдная замена под нагрузкой.
Для трека 1 проведены сравнения 1/2/4 реплик при фиксированном и растущем бюджете. Сохранены протоколы, сырые данные, графики и результаты. Проверено улучшение `GOMAXPROCS=16 → 1` при одинаковых остальных условиях. Исправлена обнаруженная при финальной проверке ошибка: некорректные UUID внутри курсоров теперь отклоняются до SQL и возвращают 400 вместо 503. Добавлены регрессионные тесты. Для будущих экспериментов обновлён хеш исходников в протоколах версии 1.3; исторические протоколы и данные не изменены.
### Команды запуска из чистого clone
Нужны WSL Ubuntu/Linux, Git, Docker Compose, Make и Python. Ветка `solution/BVT2303-Grishko` должна быть опубликована.
**1. Скачать лабораторную и настроить окружение:**
```sh
git clone --branch solution/BVT2303-Grishko https://gitea.privcloud.tech/TAskMAster339/mtusi2026lab3-fork.git
cd mtusi2026lab3-fork
python3 scripts/init_env.py
```
Скрипт создаёт `.env` на основе `.env.example`, добавляет имя базы/пользователя `messenger`, случайный пароль PostgreSQL и файлы подключения в `secrets/`. Существующие значения и файлы сохраняются; отсутствующие настройки дополняются. До запуска можно изменить `.env`: внутренний `APP_PORT`, `API_REPLICAS`, TTL сессий и ключей идемпотентности, метку `APP_ENV`, пути `_FILE`. Порт и число реплик передаются также в HAProxy. Адреса подключения меняются в `secrets/database_url` и `secrets/cache_url`. Сессии всегда в Redis; `.env` и `secrets/` исключены из Git. Подробности — в [REPORT.md](../REPORT.md).
**2. Проверить конфигурацию и запустить приложение:**
```sh
docker compose --project-name highload-lab3 --env-file .env -f compose.yml config --quiet
make app-up
make app-status
```
`make app-up` собирает образы, выполняет миграции и ждёт готовности. API: `http://localhost:8080`, UI: `http://localhost:5173`, HAProxy stats: `http://localhost:8404/stats`. Проверки: `make check`, `make test`, `make test-backend`, `make test-grade4`; команды persistence/failover и воспроизведение исследования — в [REPORT.md](../REPORT.md). Остановка: `make app-down`, volumes сохраняются.
### Результаты проверок и отчёт
[REPORT.md](../REPORT.md) содержит архитектуру, запуск, таблицы соответствия критериям, измерения и ограничения. [Доказательства по каждому пункту](../evidence/criteria/README.md) содержат команды, реальный вывод и ссылки на реализацию. [Исследование](../evidence/grade5/RESULTS.md) и [методика](../experiments/lab3-scale/docs/method.md) доступны в репозитории.
Финальная проверка 10 октября 2026 года:
- `make check`, `make test` и Go tests с `-race` повторно прошли после исправления; `go vet` прошёл при предшествующей финальной проверке.
- Все 37 дополнительных HTTP-проверок прошли после исправления; четыре запроса с некорректными UUID внутри курсоров теперь возвращают 400.
- 24 конкурентных одинаковых POST через обе API вернули одинаковые 201; повтор с `attachment_ids: []` также вернул исходный 201.
- Прерывание соединения PostgreSQL после INSERT до COMMIT оставило 0 сообщений и 0 ключей; повтор успешно создал одну запись.
- Отказы каждой реплики проверены отдельно: исключение из LB за 0.766 и 1.869 с, по три ошибки в переходном периоде; чтение и запись возобновились менее чем за 10 с.
- Поочерёдная замена двух реплик: 1468 записей + 1571 чтение, 0 ошибок, graceful shutdown, сохранены сообщения и сессия.
- Persistence-тест сохранил данные и действующую сессию; HAProxy снова увидел обе API без собственного рестарта. Первый запуск проверки получил тайм-аут входа до restart-hook; отдельный повтор прошёл.
- Проверены CPU/RAM всех сервисов, отдельный migrate, отсутствие обходных портов API и разные идентификаторы реплик.
- Независимо пересчитаны 150 подтверждающих экспериментальных прогонов из сырых данных: успешные ответы, попытки, пропуски, p50/p95/p99, SLO и решения совпали. Пропуски генератора — 0.
### Ограничения / известные ошибки
Стенд работает на одном хосте: HAProxy, PostgreSQL и Redis остаются отдельными точками отказа. При внезапной остановке API допустимы измеренные краткие ошибки до исключения реплики из LB. Rolling проверен как поочерёдная замена процессов с совместимыми миграциями, а не как переход между несовместимыми версиями схемы.
Эксперимент относится к выбранному профилю нагрузки и 30-секундным прогонам. Границы мощности — интервалы между точками сетки SLO, не точные потолки и не доверительные интервалы. H1 подтверждена в исследованных условиях; H2, HI и HC остаются неопределёнными. HL подтверждает снижение p95 на фиксированной нагрузке; универсальные +15% мощности и масштабирование в 1.5 раза не доказаны. Процент эффекта с четырёх API по 0.25 CPU нельзя автоматически переносить на обычные две API по 0.5 CPU.
### Источники и использование ИИ
Официальная документация Docker Compose, HAProxy, Go, pgxpool и aiohttp. Подробные ссылки и версии — в [REPORT.md](../REPORT.md). OpenAI Codex использован для переноса и реализации кода, инструментов проверки, анализа измерений и оформления отчёта. Экспериментальные выводы основаны на сохранённых данных;
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод в evidence/criteria.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.