lab4: S3, MinIO, reconciler, трек 2, README
This commit is contained in:
@@ -1,18 +1,72 @@
|
||||
## Лабораторная 4
|
||||
|
||||
Автор / группа: TODO
|
||||
Целевая оценка (3/4/5): TODO
|
||||
Трек 5, если заявлен: TODO
|
||||
Автор / группа: Долда Кирилл / БПИ2301
|
||||
Целевая оценка (3/4/5): 5
|
||||
Трек 5, если заявлен: Трек 2
|
||||
|
||||
Что реализовано и что перенесено: TODO
|
||||
Команды запуска из чистого clone: TODO
|
||||
Результаты проверок и ссылка на REPORT.md: TODO
|
||||
Ограничения / известные ошибки: TODO
|
||||
Источники и использование ИИ: TODO
|
||||
**Что реализовано и что перенесено:**
|
||||
|
||||
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
||||
- [ ] Контракт и публичные тесты не ослаблены.
|
||||
- [ ] make check и make test выполнены; приложен реальный вывод.
|
||||
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
|
||||
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
||||
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|
||||
Из 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 содержит инструкцию именно моего решения.
|
||||
|
||||
Reference in New Issue
Block a user