Лабораторная 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/.
Ограничения и известные ошибки: 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`.
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. Добавьте их, чтобы все контейнеры стенда запускались с явно заданными лимитами.
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.
Что сделано
Лабораторная 3 продолжает проект из ЛР2 и добавляет горизонтальное масштабирование и отказоустойчивость API.
Проверки
Исследовательский трек 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.Принято. Закрываю МР.
Pull request closed