ЛР 5 — БПИ-2304 — Саламатин — на 4 #112

Open
gwalut wants to merge 2 commits from gwalut/mtusi2026lab5:solution/bpi-2304-salamatin into main
First-time contributor

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

Автор: Саламатин, БПИ-2304. Целевая оценка — 4, включая минимум на 3. Треки на 5 не выполнялись.

Вынес обработку изображений в отдельный worker. API возвращает 202 после записи исходника в staging MinIO и задания в PostgreSQL. Publisher передаёт задания в отдельный Redis Streams с AOF; outbox восстанавливает отправку после сбоя между COMMIT и publish. Worker сохраняет оригинал без изменений, JPEG thumbnail 256×256, центральный crop 128×128 и optimized WebP.

Добавлены пять попыток с backoff и jitter, lease, реестр failed и replay с аудитом. Повторная доставка использует постоянные ключи результата; готовая работа повторно не исполняется. Staging удаляется после безопасной фиксации результата. Сохранена собственная реализация lab4: сессии, чаты, история, идемпотентность сообщений, две API-реплики и приватный S3.

Запуск

Нужны Docker Desktop с Linux containers и Compose. Из корня репозитория:

./start.ps1

API доступен на http://127.0.0.1:8085. Скрипт создаёт локальные secrets, собирает образы и применяет миграции. Подробные ручные команды — в REPORT.md.

Проверки

21 ноября 2026 года прошли публичные make check и make test, два теста изображений, сценарии остановки worker и рестарта API/broker, crash между COMMIT и publish, crash после записи S3 до ack, дубли ready-job, failed/replay и пять попыток при недоступном S3. Также прошли persistence и failover, затем итоговый smoke. Реальный рестарт девяти контейнеров и сохранение volumes подтверждены снимками до и после.

Полный прогон: python scripts/verify.py. Итог — evidence/verification.json, сценарии — evidence/pipeline.json, подробный вывод — текстовые логи evidence/. Word с объяснением и подготовкой к защите — docs/REVIEW.docx. Дерево файлов опубликованного коммита совпадает с проверенной локальной версией.

Ограничения и источники

Стенд локальный, с одиночными PostgreSQL, MinIO и брокером. Нет резервного копирования, TLS для удалённого доступа и backpressure по длине очереди. Производительность под перегрузкой не исследовалась.

Использованы собственные исходники lab4, контракт текущего задания, FastAPI, Psycopg, redis-py, boto3, Pillow и HAProxy. Источники перечислены в REPORT.md. Codex помог с реализацией, проверками и пояснениями.

  • Обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены, реальный вывод приложен.
  • Сценарии отказов своего уровня воспроизведены.
  • Секреты и приватные ключи находятся вне Git, токены в отчёт не включены.
  • README задания сохранён, REPORT.md содержит инструкцию решения.
## Лабораторная 5 Автор: Саламатин, БПИ-2304. Целевая оценка — 4, включая минимум на 3. Треки на 5 не выполнялись. Вынес обработку изображений в отдельный worker. API возвращает 202 после записи исходника в staging MinIO и задания в PostgreSQL. Publisher передаёт задания в отдельный Redis Streams с AOF; outbox восстанавливает отправку после сбоя между COMMIT и publish. Worker сохраняет оригинал без изменений, JPEG thumbnail 256×256, центральный crop 128×128 и optimized WebP. Добавлены пять попыток с backoff и jitter, lease, реестр failed и replay с аудитом. Повторная доставка использует постоянные ключи результата; готовая работа повторно не исполняется. Staging удаляется после безопасной фиксации результата. Сохранена собственная реализация lab4: сессии, чаты, история, идемпотентность сообщений, две API-реплики и приватный S3. ### Запуск Нужны Docker Desktop с Linux containers и Compose. Из корня репозитория: ```powershell ./start.ps1 ``` API доступен на http://127.0.0.1:8085. Скрипт создаёт локальные secrets, собирает образы и применяет миграции. Подробные ручные команды — в REPORT.md. ### Проверки 21 ноября 2026 года прошли публичные make check и make test, два теста изображений, сценарии остановки worker и рестарта API/broker, crash между COMMIT и publish, crash после записи S3 до ack, дубли ready-job, failed/replay и пять попыток при недоступном S3. Также прошли persistence и failover, затем итоговый smoke. Реальный рестарт девяти контейнеров и сохранение volumes подтверждены снимками до и после. Полный прогон: `python scripts/verify.py`. Итог — evidence/verification.json, сценарии — evidence/pipeline.json, подробный вывод — текстовые логи evidence/. Word с объяснением и подготовкой к защите — docs/REVIEW.docx. Дерево файлов опубликованного коммита совпадает с проверенной локальной версией. ### Ограничения и источники Стенд локальный, с одиночными PostgreSQL, MinIO и брокером. Нет резервного копирования, TLS для удалённого доступа и backpressure по длине очереди. Производительность под перегрузкой не исследовалась. Использованы собственные исходники lab4, контракт текущего задания, FastAPI, Psycopg, redis-py, boto3, Pillow и HAProxy. Источники перечислены в REPORT.md. Codex помог с реализацией, проверками и пояснениями. - [x] Обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены, реальный вывод приложен. - [x] Сценарии отказов своего уровня воспроизведены. - [x] Секреты и приватные ключи находятся вне Git, токены в отчёт не включены. - [x] README задания сохранён, REPORT.md содержит инструкцию решения.
gwalut added 1 commit 2026-11-21 11:59:45 +03:00
gwalut added 1 commit 2026-11-21 12:01:35 +03:00
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/gwalut/mtusi2026lab5 solution/bpi-2304-salamatin:gwalut-solution/bpi-2304-salamatin
git checkout gwalut-solution/bpi-2304-salamatin
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab5#112