ЛР 3 — БВТ2304 — Борзов — на 5 #34

Closed
nikikiki19 wants to merge 3 commits from nikikiki19/mtusi2026lab3:solution/bvt2304-borzov into main
First-time contributor

Что сделано

Лабораторная 3 продолжает проект из ЛР2 и добавляет горизонтальное масштабирование и отказоустойчивость API.

  • четыре API-реплики за Nginx, наружу опубликован только LB;
  • общие PostgreSQL и Redis, отдельный одноразовый сервис миграций;
  • стабильный X-Instance-Id в ответах;
  • обязательный Idempotency-Key для сообщений; конкурентные повторы через разные реплики создают одну запись;
  • health/readiness, таймауты Nginx, graceful shutdown и CPU/RAM limits;
  • scripts/stop-one.sh для отказа одной реплики;
  • scripts/restart.sh для проверки сохранности volumes и scripts/rolling-update.sh для поочерёдной замены реплик.

Проверки

  • make check;
  • OpenAPI 3.1 и JSON Schema validation;
  • make test — public API smoke;
  • student-tests/idempotency.py — конкурентная идемпотентность и конфликт другого тела;
  • evidence/failover_all.py — остановка каждой из четырёх реплик, по 12 успешных записей после остановки;
  • test-persistence — подтверждены данные и действующая сессия после перезапуска;
  • rolling update под нагрузкой: 1970 успешных запросов, 0 ошибок за 25 секунд.

Исследовательский трек 1

В REPORT.md приведены гипотеза, методика, ограничения, таблицы и график. При фиксированных 2 CPU / 1 GB получено: 1 реплика — 398.948 RPS, 2 — 491.139 RPS, 4 — 517.044 RPS. Прирост при переходе с 2 к 4 репликам стал небольшим, что показывает насыщение общей PostgreSQL/LB. Для 4 реплик отдельная серия роста CPU до 4 дала 491.144 RPS против 269.722 RPS при 2 CPU. Исходные JSON и график находятся в evidence/.

Запуск и команды защиты описаны в REPORT.md. Секреты и .env в коммит не включены.
Полный отчёт: https://gitea.privcloud.tech/nikikiki19/mtusi2026lab3/src/branch/solution/bvt2304-borzov/REPORT.md

Сведения по шаблону MR

  • Автор / группа: Борзов Никита, БВТ2304.

  • Целевая оценка: 5.

  • Заявленный трек: трек 1 «Цена масштабирования».

  • Ограничения и известные ошибки: PostgreSQL, Redis и Nginx остаются единичными точками отказа; потеря Docker-host и удаление volumes не входят в модель эксперимента. Подробности приведены в REPORT.md.

  • Источники и использование ИИ: исходный каркас и требования лабораторной — репозиторий задания; проект ЛР2 использован как основа. ИИ применялся как помощник при разборе требований, подготовке и проверке кода, тесты и результаты запускались локально.

  • Обязательный минимум текущей и предыдущих работ сохранён.

  • Контракт и публичные тесты не ослаблены.

  • make check и make test выполнены.

  • Сценарии отказа и сохранности данных воспроизведены.

  • Секреты и приватные ключи находятся вне Git.

  • README.md задания сохранён, инструкция решения находится в REPORT.md.

