3.9 KiB
Лабораторная 4
Автор / группа: Долда Кирилл / БПИ2301 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: Трек 2
Что реализовано и что перенесено:
Из lab3 перенесены PostgreSQL, Redis, Alembic, Bearer-токены, реплики, Idempotency-Key, лимиты CPU/RAM, X-Instance-Id.
Добавлены MinIO с приватным bucket, таблица attachments, поле attachment_ids в сообщениях, загрузка и скачивание файлов через API, проверки MIME, пикселей и размера, S3-пользователь api-user с ограниченными правами (не admin), reconciler для orphan и missing, тесты вложений, RAM-эксперимент, stream-limit, тесты grace period и используемых вложений.
Команды запуска из чистого clone:
1. Подготовка cp .env.example .env
2. Сборка и запуск docker compose up -d --build docker compose restart nginx
3. Ожидание готовности until curl -sf http://localhost:8080/health/ready
4. Миграции (однократно, до трафика) docker compose exec -w /app app1 alembic upgrade head
Bootstrap S3 проверка: docker compose exec minio sh -c 'mc alias set myminio http://localhost:9000 minioadmin minioadmin > /dev/null && mc admin user list myminio'
Ожидаемо: api-user, minioadmin
5. Остановка контейнера docker compose down
Результаты проверок и ссылка на REPORT.md:
-
make test — PASS: lab4 public API scenario.
-
make test-attachments — PASS (5/5)
-
make stream-limit — PASS: 100 МБ -> 413 за 0.10s, память не растёт.
-
make ram-experiment — 10/10 (201), avg 6.37 МБ, пик памяти app1 ~290 МБ / 512 МБ, OOM нет.
-
make reconcile-test — PASS: [ORPHAN] + [MISSING] в dry-run -> [DELETED] в execute -> повторный dry-run 0/0 (идемпотентность).
-
make grace-period-test — PASS: [SKIP] (1 сек < grace 10) -> [ORPHAN] (12 сек > grace 10) -> [DELETED].
-
make used-attachment-test — PASS
-
make reconcile-cost — 50 файлов / 1.012s (~2 мс/файл, линейная O(N)).
-
make private-bucket — 403 AccessDenied (bucket приватный).
-
make s3-user-check — api-user не admin: mc admin user add / mc admin policy attach / mc admin user remove -> Access Denied.
Ограничения / известные ошибки:
- Grace period в тестах — 10 секунд (в проде — 1 час: защита от удаления свежих загрузок, которые могут быть в процессе).
- Стоимость reconciler — 50 файлов / 1.012s (~2 мс/файл).
Источники и использование ИИ:
FastAPI, SQLAlchemy, asyncpg, Alembic, passlib[bcrypt], redis, psycopg2-binary, minio, filetype, Pillow, python-multipart, pytest, nginx:alpine, postgres:16-alpine, redis:7-alpine, pgsty/silo:latest
- [+] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [+] Контракт и публичные тесты не ослаблены.
- [+] make check и make test выполнены; приложен реальный вывод.
- [+] Сценарии отказов/безопасности своего уровня воспроизведены.
- [+] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [+] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.