Files
mtusi2026lab4/REPORT.md

5.1 KiB
Raw Permalink Blame History

Лабораторная 4 — отчёт

Мартинес Анастасия, БПИ2303. Целевая оценка: 4. Ветка: solution/bpi2303-martines.

Запуск

python scripts/bootstrap.py
docker compose config --quiet
docker compose up -d --build
python -X utf8 tests/smoke.py --base-url http://127.0.0.1:8080

Стенд содержит HAProxy, две API-реплики, PostgreSQL, Redis, MinIO и cleanup worker. Внешний API доступен только на 127.0.0.1:8080; S3 API локально опубликован для отрицательной проверки private bucket, административная консоль MinIO наружу не публикуется. Secrets генерируются в игнорируемой secrets/; docker compose down сохраняет данные, down -v удаляет учебные volumes намеренно.

Использованы Python 3.12.8, PostgreSQL 16.6, Redis 7.4.1, HAProxy 3.0.6, MinIO pinned digest, Flask/Gunicorn/Psycopg/Redis-py/Boto3/Pillow с pinned версиями. Контракт, README и публичные tests не менялись.

Архитектура и решения

Из lab3 сохранены общие сессии, LB, две реплики и idempotency. Метаданные attachment лежат в PostgreSQL, байты — в приватном S3 bucket messenger. API получает отдельные credentials с правами на object prefixes; root keys используются только bootstrap-контейнером. Filename используется для отображения, object key генерирует сервер.

Upload принимает только сырые PNG/JPEG, ограничивает тело 10 MiB до записи, проверяет MIME по содержимому и ограничивает 40 млн пикселей Pillow. Файл сначала пишется в S3, затем metadata — в БД. Таблица object_intents служит durable журналом намерения: cleanup удаляет старые unreferenced objects после grace period. Поэтому сбой между S3 и PostgreSQL не оставляет вечные orphan objects. Запись metadata и удаление intent происходят одной транзакцией. Download доступен только участнику чата и отдаёт байты через API, без redirect.

Составной message сохраняет attachment_ids; attachment другого чата, чужой attachment и failed attachment отвергаются до записи сообщения. Ограниченный semaphore и SpooledTemporaryFile не позволяют одной загрузке занять неограниченную RAM; 10 одновременных upload операций разрешены в пределах лимита.

Проверки

Публичный smoke:

PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.

Smoke проверяет upload 201 ready, checksum/size, авторизованный download, сообщение с attachment и отсутствие доступа у outsider. Дополнительный student-tests/attachments.py покрывает повреждённый файл, MIME spoof, опасное имя, >10 MiB, чужой ID, private bucket и 10 concurrent upload. Сценарии lab3 tests/resilience.py используются для persistence/failover; lab3 проверка до переноса дала: две реплики, 24 concurrent idempotent requests создали одну запись, отказ каждой реплики восстанавливался примерно за 1.1 с, rolling recreation сохранял подтверждённые сообщения.

Память контейнеров во время расширенной проверки сохраняется в evidence/attachment-resources.txt. Cleanup — dry-run по умолчанию и --apply --loop только внутри Compose. При сбое S3 API возвращает ограниченную ошибку; неавторизованный пользователь не узнаёт существование attachment.

Ограничения

Один MinIO/DB/LB и один Docker host остаются SPOF. Reconciliation удаляет только intents старше часа; аварийный orphan моложе grace period ожидает следующего прохода. Тест памяти зависит от ресурсов ноутбука и не является production SLA. HTTPS и mTLS относятся к lab7, исследовательский track 5 не заявлен.

Помощь ИИ: Codex подготовил реализацию, тесты, измерения и отчёт. Все fixtures синтетические; секреты, токены и private keys в Git не попадают.