3.4 KiB
Лабораторная 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-cppSigV4), complete (size/sha256/image), abort, GC незавершённых; proxy endpoint сохранён; сравнение RAM/трафика proxy vs direct (≥2 размера).
Команды запуска из чистого clone:
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. - 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.yamlPUT к 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 (реализация, отладка, отчёт).
-
Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
-
Контракт и публичные тесты не ослаблены.
-
make check и make test выполнены; приложен реальный вывод.
-
Сценарии отказов/безопасности своего уровня воспроизведены.
-
Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
-
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.