ЛР 3 — БПИ2303 — Унру — на 3 #143

Closed
DeUnru wants to merge 1 commits from DeUnru/mtusi2026lab3:main into main
First-time contributor

Автор / группа: Унру Д.В., БПИ2303

Целевая оценка (3/4/5): 3

Трек 5, если заявлен: не заявлен

1. Перенесённый и новый функционал

Из lab2:

FastAPI API и миграции с собственными проверками.
PostgreSQL 17 (сущности пользователей, чатов, сообщений и общие Bearer-сессии).
Хеширование паролей Argon2id.
Redis 7.4 (кэширование публичных профилей).
Keyset-пагинация.

Добавлено в lab3:

Идемпотентность POST-запросов сообщений (окно 24 ч в PostgreSQL): уникальная область user/chat/key, канонический хэш, SELECT FOR UPDATE, атомарная запись сообщения и результата в одной транзакции. Повторный запрос с тем же ключом возвращает 201, с другим телом — 409, при 5xx выполняется rollback.
Заголовок X-Instance-Id во всех ответах API.

2. Инфраструктура и оркестрация

Балансировка (Nginx 1.28): upstream round-robin, резолвинг через Docker DNS, пассивные проверки доступности (max_fails / fail_timeout).
Масштабирование: две реплики одного Compose-сервиса api (без проброса host-портов и жёстких container_name).
Надёжность развёртывания:
Миграции вынесены в отдельный job.
Согласованы параметры readiness, DNS, таймаутов и обработки SIGTERM.
Заданы лимиты CPU/RAM, реализовано разделение на front- и data-сети.
Добавлены явные хуки stop-one / restart и поочерёдная замена контейнеров по стратегии start-first.

3. Запуск и результаты проверок

Команда чистого запуска: make up (подробности в разделе «Запуск из чистого clone» файла REPORT.md).
Статусы тестов:
Smoke-тесты, проверка персистентности и публичный failover — PASS.
14 авторских тестов и их повтор на чистых volumes — PASS.
Детали нагрузочных и отказоустойчивых проверок:
Идемпотентность: 8 одновременных повторов одного ключа через два реальных alias вернули одно сообщение; попытка с другим телом дала 409.
Failover контейнеров: при последовательной остановке каждого из двух исходных контейнеров запись возобновлялась в пределах 10 секунд после возврата хука; чтение известного сообщения (200 OK) успешно проверялось до восстановления target. В окнах отказов зафиксировано 400.056 / 401.166 RPS с одной ошибочной попыткой в каждом случае; 15 915 подтверждённых сообщений сохранены без дубликатов.
Graceful shutdown (SIGTERM): активный POST завершался статусом 201, новые TCP-соединения отклонялись при ещё живом процессе, exit 0 достигался за 1.9171 с.
Rolling update (start-first): замена обоих контейнеров новым образом (с другими IP) корректно подхвачена балансировщиком без его перезапуска (проверены container id и StartedAt). Сохранено 14 975 сообщений, 687.069 RPS, 1 ошибочная попытка в процессе замены.
Отдельная нагрузка (30 с): 24 559 успешных запросов, 0 ошибок, 814.97 RPS, перцентили задержек p50 / p95 / p99 = 4.03 / 5.822 / 47.235 мс.
Выводы и артефакты: логи и доказательства в каталоге evidence/, детальный разбор в REPORT.md.

4. Ограничения и известные особенности

Топология: один Docker-host, единичные экземпляры LB, PostgreSQL и Redis (отказ узла и HA базы данных не покрываются).
Миграции: сценарий Compose-rolling реализован явно с временной третьей репликой; в демонстрации менялась метка сборки при совместимых коде и схеме. Breaking migrations не тестировались.
Поведение при сбоях: во время переключений допустимы зафиксированные ошибки; автоматический повтор безопасен только для сообщений с неизменными key/body.
Безопасность и гигиена: отсутствует фоновая очистка истёкших сессий/ключей, нет TLS и rate limiting; Redis работает без пароля (внутри изолированной сети).
Подробности: раздел «Ограничения и следующие шаги» в REPORT.md.

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

