forked from mtusi2026/mtusi2026lab4
47 lines
3.4 KiB
Markdown
47 lines
3.4 KiB
Markdown
## Лабораторная 4
|
||
|
||
Автор / группа: Никитин Андрей Александрович / БВТ2301
|
||
Целевая оценка (3/4/5): **5**
|
||
Трек 5, если заявлен: **трек 1 — прямой (presigned) upload**
|
||
|
||
Что реализовано и что перенесено:
|
||
- Lab3 → lab4: пользователи/чаты/сообщения, Redis-сессии, Idempotency-Key, LB ×2 API, graceful drain.
|
||
- Оценка 4: private MinIO, limited S3 creds, proxy `POST /attachments` (magic + stb_image), компенсация Put→PG / DeleteObject, `gc_orphans`, persistence/failover hooks, лимит concurrent uploads (RSS).
|
||
- Оценка 5 / трек 1: `direct_uploads` + presigned PUT (`minio-cpp` SigV4), complete (size/sha256/image), abort, GC незавершённых; proxy endpoint сохранён; сравнение RAM/трафика proxy vs direct (≥2 размера).
|
||
|
||
Команды запуска из чистого clone:
|
||
```sh
|
||
cp .env.example .env # локальные POSTGRES_*/MINIO_*/S3_BUCKET
|
||
mkdir -p secrets && # database_url, cache_url, s3_* (см. REPORT.md)
|
||
docker compose --env-file .env up -d --build
|
||
curl -fsS http://127.0.0.1:8080/health/ready
|
||
make check && make test BASE_URL=http://127.0.0.1:8080
|
||
sh student-tests/run_grade3.sh
|
||
sh student-tests/run_grade4.sh
|
||
sh student-tests/run_grade5_track1.sh
|
||
make test-persistence ACTION_SCRIPT=scripts/restart.sh
|
||
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
|
||
```
|
||
|
||
Результаты проверок и ссылка на REPORT.md:
|
||
- Подробности, таблицы доказательств и эксперимент трека 1: [`REPORT.md`](../REPORT.md).
|
||
- Student-tests grade3/4/5 track1 — PASS на локальном стенде.
|
||
- Evidence: `evidence/load_uploads.json`, `evidence/resilience_grade4.txt`, `artifacts/track1/results.tsv`.
|
||
- Ветка решения: `solution/nikitin-bvt2301`.
|
||
|
||
Ограничения / известные ошибки:
|
||
- Без `compose.presign.yaml` PUT к MinIO — с контейнера на сети compose (порты 9000/9001 на хост не публикуются).
|
||
- Complete direct-upload кратковременно GetObject'ит объект для verify (фаза отдельно от transfer).
|
||
- Нет HA БД/MinIO; нет thumbnail/вариантов (lab5); openapi расширений трека 1 нет (факультативный API).
|
||
|
||
Источники и использование ИИ:
|
||
- Контракт/тесты курса; PostgreSQL 16, Valkey, Nginx, MinIO, libpqxx 7.10.0, libsodium, hiredis, nlohmann/json, minio-cpp v0.3.0, stb_image.
|
||
- Помощь ИИ: Cursor (реализация, отладка, отчёт).
|
||
|
||
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
||
- [x] Контракт и публичные тесты не ослаблены.
|
||
- [x] make check и make test выполнены; приложен реальный вывод.
|
||
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
|
||
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
||
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|