ЛР 4 - БПИ2302 - Щербацевич - на 4 #122

Closed
SAMURAI wants to merge 1 commits from SAMURAI/mtusi2026lab4:solution/bpi2302-shcherbatsevich into main
First-time contributor

Лабораторная 4

Автор / группа: Щербацевич Владислав Сергеевич, БПИ2302
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: —

Что реализовано и что перенесено

Перенесён обязательный минимум lab3: HAProxy как публичный вход, не меньше двух API-реплик, PostgreSQL как источник истины, Redis (AOF) для сессий, Idempotency-Key для POST сообщений, заголовок X-Instance-Id.

В этой работе добавлены:

  • MinIO в общем Compose, private bucket, идемпотентный bootstrap (minio-init), отдельный ограниченный ключ для API, консоль наружу не публикуется;
  • таблица attachments / message_attachments, байты только в S3 (att/<uuid>), filename только для отображения;
  • синхронный POST /api/v1/chats/{id}/attachments → 201 status=ready после PUT и COMMIT;
  • GET метаданных и /content через авторизованный API без redirect, доступ только у участников чата;
  • attachment_ids в Message; пустой text допустим только с вложениями этого чата; прежние текстовые POST без поля остаются валидными;
  • лимиты до неограниченного чтения: ≤10 MiB, MIME по содержимому, ≤40 млн пикселей, отказ опасных имён;
  • компенсация: при сбое INSERT после S3 — DeleteObject; reaper gc с grace period не трогает объекты, на которые есть строка в БД.

Публичные tests/ и contracts/ не менялись.

Команды запуска из чистого clone

Секреты и .env локально, в Git их нет.

powershell -File scripts/bootstrap.ps1
docker compose --env-file .env up -d --build --scale api=2

Дождаться GET http://127.0.0.1:8080/health/ready → 200, затем:

set PYTHONUTF8=1
py -3 tests\smoke.py --base-url http://127.0.0.1:8080
py -3 student-tests\attachments.py
py -3 student-tests\s3_private.py
py -3 student-tests\upload_mem.py
py -3 student-tests\gc_orphans.py
py -3 student-tests\level3.py
py -3 student-tests\level4.py
py -3 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://127.0.0.1:8080
py -3 tests\resilience.py --mode failover --action-script scripts\stop-one.cmd --base-url http://127.0.0.1:8080

Остановка без удаления volumes: docker compose --env-file .env down.
Сброс учебных данных: docker compose --env-file .env down -v.
Инструкция и таблица критериев: REPORT.md.

Результаты проверок и ссылка на REPORT.md

  • make check / публичный smoke — сценарий lab4 (checksum оригинала, 404 у постороннего).
  • Persistence/failover — тот же файл читается после restart и после остановки обслужившей реплики.
  • Негативы уровня 4 — слишком большой файл, битое изображение, подмена MIME, чужое attachment_id, файл другого чата (student-tests/attachments.py).
  • Private bucket — анонимный GET на :9000 не отдаёт объект (student-tests/s3_private.py).
  • 10 параллельных загрузок и пик RSS — student-tests/upload_mem.py.
  • Orphan GC — student-tests/gc_orphans.py.

Сводка, ограничения и команды: REPORT.md. Доказательства — evidence/ (без токенов и секретов).

Ограничения / известные ошибки

Один Docker-host: LB, PostgreSQL и MinIO — точки отказа. Скачивание только через API-прокси. Загрузка буферизуется в RAM с потолком 10 MiB на запрос. Presigned upload и async-варианты (lab5 / трек 5) не делались. GC не удаляет объекты моложе grace — короткий orphan после аварии между PUT и COMMIT допустим.

Источники и использование ИИ