## Что сделано Лабораторная 3 продолжает проект из ЛР2 и добавляет горизонтальное масштабирование и отказоустойчивость API. - четыре API-реплики за Nginx, наружу опубликован только LB; - общие PostgreSQL и Redis, отдельный одноразовый сервис миграций; - стабильный X-Instance-Id в ответах; - обязательный Idempotency-Key для сообщений; конкурентные повторы через разные реплики создают одну запись; - health/readiness, таймауты Nginx, graceful shutdown и CPU/RAM limits; - scripts/stop-one.sh для отказа одной реплики; - scripts/restart.sh для проверки сохранности volumes и scripts/rolling-update.sh для поочерёдной замены реплик. ## Проверки - make check; - OpenAPI 3.1 и JSON Schema validation; - make test — public API smoke; - student-tests/idempotency.py — конкурентная идемпотентность и конфликт другого тела; - evidence/failover_all.py — остановка каждой из четырёх реплик, по 12 успешных записей после остановки; - test-persistence — подтверждены данные и действующая сессия после перезапуска; - rolling update под нагрузкой: 1970 успешных запросов, 0 ошибок за 25 секунд. ## Исследовательский трек 1 В REPORT.md приведены гипотеза, методика, ограничения, таблицы и график. При фиксированных 2 CPU / 1 GB получено: 1 реплика — 398.948 RPS, 2 — 491.139 RPS, 4 — 517.044 RPS. Прирост при переходе с 2 к 4 репликам стал небольшим, что показывает насыщение общей PostgreSQL/LB. Для 4 реплик отдельная серия роста CPU до 4 дала 491.144 RPS против 269.722 RPS при 2 CPU. Исходные JSON и график находятся в evidence/. Запуск и команды защиты описаны в REPORT.md. Секреты и .env в коммит не включены. Полный отчёт: https://gitea.privcloud.tech/nikikiki19/mtusi2026lab3/src/branch/solution/bvt2304-borzov/REPORT.md ## Сведения по шаблону MR - Автор / группа: Борзов Никита, БВТ2304. - Целевая оценка: 5. - Заявленный трек: трек 1 «Цена масштабирования». - Ограничения и известные ошибки: PostgreSQL, Redis и Nginx остаются единичными точками отказа; потеря Docker-host и удаление volumes не входят в модель эксперимента. Подробности приведены в `REPORT.md`. - Источники и использование ИИ: исходный каркас и требования лабораторной — репозиторий задания; проект ЛР2 использован как основа. ИИ применялся как помощник при разборе требований, подготовке и проверке кода, тесты и результаты запускались локально. - [x] Обязательный минимум текущей и предыдущих работ сохранён. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены. - [x] Сценарии отказа и сохранности данных воспроизведены. - [x] Секреты и приватные ключи находятся вне Git. - [x] `README.md` задания сохранён, инструкция решения находится в `REPORT.md`.
nikikiki19 added 1 commit 2026-10-22 22:35:21 +03:00
nikikiki19 added 1 commit 2026-10-22 22:39:02 +03:00
nikikiki19 added 1 commit 2026-10-22 22:40:03 +03:00
Owner
  • app/main.py:120: регистрация с JSON-телом и Content-Type: text/plain возвращает 201 и создаёт пользователя. Добавьте проверку поддерживаемого типа содержимого до обработки тела и записи данных.
  • app/main.py:339: запрос создания чата с member_ids: ["<UUID пользователя>", []] вызывает 500. Вызов set(member_values) выполняется до проверки типов элементов и падает на вложенном списке. Сначала проверьте, что каждый элемент является строкой с корректным UUID, затем проверяйте дубликаты. Некорректный список должен давать 400 без создания чата.
  • compose.yaml:31: у сервиса migrate отсутствуют ограничения CPU и RAM. Добавьте их, чтобы все контейнеры стенда запускались с явно заданными лимитами.
- [app/main.py:120](https://gitea.privcloud.tech/nikikiki19/mtusi2026lab3/src/commit/c7836af1d8f5f8037793404c6ad7ac7743f82ad4/app/main.py#L120): регистрация с JSON-телом и Content-Type: text/plain возвращает 201 и создаёт пользователя. Добавьте проверку поддерживаемого типа содержимого до обработки тела и записи данных. - [app/main.py:339](https://gitea.privcloud.tech/nikikiki19/mtusi2026lab3/src/commit/c7836af1d8f5f8037793404c6ad7ac7743f82ad4/app/main.py#L339): запрос создания чата с member_ids: ["<UUID пользователя>", []] вызывает 500. Вызов set(member_values) выполняется до проверки типов элементов и падает на вложенном списке. Сначала проверьте, что каждый элемент является строкой с корректным UUID, затем проверяйте дубликаты. Некорректный список должен давать 400 без создания чата. - [compose.yaml:31](https://gitea.privcloud.tech/nikikiki19/mtusi2026lab3/src/commit/c7836af1d8f5f8037793404c6ad7ac7743f82ad4/compose.yaml#L31): у сервиса migrate отсутствуют ограничения CPU и RAM. Добавьте их, чтобы все контейнеры стенда запускались с явно заданными лимитами.
Owner

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

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

Pull request closed

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

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#34