73 lines
3.9 KiB
Markdown
73 lines
3.9 KiB
Markdown
## Лабораторная 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 содержит инструкцию именно моего решения.
|