ЛР 4 - БВТ2303 - Ситникова - на 4 #80

Closed
Daria_Sitnikova wants to merge 3 commits from Daria_Sitnikova/mtusi2026lab4:solution/bvt2303-sitnikova into main
First-time contributor

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

Автор / группа: Ситникова Дарья Евгеньевна / БВТ2303.
Целевая оценка: 4.
Трек на 5 не заявлен.

Реализация

Из lab3 перенесены две Go API-реплики за HAProxy, PostgreSQL, общие сессии, Redis-кэш и идемпотентность сообщений.

Добавлены приватный MinIO, миграции метаданных и связей вложений, синхронная загрузка PNG/JPEG, авторизованное скачивание оригинала и сообщения с attachment_ids. Проверяются содержимое, MIME, filename, пределы 10 MiB и 40 млн пикселей. Журнал намерений и повторная очистка с grace period 10 минут обрабатывают сбои между S3 и БД. API использует отдельные ограниченные S3 credentials; консоль и порты S3 наружу не открыты.

Запуск

Из корня клонированной ветки solution/bvt2303-sitnikova, при установленных Docker Desktop с Linux-контейнерами, Compose V2, Python 3.9+ и PowerShell:

./scripts/init-local.ps1
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait --wait-timeout 180
python -X utf8 scripts/check_contract.py
python -X utf8 tests/smoke.py --base-url http://127.0.0.1:8084

Секреты создаются локально. Остановка с сохранением данных: docker compose down.

Проверки

  • Сборка с go vet, Go-тестами и публичный smoke — PASS.
  • Upload/download, SHA-256, доступ участников, ошибочные файлы, точная граница bytes и привязка файла другого чата — PASS.
  • Шестнадцать конкурентных повторов сообщения через две API создают одну запись.
  • Failover каждой загрузившей API, restart всех компонентов с сохранением volumes и отказ/возврат S3 — PASS.
  • Компенсация после успешного PUT и отказа INSERT, прерывание HTTP, защита свежих/готовых объектов и повторная очистка — PASS.
  • Четыре профиля PNG/JPEG: по три серии из 10 одновременных загрузок; 120/120 успешных загрузок и проверенных скачиваний, без OOM и swap. Максимальный пик одной API — 1232,39 MiB при лимите 1536 MiB.
  • Опубликованная реализация 879463c проверена из чистого клона: новые секреты/volumes, пустая БД, сборка, функциональные проверки, private bucket, компенсация, failover и persistence. Исходники клона не изменялись. Нагрузка повторно в клоне не запускалась.

Команды, методика, результаты и ссылки на выводы: REPORT.md. Доказательства чистого запуска: источник, сборка, smoke, сохранность.

Ограничения

Один Docker-host; PostgreSQL, MinIO и LB не имеют резервирования. Измерения локальные и короткие, максимальная производительность не заявляется. Grace в тесте проверялся SQL-сдвигом возраста; потеря ответа COMMIT не внедрялась. Отметки abandoned хранятся бессрочно; полный bucket reconciler, TLS, presigned upload и обработка изображений из последующих лабораторных не реализованы. Linux-hooks отдельно не проверялись.

Источники и помощь

Контракт и публичные тесты курса, собственная lab3, официальная документация MinIO/minio-go, Docker, Go и Linux cgroup v2. Библиотеки закреплены в go.mod/go.sum. Codex использован при реализации, проверках и подготовке отчёта; подробный список источников приведён в REPORT.md.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • Эквиваленты make check и make test выполнены через Python; реальный вывод приложен в evidence.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию решения.
## Лабораторная 4 Автор / группа: Ситникова Дарья Евгеньевна / БВТ2303. Целевая оценка: 4. Трек на 5 не заявлен. ### Реализация Из lab3 перенесены две Go API-реплики за HAProxy, PostgreSQL, общие сессии, Redis-кэш и идемпотентность сообщений. Добавлены приватный MinIO, миграции метаданных и связей вложений, синхронная загрузка PNG/JPEG, авторизованное скачивание оригинала и сообщения с attachment_ids. Проверяются содержимое, MIME, filename, пределы 10 MiB и 40 млн пикселей. Журнал намерений и повторная очистка с grace period 10 минут обрабатывают сбои между S3 и БД. API использует отдельные ограниченные S3 credentials; консоль и порты S3 наружу не открыты. ### Запуск Из корня клонированной ветки `solution/bvt2303-sitnikova`, при установленных Docker Desktop с Linux-контейнерами, Compose V2, Python 3.9+ и PowerShell: ```powershell ./scripts/init-local.ps1 docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --wait --wait-timeout 180 python -X utf8 scripts/check_contract.py python -X utf8 tests/smoke.py --base-url http://127.0.0.1:8084 ``` Секреты создаются локально. Остановка с сохранением данных: `docker compose down`. ### Проверки - Сборка с `go vet`, Go-тестами и публичный smoke — PASS. - Upload/download, SHA-256, доступ участников, ошибочные файлы, точная граница bytes и привязка файла другого чата — PASS. - Шестнадцать конкурентных повторов сообщения через две API создают одну запись. - Failover каждой загрузившей API, restart всех компонентов с сохранением volumes и отказ/возврат S3 — PASS. - Компенсация после успешного PUT и отказа INSERT, прерывание HTTP, защита свежих/готовых объектов и повторная очистка — PASS. - Четыре профиля PNG/JPEG: по три серии из 10 одновременных загрузок; 120/120 успешных загрузок и проверенных скачиваний, без OOM и swap. Максимальный пик одной API — 1232,39 MiB при лимите 1536 MiB. - Опубликованная реализация `879463c` проверена из чистого клона: новые секреты/volumes, пустая БД, сборка, функциональные проверки, private bucket, компенсация, failover и persistence. Исходники клона не изменялись. Нагрузка повторно в клоне не запускалась. Команды, методика, результаты и ссылки на выводы: [REPORT.md](../REPORT.md). Доказательства чистого запуска: [источник](../evidence/clean-source.txt), [сборка](../evidence/clean-build.txt), [smoke](../evidence/clean-final-smoke.txt), [сохранность](../evidence/clean-resilience-summary.txt). ### Ограничения Один Docker-host; PostgreSQL, MinIO и LB не имеют резервирования. Измерения локальные и короткие, максимальная производительность не заявляется. Grace в тесте проверялся SQL-сдвигом возраста; потеря ответа COMMIT не внедрялась. Отметки abandoned хранятся бессрочно; полный bucket reconciler, TLS, presigned upload и обработка изображений из последующих лабораторных не реализованы. Linux-hooks отдельно не проверялись. ### Источники и помощь Контракт и публичные тесты курса, собственная lab3, официальная документация MinIO/minio-go, Docker, Go и Linux cgroup v2. Библиотеки закреплены в go.mod/go.sum. Codex использован при реализации, проверках и подготовке отчёта; подробный список источников приведён в REPORT.md. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] Эквиваленты make check и make test выполнены через Python; реальный вывод приложен в evidence. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию решения.
Daria_Sitnikova added 3 commits 2026-11-06 18:06:40 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-07 17:46:42 +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#80