ЛР 4 — БВТ2302 — Осокин — на 3 #145

Closed
glebossokin wants to merge 1 commits from glebossokin/mtusi2026lab4:solution/BVT2302-Osokin into main
First-time contributor

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

Автор / группа: Осокин Глеб / БВТ2302, Gitea glebossokin.

Целевая оценка (3/4/5): 3.

Трек 5, если заявлен: не заявлен. Дополнительные задания уровней 4/5 не заявляются.

Что реализовано и что перенесено:

  • Из собственной ЛР3 перенесён обязательный минимум: PostgreSQL, Redis-сессии с TTL/AOF, scrypt, HAProxy, две API-реплики, пагинация и общая транзакционная идемпотентность сообщений.
  • В общий Compose добавлен MinIO с закреплённой версией, private bucket и persistent volume. Metadata Attachment хранятся в PostgreSQL; оригинальные bytes — в S3, без обязательного локального файла API.
  • Синхронный binary upload PNG/JPEG возвращает 201 ready после S3 PUT и COMMIT metadata. Проверяются Content-Length ≤10 MiB, реальные формат/MIME, ≤40 млн пикселей до decode и безопасный filename; object key генерирует сервер.
  • Message поддерживает attachment_ids, включая пустой text с вложением. Участники читают metadata/content через API, посторонний получает 404; оригинал возвращается побайтно, без redirect.
  • Подготовлены restart/stop-one hooks, проверка остановки именно загрузившей API, недоступности S3 и сохранности после общего restart.

Команды запуска из чистого clone (Windows PowerShell, Docker Desktop Linux containers):

python -X utf8 scripts/bootstrap.py
docker compose --env-file .env config --quiet
docker compose build api
docker compose --env-file .env up -d --no-build
python -X utf8 scripts/wait_ready.py
python -X utf8 scripts/verify.py

Linux: python3 вместо python -X utf8; shell hooks сохранены executable в Git. Host entrypoint: http://127.0.0.1:8084. .env и secrets создаются локально, исключены из Git. Безопасная остановка: docker compose down.

Результаты проверок и ссылка на REPORT.md:

  • Эквиваленты make check / make test: PASS, публичные scripts вызваны напрямую; финальный smoke также PASS.
  • 16 конкурентных повторов одного сообщения через 2 API создали ровно 1 Message; минимум ЛР3 сохранён.
  • Реальные PNG/JPEG приняты и скачаны без изменений; anonymous S3 GET вернул 403.
  • Точные границы 10 MiB и 40 000 000 пикселей приняты; excess bytes отклонены до чтения, excess pixels до декодирования; опасные filename отклонены.
  • Upload → остановка контейнера, вернувшего X-Instance-Id загрузки → download другой API: bytes/SHA-256 совпали, attached Message прочитан вторым участником, постороннему 404.
  • Остановка MinIO: API live/metadata=200, ready/upload/content=503; после восстановления прежний токен скачал прежний оригинал.
  • Публичный persistence: PASS после реального restart API, PostgreSQL, Redis, MinIO и LB с прежними volumes и сессией.
  • Публичный failover: PASS; 2 API до отказа, 99 успешных записей, 4 переходные ошибки, первое восстановление 5.198 s; потерь подтверждённых сообщений и дублей нет. Реплика восстановлена, оба API здоровы.

REPORT.md: запуск, архитектура, транзакционные границы, доказательства и ограничения.
evidence/: реальные выводы, hash, состояния контейнеров и volumes.

Ограничения / известные ошибки:

  • Один host и одиночные хранилища; при отказе S3 консервативная readiness может убрать обе API из LB.
  • Нет общей транзакции S3/БД: после PUT до COMMIT возможен orphan. Автоматической компенсации/очистки/reconciler нет.
  • Upload/download буферизованы и ограничены 10 MiB; decode ограничен пикселями. Нет эксперимента ≥10 uploads с измерением RAM и отдельной ограниченной S3-роли; используются credentials учебного MinIO.
  • Presigned flow и исследовательские треки не реализованы; оценка запрашивается только на 3.

