forked from mtusi2026/mtusi2026lab3
Заполнить шаблон PR для лабораторной 3
This commit is contained in:
@@ -1,18 +1,64 @@
|
||||
## Лабораторная 3
|
||||
## ЛР 3 — БПИ2303 — Щербаков — на 3
|
||||
|
||||
Автор / группа: TODO
|
||||
Целевая оценка (3/4/5): TODO
|
||||
Трек 5, если заявлен: TODO
|
||||
Автор / группа: Щербаков Марк Игоревич / БПИ2303.
|
||||
Целевая оценка (3/4/5): **3**.
|
||||
Трек 5, если заявлен: не заявляется.
|
||||
|
||||
Что реализовано и что перенесено: TODO
|
||||
Команды запуска из чистого clone: TODO
|
||||
Результаты проверок и ссылка на REPORT.md: TODO
|
||||
Ограничения / известные ошибки: TODO
|
||||
Источники и использование ИИ: TODO
|
||||
Что реализовано и что перенесено: из собственной lab2 перенесены Python API,
|
||||
PostgreSQL, постоянные сессии, миграции, пагинация и собственные тесты.
|
||||
Добавлены две API-реплики за HAProxy, X-Instance-Id, общая идемпотентность
|
||||
сообщений с TTL 24 часа, отдельный migration job и scripts остановки/перезапуска.
|
||||
Сообщение и ключ сохраняются одной транзакцией, повтор через другую реплику
|
||||
возвращает прежний результат без создания дубля.
|
||||
|
||||
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
||||
- [ ] Контракт и публичные тесты не ослаблены.
|
||||
- [ ] make check и make test выполнены; приложен реальный вывод.
|
||||
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
|
||||
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
||||
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|
||||
Команды запуска из чистого clone, из корня репозитория:
|
||||
|
||||
```sh
|
||||
python scripts/bootstrap.py
|
||||
docker compose --env-file .env config --quiet
|
||||
docker compose --env-file .env up -d --build --wait
|
||||
python scripts/check_contract.py
|
||||
python tests/smoke.py --base-url http://localhost:8080
|
||||
```
|
||||
|
||||
На проверенном Windows-хосте порт 8080 недоступен: в `.env` установлен
|
||||
`APP_PORT=18083`, адрес тестов — `http://127.0.0.1:18083`.
|
||||
Для воспроизведения всех сценариев:
|
||||
|
||||
```sh
|
||||
# Linux/macOS: предварительно chmod +x scripts/restart.sh scripts/stop-one.sh
|
||||
python scripts/verify.py --base-url http://127.0.0.1:18083 --output evidence/grade3-checks.txt
|
||||
```
|
||||
|
||||
Результаты проверок: публичный smoke, 14 собственных тестов, persistence,
|
||||
повтор миграций и failover каждой из двух API-реплик прошли. Конкурентные
|
||||
12 повторов одного ключа через две реплики создали одно сообщение.
|
||||
При остановке api1/api2 первое успешное POST после завершения hook наблюдалось
|
||||
через 3,359/3,016 с от его запуска, подтверждённые данные и сессии сохранены.
|
||||
Переходные ошибки учтены в протоколе; после проверки обе реплики восстановлены.
|
||||
Полная валидация OpenAPI также прошла.
|
||||
|
||||
Инструкция и разбор: [REPORT.md](../REPORT.md).
|
||||
Протокол: [grade3-checks.txt](../evidence/grade3-checks.txt).
|
||||
Валидация контракта: [contracts.txt](../evidence/contracts.txt).
|
||||
На Windows Make отсутствует: выполнены эквивалентные Python-команды его целей.
|
||||
Linux hooks и Make включены в CI; удалённый CI не запускался.
|
||||
|
||||
Ограничения / известные ошибки: один Docker-host, один LB и PostgreSQL —
|
||||
точки единого отказа. Проверен отказ одной API при доступной БД, полный
|
||||
рестарт проверен на сохранность данных. Нет HA БД, backup, защиты от потери
|
||||
volume/host, автоматического масштабирования и rolling update. Требуется
|
||||
очистка старых сессий/ключей. HTTP предназначен для локальных учебных данных.
|
||||
Уровни 4/5 не заявляются.
|
||||
|
||||
Источники и использование ИИ: собственные lab1/lab2, контракт текущей работы,
|
||||
официальная документация HAProxy, Docker Compose, PostgreSQL и psycopg
|
||||
(ссылки в REPORT.md). OpenAI Codex использован для изучения материалов,
|
||||
реализации, тестов и отчёта.
|
||||
|
||||
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
||||
- [x] Контракт и публичные тесты не ослаблены.
|
||||
- [x] Эквивалентные Python-команды make check и make test выполнены; приложен реальный вывод.
|
||||
- [x] Сценарии отказов своего уровня воспроизведены.
|
||||
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
||||
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|
||||
|
||||
Reference in New Issue
Block a user