Список библиотек и первичной документации приведён в REPORT.md.
Реализация выполнена совместно с Qwen: часть кода, тестов и текста отчёта написана с его помощью, итоговый результат верифицирован описанными прогонами.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
### Автор / группа: Унру Д.В., БПИ2303 ### Целевая оценка (3/4/5): 3 ### Трек 5, если заявлен: не заявлен ## 1. Перенесённый и новый функционал ### Из lab2: FastAPI API и миграции с собственными проверками. PostgreSQL 17 (сущности пользователей, чатов, сообщений и общие Bearer-сессии). Хеширование паролей Argon2id. Redis 7.4 (кэширование публичных профилей). Keyset-пагинация. ### Добавлено в lab3: Идемпотентность POST-запросов сообщений (окно 24 ч в PostgreSQL): уникальная область user/chat/key, канонический хэш, SELECT FOR UPDATE, атомарная запись сообщения и результата в одной транзакции. Повторный запрос с тем же ключом возвращает 201, с другим телом — 409, при 5xx выполняется rollback. Заголовок X-Instance-Id во всех ответах API. ## 2. Инфраструктура и оркестрация Балансировка (Nginx 1.28): upstream round-robin, резолвинг через Docker DNS, пассивные проверки доступности (max_fails / fail_timeout). Масштабирование: две реплики одного Compose-сервиса api (без проброса host-портов и жёстких container_name). Надёжность развёртывания: Миграции вынесены в отдельный job. Согласованы параметры readiness, DNS, таймаутов и обработки SIGTERM. Заданы лимиты CPU/RAM, реализовано разделение на front- и data-сети. Добавлены явные хуки stop-one / restart и поочерёдная замена контейнеров по стратегии start-first. ## 3. Запуск и результаты проверок Команда чистого запуска: make up (подробности в разделе «Запуск из чистого clone» файла [REPORT.md](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/mtusi2026lab3/REPORT.md)). Статусы тестов: Smoke-тесты, проверка персистентности и публичный failover — PASS. 14 авторских тестов и их повтор на чистых volumes — PASS. Детали нагрузочных и отказоустойчивых проверок: Идемпотентность: 8 одновременных повторов одного ключа через два реальных alias вернули одно сообщение; попытка с другим телом дала 409. Failover контейнеров: при последовательной остановке каждого из двух исходных контейнеров запись возобновлялась в пределах 10 секунд после возврата хука; чтение известного сообщения (200 OK) успешно проверялось до восстановления target. В окнах отказов зафиксировано 400.056 / 401.166 RPS с одной ошибочной попыткой в каждом случае; 15 915 подтверждённых сообщений сохранены без дубликатов. Graceful shutdown (SIGTERM): активный POST завершался статусом 201, новые TCP-соединения отклонялись при ещё живом процессе, exit 0 достигался за 1.9171 с. Rolling update (start-first): замена обоих контейнеров новым образом (с другими IP) корректно подхвачена балансировщиком без его перезапуска (проверены container id и StartedAt). Сохранено 14 975 сообщений, 687.069 RPS, 1 ошибочная попытка в процессе замены. Отдельная нагрузка (30 с): 24 559 успешных запросов, 0 ошибок, 814.97 RPS, перцентили задержек p50 / p95 / p99 = 4.03 / 5.822 / 47.235 мс. Выводы и артефакты: логи и доказательства в каталоге [evidence/](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/mtusi2026lab3/evidence), детальный разбор в [REPORT.md](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/mtusi2026lab3/REPORT.md). ## 4. Ограничения и известные особенности Топология: один Docker-host, единичные экземпляры LB, PostgreSQL и Redis (отказ узла и HA базы данных не покрываются). Миграции: сценарий Compose-rolling реализован явно с временной третьей репликой; в демонстрации менялась метка сборки при совместимых коде и схеме. Breaking migrations не тестировались. Поведение при сбоях: во время переключений допустимы зафиксированные ошибки; автоматический повтор безопасен только для сообщений с неизменными key/body. Безопасность и гигиена: отсутствует фоновая очистка истёкших сессий/ключей, нет TLS и rate limiting; Redis работает без пароля (внутри изолированной сети). Подробности: раздел «Ограничения и следующие шаги» в REPORT.md. ## 5. Источники и использование ИИ Список библиотек и первичной документации приведён в REPORT.md. Реализация выполнена совместно с Qwen: часть кода, тестов и текста отчёта написана с его помощью, итоговый результат верифицирован описанными прогонами. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
DeUnru added 1 commit 2026-11-13 00:33:21 +03:00
DeUnru closed this pull request 2026-11-13 01:12:58 +03:00

Pull request closed

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

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#143