Автор / группа: Щербацевич Владислав Сергеевич, БПИ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 → 201status=ready после PUT и COMMIT;
GET метаданных и /content через авторизованный API без redirect, доступ только у участников чата;
attachment_ids в Message; пустой text допустим только с вложениями этого чата; прежние текстовые POST без поля остаются валидными;
лимиты до неограниченного чтения: ≤10 MiB, MIME по содержимому, ≤40 млн пикселей, отказ опасных имён;
компенсация: при сбое INSERT после S3 — DeleteObject; reaper gc с grace period не трогает объекты, на которые есть строка в БД.
Дождаться GET http://127.0.0.1:8080/health/ready → 200, затем:
set PYTHONUTF8=1py-3tests\smoke.py--base-urlhttp://127.0.0.1:8080py-3student-tests\attachments.pypy-3student-tests\s3_private.pypy-3student-tests\upload_mem.pypy-3student-tests\gc_orphans.pypy-3student-tests\level3.pypy-3student-tests\level4.pypy-3tests\resilience.py--modepersistence--action-scriptscripts\restart.cmd--base-urlhttp://127.0.0.1:8080py-3tests\resilience.py--modefailover--action-scriptscripts\stop-one.cmd--base-urlhttp://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 содержит инструкцию именно моего решения.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 4
Автор / группа: Щербацевич Владислав Сергеевич, БПИ2302
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: —
Что реализовано и что перенесено
Перенесён обязательный минимум lab3: HAProxy как публичный вход, не меньше двух API-реплик, PostgreSQL как источник истины, Redis (AOF) для сессий,
Idempotency-Keyдля POST сообщений, заголовокX-Instance-Id.В этой работе добавлены:
minio-init), отдельный ограниченный ключ для API, консоль наружу не публикуется;attachments/message_attachments, байты только в S3 (att/<uuid>), filename только для отображения;POST /api/v1/chats/{id}/attachments→ 201status=readyпосле PUT и COMMIT;GETметаданных и/contentчерез авторизованный API без redirect, доступ только у участников чата;attachment_idsв Message; пустойtextдопустим только с вложениями этого чата; прежние текстовые POST без поля остаются валидными;DeleteObject; reapergcс grace period не трогает объекты, на которые есть строка в БД.Публичные
tests/иcontracts/не менялись.Команды запуска из чистого clone
Секреты и
.envлокально, в Git их нет.Дождаться
GET http://127.0.0.1:8080/health/ready→ 200, затем:Остановка без удаления volumes:
docker compose --env-file .env down.Сброс учебных данных:
docker compose --env-file .env down -v.Инструкция и таблица критериев:
REPORT.md.Результаты проверок и ссылка на REPORT.md
make check/ публичный smoke — сценарий lab4 (checksum оригинала, 404 у постороннего).attachment_id, файл другого чата (student-tests/attachments.py).:9000не отдаёт объект (student-tests/s3_private.py).student-tests/upload_mem.py.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 и вложений.
Принято. Закрываю МР.
Pull request closed