ЛР 3 - БПИ2303 - Кимпаев - на 3 #96

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

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

Автор / группа: Кимпаев А.Р. / БПИ2303

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

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

Что реализовано и что перенесено

Из собственного решения ЛР2 перенесены исходники FastAPI, модели, маршруты, авторизация, PostgreSQL, миграции и необходимые зависимости.

В ЛР3 реализованы:

  • Две API-реплики api1 и api2.
  • Балансировщик Nginx с единой точкой входа.
  • Общие пользовательские сессии в PostgreSQL.
  • Заголовок X-Instance-Id.
  • Общая транзакционная идемпотентность через Idempotency-Key.
  • Отдельный сервис выполнения миграций.
  • Healthcheck и обработка отказов реплик.
  • Docker Compose и сценарии отказоустойчивости.
  • Windows-скрипты .cmd для запуска проверок в Git Bash.

Контракты, публичные тесты и файлы задания ЛР3 сохранены.

Команды запуска из чистого clone

sh scripts/setup.sh
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
docker compose ps
make check
make test

Проверка отказоустойчивости в Windows:

make test-failover ACTION_SCRIPT=scripts/stop-one.cmd

Восстановление реплик:

sh scripts/restore-replicas.sh

Проверка сохранности данных:

make test-persistence ACTION_SCRIPT=scripts/restart.cmd

Полная инструкция запуска — STUDENT_RUN.md.

Результаты проверок и ссылка на REPORT.md

Все основные проверки завершились успешно 04.11.2026.

Проверка Результат
Docker Compose PASS
make check PASS
make test PASS
test-failover PASS
test-persistence PASS
Ручная проверка отказа реплик Успешно

Результаты failover:

observed_instances_before: 2
successful_writes: 57
failed_attempts: 0
first_recovery_seconds: 1.219

PASS: failover preserved confirmed data and existing session.

Результат persistence:

PASS: persistence preserved confirmed data and existing session.

Результаты восстановления:

api1: healthy
api2: healthy
db: healthy
lb: running

Подробное описание реализации, команд и результатов: [REPORT.md](REPORT.md).

Ограничения / известные ошибки

  • PostgreSQL и Nginx не реплицированы и остаются едиными точками отказа.
  • Отказоустойчивость проверена на уровне отдельных API-реплик.
  • Полные нагрузочные исследования и rolling update уровня 4 не проводились.
  • Для Windows требуются .cmd-скрипты при запуске action hook через Python.
  • Известных ошибок, блокирующих прохождение выполненных проверок уровня 3, не выявлено.

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

Использованы материалы преподавателя (README.md, COURSE.md, CONTRIBUTING.md, контракты), собственное решение ЛР2 и документация используемых технологий.

ChatGPT применялся для помощи в реализации архитектуры, SQL-идемпотентности, скриптов и документации.

Проверки проведены локально в Docker Desktop.

Контрольный список

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; реальный вывод отражён в отчёте.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 **Автор / группа:** Кимпаев А.Р. / БПИ2303 **Целевая оценка (3/4/5):** 3 **Трек 5, если заявлен:** не заявлен. ### Что реализовано и что перенесено Из собственного решения ЛР2 перенесены исходники FastAPI, модели, маршруты, авторизация, PostgreSQL, миграции и необходимые зависимости. В ЛР3 реализованы: - Две API-реплики `api1` и `api2`. - Балансировщик Nginx с единой точкой входа. - Общие пользовательские сессии в PostgreSQL. - Заголовок `X-Instance-Id`. - Общая транзакционная идемпотентность через `Idempotency-Key`. - Отдельный сервис выполнения миграций. - Healthcheck и обработка отказов реплик. - Docker Compose и сценарии отказоустойчивости. - Windows-скрипты `.cmd` для запуска проверок в Git Bash. Контракты, публичные тесты и файлы задания ЛР3 сохранены. ### Команды запуска из чистого clone ```bash sh scripts/setup.sh docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build docker compose ps make check make test ``` Проверка отказоустойчивости в Windows: ```bash make test-failover ACTION_SCRIPT=scripts/stop-one.cmd ``` Восстановление реплик: ```bash sh scripts/restore-replicas.sh ``` Проверка сохранности данных: ```bash make test-persistence ACTION_SCRIPT=scripts/restart.cmd ``` Полная инструкция запуска — `STUDENT_RUN.md`. ### Результаты проверок и ссылка на REPORT.md Все основные проверки завершились успешно 04.11.2026. | Проверка | Результат | |---|---| | Docker Compose | PASS | | make check | PASS | | make test | PASS | | test-failover | PASS | | test-persistence | PASS | | Ручная проверка отказа реплик | Успешно | Результаты failover: ```text observed_instances_before: 2 successful_writes: 57 failed_attempts: 0 first_recovery_seconds: 1.219 PASS: failover preserved confirmed data and existing session. ``` Результат persistence: ```text PASS: persistence preserved confirmed data and existing session. ``` Результаты восстановления: ```text api1: healthy api2: healthy db: healthy lb: running ``` Подробное описание реализации, команд и результатов: [[REPORT.md](https://chatgpt.com/c/REPORT.md)](REPORT.md). ### Ограничения / известные ошибки - PostgreSQL и Nginx не реплицированы и остаются едиными точками отказа. - Отказоустойчивость проверена на уровне отдельных API-реплик. - Полные нагрузочные исследования и rolling update уровня 4 не проводились. - Для Windows требуются `.cmd`-скрипты при запуске action hook через Python. - Известных ошибок, блокирующих прохождение выполненных проверок уровня 3, не выявлено. ### Источники и использование ИИ Использованы материалы преподавателя (`README.md`, `COURSE.md`, `CONTRIBUTING.md`, контракты), собственное решение ЛР2 и документация используемых технологий. ChatGPT применялся для помощи в реализации архитектуры, SQL-идемпотентности, скриптов и документации. Проверки проведены локально в Docker Desktop. ### Контрольный список - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены; реальный вывод отражён в отчёте. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
kimpaev added 1 commit 2026-11-04 17:22:54 +03:00
Owner

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

Принято на 3 Закрываю МР
veprickiy closed this pull request 2026-11-04 18:46:32 +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/mtusi2026lab3#96