5.9 KiB
Отчёт — лабораторная 4
- Автор, группа: Антоновва Екатерина бпи2304
- Целевая оценка: 4
- Выбранный трек 5: не заявлен
- Commit/PR: заполняется после публикации
Использованные источники, библиотеки и помощь ИИ
Использованы нормативные contracts/openapi.json, contracts/README.md, contracts/infrastructure.json, публичные тесты из tests/ и документация FastAPI, PostgreSQL, boto3, Pillow, SeaweedFS и Docker Compose. ИИ применялся как вспомогательный инструмент для проверки реализации, поиска ошибок и редактирования отчёта; итоговые решения проверены локальными тестами и запуском стенда.
Запуск из чистого clone
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
# дождаться: docker compose ps показывает healthy у postgres, s3, api1, api2 и load_balancer
make check
make validate
make test
make test-grade4
make test-attachments-load
Для остановки без удаления данных:
docker compose down
Для намеренного удаления учебных данных вместе с volumes:
docker compose down -v
Пароли находятся только в локальном .env, который исключён из Git. В текущей проверке Windows make отсутствовал, поэтому его цели выполнены эквивалентными командами с .venv\Scripts\python.exe; в Linux/CI используются команды Makefile.
Архитектура и решения
Клиент обращается к единственному публичному Nginx на localhost:8080. Балансировщик направляет запросы на api1 и api2; обе реплики используют одну PostgreSQL и один SeaweedFS с S3 API. Локального состояния сессий, сообщений и файлов в API нет: PostgreSQL хранит метаданные, а приватный bucket messenger-attachments — байты.
Вложение принимается потоково в SpooledTemporaryFile с лимитом 10 MiB, проверяются фактический PNG/JPEG, MIME, имя, SHA-256 и максимум 40 млн пикселей. Сначала выполняется S3 PUT, затем транзакционная запись метаданных; при ошибке БД выполняется компенсационный DELETE. scripts/reconcile_attachments.py поддерживает dry-run и удаление только orphan-объектов старше grace period.
S3 bootstrap идемпотентен. SeaweedFS имеет отдельные bootstrap- и API-credentials; API получает только права Read/Write/List/Tagging для нужного bucket, административная консоль наружу не публикуется. Миграция 004_allow_attachment_only_messages.sql сохраняет возможность сообщений, содержащих только вложение.
Доказательства критериев
| Критерий | Команда/сценарий | Результат |
|---|---|---|
| Контракт и OpenAPI | scripts/check_contract.py, scripts/validate_openapi.py |
PASS |
| Публичный smoke | tests/smoke.py / make test |
PASS: регистрация, сессии, чат, сообщение, upload/download и доступ участника |
| Ошибки уровня 4 | tests/grade4_attachments.py / make test-grade4 |
PASS: >10 MiB, повреждённый файл, MIME spoofing, опасное имя, чужой attachment и другой чат |
| Идемпотентный bootstrap | повторный docker compose up -d --build |
PASS, bucket и миграции не дублируются |
| Persistence | scripts/restart.sh без удаления volumes |
PASS: действующая сессия, метаданные и байты вложения сохранились |
| Failover | scripts/stop-one.sh, остановка обслужившей реплики |
PASS: download через вторую реплику вернул исходные байты |
| Частный bucket | API credentials и отсутствие публикации S3-порта | S3 доступен API внутри Compose, прямой публичный GET не используется |
Эксперимент потоковой загрузки
Запуск:
make test-attachments-load
Скрипт одновременно выполняет 10 загрузок, а Docker RSS API-реплик опрашивается во время эксперимента. Фактический результат текущего прогона сохранён в evidence/attachments-concurrency.txt: uploads=10, concurrency=10, elapsed_seconds=0.480, peak_api_rss_mb=84.2. Полный файл не удерживается в RAM: после 1 MiB SpooledTemporaryFile переходит на временный файл.
Ограничения
Проверен single-node Compose; отказ Docker-host, сетевой partition и HA PostgreSQL не заявляются. Компенсация закрывает обычный отказ записи метаданных, а периодическая сверка orphan-объектов запускается оператором, а не отдельным worker-процессом.