Files
mtusi2026lab4-fork/REPORT.md
T
2026-11-04 21:38:34 +03:00

5.9 KiB
Raw Blame History

Отчёт — лабораторная 4

Автор: Григорян Илья Мурадович, БПИ2303. Целевая оценка: 4, трек 5 не заявлен.

Проверка: 04.11.2026, отдельный чистый стенд mtusi-messenger-lab4-test. Базовый commit: ec540a1a725862a8619fcb758daec4ad197f0dd5; проверено незакоммиченное рабочее дерево. Точный снимок — SHA-256 исходников, среда и команды — run.json. Исходники во время прогона не изменялись.

Запуск

Нужны Python 3.12, Docker и Compose. Из корня проекта:

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
make init
make up

Вход — http://localhost:8080. make init сохраняет существующие настройки и секреты. MinIO/mc собираются из закреплённых исходников; первая сборка требует интернета. Миграции и bootstrap выполняются до API. make down сохраняет данные.

Повтор полного прогона с сохранением evidence и удалением тестовых volumes:

.venv/bin/python -m scripts.collect_evidence

Реализация

Nginx → две FastAPI-реплики → PostgreSQL, Redis и приватный MinIO. Метаданные и связи вложений находятся в PostgreSQL, оригиналы — в MinIO. Сохранены общие сессии и идемпотентность lab3; сообщения поддерживают attachment_ids.

PNG/JPEG принимаются потоком во временный tmpfs, проверяются отдельным ограниченным процессом и сохраняются без перекодирования. 201 ready возвращается после PUT и COMMIT. До PUT фиксируется журнал загрузки; при сбое выполняется компенсация, при её отказе — повторная очистка после защитного интервала 24 часа. Готовые вложения не удаляются автоматически.

Проверки и результаты

188 pytest прошли за 73,96 с; контракт, OpenAPI и все сквозные сценарии завершились успешно. Исходный вывод — test-output.txt, методика — evidence/README.md, числа — metrics.json.

Требование Подтверждение
3: сохранён минимум lab3, общий стенд Две API, общие PostgreSQL/Redis/MinIO; 24 конкурентных повтора через две реплики создали одно сообщение.
3: вложения, SHA-256, авторизованный доступ Smoke прошёл: 201 ready, метаданные, сообщение с файлом, побайтный оригинал; постороннему 404.
3: PNG/JPEG и ограничения Проверены MIME, имя, повреждения, превышения и приём ровно 10 MiB / 40 млн пикселей.
3: сохранность и отказ загрузившей API Persistence и failover прошли с прежней сессией и тем же оригиналом; перезапуск всех работающих сервисов подтверждён PID/StartedAt.
4: негативные сценарии Слишком большой файл, повреждение, подмена MIME, неизвестный/чужой ID и файл другого чата дают предусмотренные 4xx.
4: согласованность S3/БД Проверены отмена, неопределённый COMMIT, реальный PUT с отказом метаданных, неудачная компенсация, grace period, dry-run и повтор очистки.
4: ограниченная память 3 серии по 10 запросов: 12 × 201, 18 × 429; пики выборок API — 154,9 / 156,1 MiB при лимите 1536 MiB.
4: приватность и bootstrap Повтор bootstrap ×2 сохраняет данные; прямые анонимные GET/PUT запрещены, credentials API ограничены, консоль недоступна из сети API.

Сохранённые проверки lab3 также прошли: SIGTERM, ресурсы/секреты, rolling update обеих API и последовательный отказ каждой. Восстановление записи — 1,865 / 2,042 с. Nginx отдельно проверен: nginx-output.txt. Тестовые контейнеры, сети и volumes удалены — cleanup.txt.

Границы результата

Один хост и один короткий синтетический прогон. PostgreSQL, Redis, MinIO и Nginx не реплицированы. 429 ограничителя и переходные 503 при отказах/обновлении учтены; подтверждённые сообщения и файлы сохранились. Память cgroup измерялась через 20 мс, включая дочерние процессы и tmpfs; накопительный kernel peak — до 156,1 MiB. Это не измерение предельного RPS. Использована помощь Codex; версии и первичные.