8.9 KiB
Отчёт — лабораторная 4
- Автор, группа: Максимова Снежана, БПИ2302
- Целевая оценка: 4
- Commit/PR: <ссылка на PR появится после пуша>
- Использованные источники, библиотеки и помощь ИИ: FastAPI, SQLAlchemy, boto3, Pillow, MinIO. ИИ использовался для генерации черновиков конфигураций и кода, финальная проверка и отладка проводились вручную.
Запуск из чистого clone
Для запуска требуются Docker, Docker Compose и Python.
git clone https://gitea.privcloud.tech/kleprer/mtusi2026lab4.git
cd mtusi2026lab4
# кроссплатформенное копирование .env
python -c "import shutil; shutil.copy('.env.example', '.env')"
docker compose up -d --build --scale api=2
Безопасная остановка (с сохранением данных):
docker compose down
Намеренное удаление учебных данных (БД, кэша, файлов):
docker compose down -v
Архитектура и решения
Схема процессов: Клиент → Nginx (порт 8080) → API-реплики (FastAPI) → PostgreSQL (метаданные, пользователи, сессии), Redis (сессии), MinIO (S3-хранилище для файлов).
Что изменено по сравнению с lab3:
- S3-хранилище (MinIO): В
compose.yamlдобавлен сервисminio. Приватный бакетattachmentsсоздаётся автоматически при старте приложения. - Метаданные файлов: В PostgreSQL добавлена таблица
attachments(хранит размер, хэш SHA-256, MIME-тип, путь в S3) и связующая таблицаmessage_attachments. - Валидация изображений: Перед отправкой в S3 файл проверяется через библиотеку
Pillowна корректность формата (только JPEG/PNG) и ограничения (до 10 МБ, до 40 млн пикселей). - Безопасность: Файлы нельзя скачать напрямую из MinIO. API проверяет, является ли текущий пользователь участником чата, к которому привязан файл (иначе возвращается 404).
- Контракт Lab4: В ответах API добавлены обязательные поля
variants: [],attachment_ids(для сообщений) иupdated_at(для вложений).
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke (уровень 3/4) | python tests/smoke.py |
PASS. Тест загружает картинку, прикрепляет к сообщению, проверяет скачивание по SHA-256 и блокировку доступа для посторонних. | вывод консоли |
| Persistence (перезапуск) | python tests/resilience.py --mode persistence --action-script scripts/restart.cmd |
PASS. Метаданные и файлы выживают после перезапуска контейнеров. | лог теста |
| Работа MinIO | http://localhost:9001 (Web UI) |
В бакете attachments видны загруженные файлы. |
скриншот консоли |
| Защита от чужих | python tests/smoke.py |
От лица eve запрос GET /attachments/{id} возвращает 404 (она не в чате). |
лог теста |
Ограничения и следующие шаги
- Нет фоновой обработки: В рамках оценки 4 реализована только синхронная загрузка оригинального файла. Создание миниатюр (thumbnail), ресайз и фоновая обработка через брокер сообщений (worker) запланированы для лабораторной 5.
- Нет репликации MinIO: В текущей конфигурации используется один инстанс MinIO. При его падении загрузка и скачивание файлов станут недоступны (SPOF).
- Хранение файлов в оперативной памяти при загрузке: Файл целиком считывается в память (
await request.body()) перед отправкой в S3, что допустимо для лимита в 10 МБ, но не масштабируется для больших объемов.
==================================================================== НИЖЕ ТЕКСТ ДЛЯ ОПИСАНИЯ ПУЛЛ РЕКВЕСТА
Лабораторная 4
Автор / группа: Максимова Снежана Игоревна / БПИ2302 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен
Что реализовано и что перенесено Реализовано:
- Приватное S3-совместимое хранилище MinIO (конфигурация в Docker Compose).
- Загрузка, получение метаданных и скачивание вложений.
- Строгая валидация изображений (проверка MIME по содержимому через Pillow, лимит 10 МБ, лимит пикселей).
- Ограничение доступа: скачать файл может только участник чата.
- Привязка вложений к сообщениям через
attachment_ids(таблицаmessage_attachments). - Добавлены обязательные поля контракта:
variants: [],updated_atдля вложений.
Перенесено из предыдущей работы (lab3):
- API на FastAPI, Nginx, миграции Alembic.
- Горизонтальное масштабирование, идемпотентность.
Команды запуска из чистого clone
git clone https://gitea.privcloud.tech/kleprer/mtusi2026lab4.git
cd mtusi2026lab4
git checkout solution/БПИ2302-Максимова
python -c "import shutil; shutil.copy('.env.example', '.env')"
docker compose up -d --build --scale api=2
Результаты проверок и ссылка на REPORT.md
python tests/smoke.py— PASS (тест сам загружает файл, проверяет права доступа и скачивает с проверкой хэша).python tests/resilience.py --mode persistence— PASS (файлы и БД переживают перезапуск).- Сервис MinIO успешно инициализирует бакет и принимает файлы.
- Ссылка на подробный анализ: REPORT.md
Ограничения / известные ошибки
- Для оценки 4 (базовый уровень) создание миниатюр/thumbnail не реализовано, так как это относится к требованиям лабораторной 5.
- В текущей конфигурации MinIO запущен в одном экземпляре (без репликации).
- Из-за проблем с официальным реестром Docker Hub, образ MinIO подтягивается из публичного зеркала
dappros/minio.
Источники и использование ИИ FastAPI, SQLAlchemy, boto3, Pillow, MinIO, Nginx. ИИ использовался для генерации черновиков конфигураций и скриптов, финальный код проверен вручную.
- Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- Контракт и публичные тесты не ослаблены.
- make check и make test выполнены; приложен реальный вывод.
- Сценарии отказов/безопасности своего уровня воспроизведены (загрузка, проверка доступа).
- Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- README задания сохранён, REPORT.md содержит инструкцию именно моего решения.