ЛР 4 — БПИ2301 — Дугина — на 4 #82

Closed
aleksandra_dugina wants to merge 1 commits from aleksandra_dugina/mtusi2026lab4:solution/BPI2301-Dugina into main
First-time contributor

Лабораторная 4 — S3-хранилище и вложения

Автор / группа: Дугина Александра, БПИ2301
Целевая оценка: 4

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

Из лабораторной №3 перенесён мессенджер на FastAPI с PostgreSQL, Redis, аутентификацией Basic/Bearer, сессиями, чатами, сообщениями, курсорной пагинацией, конкурентной идемпотентностью и балансировкой HAProxy между двумя API-репликами.

В лабораторной №4 реализованы:

  • S3-совместимое хранилище MinIO с приватным bucket и ограниченными правами доступа.
  • Загрузка PNG/JPEG до 10 МиБ через raw binary API.
  • Проверка MIME, целостности изображений, количества пикселей и имени файла.
  • Хранение оригиналов в S3, метаданных — в PostgreSQL.
  • Авторизованное скачивание вложений и привязка их к сообщениям.
  • Обработка отказов S3/PostgreSQL, компенсация сбоев и периодическая очистка orphan-объектов с grace period.
  • Persistence, failover, healthchecks и ограничение ресурсов контейнеров.

Команды запуска из чистого clone

python3 scripts/init-local.py
scripts/compose.sh up -d --build
make check
make test BASE_URL=http://localhost:8084
make test-persistence BASE_URL=http://localhost:8084 ACTION_SCRIPT=scripts/restart.sh
make test-failover BASE_URL=http://localhost:8084 ACTION_SCRIPT=scripts/stop-one.sh

Подробная инструкция, включая подготовку Python-зависимостей, приведена в REPORT.md.

Результаты проверок

Все 16 этапов итогового проверочного прогона завершились успешно.

  • Публичные проверки, persistence и failover — PASS.
  • 16 групп собственных негативных проверок — PASS.
  • 11 сценариев отказов и восстановления — PASS.
  • 55 сохранённых оригиналов — размеры и SHA-256 совпадают.
  • Нагрузочный эксперимент: 10 одновременных загрузок, 10 успешных, 0 ошибок.
  • Длительность эксперимента — 1,785 с.
  • Измеренный пик RAM API — 107,57 и 118,64 MiB.

Подробные результаты: REPORT.md, evidence/verification.json, evidence/faults.txt, evidence/upload-load.json.

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

  • Проверка истечения grace period проводилась со сдвигом часов тестового процесса, без реального ожидания одного часа.
  • Периодическое измерение RAM может не фиксировать кратковременные пики.
  • Полный отказ Docker-host не моделировался.
  • Промежуточная ошибка собственного теста исправлена и описана в отчёте; итоговых FAIL нет.

Чек-лист

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 4 — S3-хранилище и вложения **Автор / группа:** Дугина Александра, БПИ2301 **Целевая оценка:** 4 ### Что реализовано и что перенесено Из лабораторной №3 перенесён мессенджер на FastAPI с PostgreSQL, Redis, аутентификацией Basic/Bearer, сессиями, чатами, сообщениями, курсорной пагинацией, конкурентной идемпотентностью и балансировкой HAProxy между двумя API-репликами. В лабораторной №4 реализованы: - S3-совместимое хранилище MinIO с приватным bucket и ограниченными правами доступа. - Загрузка PNG/JPEG до 10 МиБ через raw binary API. - Проверка MIME, целостности изображений, количества пикселей и имени файла. - Хранение оригиналов в S3, метаданных — в PostgreSQL. - Авторизованное скачивание вложений и привязка их к сообщениям. - Обработка отказов S3/PostgreSQL, компенсация сбоев и периодическая очистка orphan-объектов с grace period. - Persistence, failover, healthchecks и ограничение ресурсов контейнеров. ### Команды запуска из чистого clone ```bash python3 scripts/init-local.py scripts/compose.sh up -d --build make check make test BASE_URL=http://localhost:8084 make test-persistence BASE_URL=http://localhost:8084 ACTION_SCRIPT=scripts/restart.sh make test-failover BASE_URL=http://localhost:8084 ACTION_SCRIPT=scripts/stop-one.sh ``` Подробная инструкция, включая подготовку Python-зависимостей, приведена в `REPORT.md`. ### Результаты проверок Все 16 этапов итогового проверочного прогона завершились успешно. - Публичные проверки, persistence и failover — PASS. - 16 групп собственных негативных проверок — PASS. - 11 сценариев отказов и восстановления — PASS. - 55 сохранённых оригиналов — размеры и SHA-256 совпадают. - Нагрузочный эксперимент: 10 одновременных загрузок, 10 успешных, 0 ошибок. - Длительность эксперимента — 1,785 с. - Измеренный пик RAM API — 107,57 и 118,64 MiB. Подробные результаты: `REPORT.md`, `evidence/verification.json`, `evidence/faults.txt`, `evidence/upload-load.json`. ### Ограничения / известные ошибки - Проверка истечения grace period проводилась со сдвигом часов тестового процесса, без реального ожидания одного часа. - Периодическое измерение RAM может не фиксировать кратковременные пики. - Полный отказ Docker-host не моделировался. - Промежуточная ошибка собственного теста исправлена и описана в отчёте; итоговых FAIL нет. ### Чек-лист - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
aleksandra_dugina added 1 commit 2026-11-06 18:23:27 +03:00
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-07 17:46:44 +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#82