Files
mtusi2026lab4/.github/pull_request_template.md

4.7 KiB
Raw Permalink Blame History

Лабораторная 4

Заголовок PR: ЛР 4 — БПИ2301 — Черненко — на 5 Ветка решения: solution/bpi2301-chernenko, база: исходный main skeleton (ec540a1).

Автор / группа: Черненко / БПИ2301. Целевая оценка: 5. Трек: 2 — согласованность двух хранилищ.

Реализован синхронный proxy upload PNG/JPEG в приватный MinIO, метаданные и ACL в PostgreSQL, авторизованный побайтный download, сообщения с вложениями, две FastAPI-реплики и HAProxy с readiness. Минимум lab1–3 написан по контракту текущего skeleton: Argon2id/Bearer-сессии, PostgreSQL persistence, чаты, keyset pagination, атомарная идемпотентность сообщений между репликами. Предыдущее личное решение не предоставлялось, чужое решение не переносилось.

Reconciler поддерживает dry-run/apply, grace period, orphan/missing, повторный безопасный запуск и восстановление из проверенной копии. Shared/exclusive DB advisory locks согласуют сверку с загрузкой и привязкой. Исследование внедряет ошибку SQL после реального PUT, удаление оригинала и неправильный backup.

Запуск из clone (Linux/macOS, Windows: py -X utf8 вместо python3):

python3 scripts/setup.py
docker compose --env-file .env config --quiet
docker compose up -d --build --wait --wait-timeout 180
docker compose exec -T api1 make check validate PYTHON=python
docker compose exec -T api1 make test PYTHON=python BASE_URL=http://lb:8080
python3 scripts/run-all.py

При занятом 8080 задать HOST_PORT=18084 в .env. Испытания проведены на 18084. Первая сборка компилирует фиксированные официальные tags MinIO/mc, поскольку готовые registry images были недоступны.

Проверки: полный прогон PASS, REPORT.md, численные итоги, памятка к защите. Smoke, негативные сценарии, persistence всех хранилищ, failover каждой API, отказы S3/PostgreSQL и сверка прошли. Публичный failover: 2,449 с до восстановления, 86 успешных записей, 1 переходная ошибка, без потерь и дублей. 60 измеряемых загрузок при concurrency=10 и двух размерах: 0 ошибок; наблюдённые cgroup-пики обеих API ≈149/176 MiB при лимите 512 MiB. Сверка 1085 объектов: 2 LIST, 0,136 с (один локальный проход, не production SLA).

Ограничения: один host и одиночные PostgreSQL/MinIO/LB; HTTP только локально; ручной запуск сверки и необходимость backup при потере байтов. Сверка O(A+O) держит exclusive DB lock на время прохода. Подробные ограничения измерений, конкурентной пагинации и границ безопасности раскрыты в отчёте.

Источники и ИИ: нормативный skeleton, официальные Psycopg/MinIO/Pillow/S3 docs; реализация и документация подготовлены с помощью Codex, реальные команды и обезличенные результаты сохранены в evidence/. Обязательные файлы задания сохранены.

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