Источники и использование ИИ: собственная ЛР3, контракт/README текущей лабы, документация Pillow/Boto3/MinIO; OpenAI Codex помог с реализацией, отчётом и запуском проверок. Подробности и ссылки в REPORT.md.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены через эквивалентные прямые вызовы Python; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 4 Автор / группа: **Осокин Глеб / БВТ2302**, Gitea `glebossokin`. Целевая оценка (3/4/5): **3**. Трек 5, если заявлен: **не заявлен**. Дополнительные задания уровней 4/5 не заявляются. Что реализовано и что перенесено: - Из собственной ЛР3 перенесён обязательный минимум: PostgreSQL, Redis-сессии с TTL/AOF, scrypt, HAProxy, две API-реплики, пагинация и общая транзакционная идемпотентность сообщений. - В общий Compose добавлен MinIO с закреплённой версией, private bucket и persistent volume. Metadata Attachment хранятся в PostgreSQL; оригинальные bytes — в S3, без обязательного локального файла API. - Синхронный binary upload PNG/JPEG возвращает 201 ready после S3 PUT и COMMIT metadata. Проверяются Content-Length ≤10 MiB, реальные формат/MIME, ≤40 млн пикселей до decode и безопасный filename; object key генерирует сервер. - Message поддерживает attachment_ids, включая пустой text с вложением. Участники читают metadata/content через API, посторонний получает 404; оригинал возвращается побайтно, без redirect. - Подготовлены restart/stop-one hooks, проверка остановки именно загрузившей API, недоступности S3 и сохранности после общего restart. Команды запуска из чистого clone (Windows PowerShell, Docker Desktop Linux containers): ```powershell python -X utf8 scripts/bootstrap.py docker compose --env-file .env config --quiet docker compose build api docker compose --env-file .env up -d --no-build python -X utf8 scripts/wait_ready.py python -X utf8 scripts/verify.py ``` Linux: `python3` вместо `python -X utf8`; shell hooks сохранены executable в Git. Host entrypoint: `http://127.0.0.1:8084`. `.env` и secrets создаются локально, исключены из Git. Безопасная остановка: `docker compose down`. Результаты проверок и ссылка на REPORT.md: - Эквиваленты make check / make test: PASS, публичные scripts вызваны напрямую; финальный smoke также PASS. - 16 конкурентных повторов одного сообщения через 2 API создали ровно 1 Message; минимум ЛР3 сохранён. - Реальные PNG/JPEG приняты и скачаны без изменений; anonymous S3 GET вернул 403. - Точные границы 10 MiB и 40 000 000 пикселей приняты; excess bytes отклонены до чтения, excess pixels до декодирования; опасные filename отклонены. - Upload → остановка контейнера, вернувшего X-Instance-Id загрузки → download другой API: bytes/SHA-256 совпали, attached Message прочитан вторым участником, постороннему 404. - Остановка MinIO: API live/metadata=200, ready/upload/content=503; после восстановления прежний токен скачал прежний оригинал. - Публичный persistence: PASS после реального restart API, PostgreSQL, Redis, MinIO и LB с прежними volumes и сессией. - Публичный failover: PASS; 2 API до отказа, 99 успешных записей, 4 переходные ошибки, первое восстановление 5.198 s; потерь подтверждённых сообщений и дублей нет. Реплика восстановлена, оба API здоровы. [REPORT.md: запуск, архитектура, транзакционные границы, доказательства и ограничения](https://gitea.privcloud.tech/glebossokin/mtusi2026lab4/src/branch/solution/BVT2302-Osokin/REPORT.md). [evidence/: реальные выводы, hash, состояния контейнеров и volumes](https://gitea.privcloud.tech/glebossokin/mtusi2026lab4/src/branch/solution/BVT2302-Osokin/evidence). Ограничения / известные ошибки: - Один host и одиночные хранилища; при отказе S3 консервативная readiness может убрать обе API из LB. - Нет общей транзакции S3/БД: после PUT до COMMIT возможен orphan. Автоматической компенсации/очистки/reconciler нет. - Upload/download буферизованы и ограничены 10 MiB; decode ограничен пикселями. Нет эксперимента ≥10 uploads с измерением RAM и отдельной ограниченной S3-роли; используются credentials учебного MinIO. - Presigned flow и исследовательские треки не реализованы; оценка запрашивается только на 3. Источники и использование ИИ: собственная ЛР3, контракт/README текущей лабы, документация Pillow/Boto3/MinIO; OpenAI Codex помог с реализацией, отчётом и запуском проверок. Подробности и ссылки в REPORT.md. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены через эквивалентные прямые вызовы Python; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
glebossokin added 1 commit 2026-11-16 15:27:12 +03:00
Owner

Принято на 3

Принято на 3
veprickiy closed this pull request 2026-11-16 16:48:26 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab4#145