FastAPI, SQLAlchemy/asyncpg, redis, argon2-cffi, boto3, Pillow, MinIO, HAProxy; перенос своей lab3; помощь ИИ при сборке S3/Compose и вложений.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 4 Автор / группа: Щербацевич Владислав Сергеевич, БПИ2302 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: — ### Что реализовано и что перенесено Перенесён обязательный минимум lab3: HAProxy как публичный вход, не меньше двух API-реплик, PostgreSQL как источник истины, Redis (AOF) для сессий, `Idempotency-Key` для POST сообщений, заголовок `X-Instance-Id`. В этой работе добавлены: - MinIO в общем Compose, private bucket, идемпотентный bootstrap (`minio-init`), отдельный ограниченный ключ для API, консоль наружу не публикуется; - таблица `attachments` / `message_attachments`, байты только в S3 (`att/<uuid>`), filename только для отображения; - синхронный `POST /api/v1/chats/{id}/attachments` → **201** `status=ready` после PUT и COMMIT; - `GET` метаданных и `/content` через авторизованный API **без redirect**, доступ только у участников чата; - `attachment_ids` в Message; пустой `text` допустим только с вложениями этого чата; прежние текстовые POST без поля остаются валидными; - лимиты до неограниченного чтения: ≤10 MiB, MIME по содержимому, ≤40 млн пикселей, отказ опасных имён; - компенсация: при сбое INSERT после S3 — `DeleteObject`; reaper `gc` с grace period не трогает объекты, на которые есть строка в БД. Публичные `tests/` и `contracts/` не менялись. ### Команды запуска из чистого clone Секреты и `.env` локально, в Git их нет. ```powershell powershell -File scripts/bootstrap.ps1 docker compose --env-file .env up -d --build --scale api=2 ``` Дождаться `GET http://127.0.0.1:8080/health/ready` → 200, затем: ```powershell set PYTHONUTF8=1 py -3 tests\smoke.py --base-url http://127.0.0.1:8080 py -3 student-tests\attachments.py py -3 student-tests\s3_private.py py -3 student-tests\upload_mem.py py -3 student-tests\gc_orphans.py py -3 student-tests\level3.py py -3 student-tests\level4.py py -3 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://127.0.0.1:8080 py -3 tests\resilience.py --mode failover --action-script scripts\stop-one.cmd --base-url http://127.0.0.1:8080 ``` Остановка без удаления volumes: `docker compose --env-file .env down`. Сброс учебных данных: `docker compose --env-file .env down -v`. Инструкция и таблица критериев: `REPORT.md`. ### Результаты проверок и ссылка на REPORT.md - `make check` / публичный smoke — сценарий lab4 (checksum оригинала, 404 у постороннего). - Persistence/failover — тот же файл читается после restart и после остановки обслужившей реплики. - Негативы уровня 4 — слишком большой файл, битое изображение, подмена MIME, чужое `attachment_id`, файл другого чата (`student-tests/attachments.py`). - Private bucket — анонимный GET на `:9000` не отдаёт объект (`student-tests/s3_private.py`). - 10 параллельных загрузок и пик RSS — `student-tests/upload_mem.py`. - Orphan GC — `student-tests/gc_orphans.py`. Сводка, ограничения и команды: **REPORT.md**. Доказательства — `evidence/` (без токенов и секретов). ### Ограничения / известные ошибки Один Docker-host: LB, PostgreSQL и MinIO — точки отказа. Скачивание только через API-прокси. Загрузка буферизуется в RAM с потолком 10 MiB на запрос. Presigned upload и async-варианты (lab5 / трек 5) не делались. GC не удаляет объекты моложе grace — короткий orphan после аварии между PUT и COMMIT допустим. ### Источники и использование ИИ FastAPI, SQLAlchemy/asyncpg, redis, argon2-cffi, boto3, Pillow, MinIO, HAProxy; перенос своей lab3; помощь ИИ при сборке S3/Compose и вложений. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
SAMURAI added 1 commit 2026-11-13 00:18:33 +03:00
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-20 21:31:14 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab4#122