5.1 KiB
Лабораторная 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 не попадают.