ЛР3 - БВТ2302 - Осокин - на 4 #91

Closed
glebossokin wants to merge 1 commits from glebossokin/mtusi2026lab3:solution/BVT2302-Osokin into main
First-time contributor

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

Автор / группа: Осокин Глеб / БВТ2302, Gitea glebossokin.

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

Трек 5, если заявлен: не заявлен, задания уровня 5 не выполнялись.

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

  • Из собственной lab2 перенесены REST API, PostgreSQL с миграциями, Redis-сессии с TTL/AOF, scrypt и keyset-пагинация.
  • Стенд Docker Compose: две реплики одного API-сервиса за HAProxy, общие PostgreSQL и Redis, единственный публичный вход через LB.
  • Добавлены X-Instance-Id и общая идемпотентность сообщений: Idempotency-Key, транзакция PostgreSQL, удержание результата минимум 24 часа; конкурентные повторы через разные API создают одно сообщение.
  • Настроены readiness, Docker DNS, timeouts, обработка SIGTERM, CPU/RAM-лимиты и приватные API-порты. Миграции выполняются отдельным сервисом с блокировкой.
  • Подготовлены restart/stop-one hooks, проверки отказа каждой API с восстановлением предыдущей и поочерёдная замена контейнеров под нагрузкой.

Команды запуска из чистого clone (PowerShell, работающий Docker Desktop с Linux containers):

python -X utf8 scripts/bootstrap.py
docker compose --env-file .env up -d --build --wait
python -X utf8 scripts/verify.py

Linux: python3 scripts/bootstrap.py, docker compose --env-file .env up -d --build --wait, make verify. Bootstrap создаёт локальные secrets и .env, которые исключены из Git. Безопасная остановка — docker compose down, без удаления volumes.

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

  • Offline check и публичный smoke: PASS; smoke повторно выполнен перед публикацией.
  • Persistence после перезапуска API, PostgreSQL, Redis и LB: PASS с прежней сессией и сохранёнными данными.
  • Public failover: PASS, наблюдались две API; в исходном прогоне 112 успешных записей, 2 ошибки, первое восстановление 1.852 s.
  • 16 конкурентных запросов с одним ключом к двум реальным API-процессам: один Message; также проверены конфликт тела, независимые области ключа и logout.
  • В повторных нагрузочных проверках отказа каждой API: 58.005 и 61.424 успешных GET/POST в секунду, 73/1938 и 50/2024 ошибок соответственно; первые успешные read/write после stop менее 2 s.
  • Повторная поочерёдная замена обоих API: 46.956 успешных операций/s, 103/1620 ошибок. Подтверждённых потерь и дубликатов — 0 во всех сохранённых сценариях.
  • Сборка из чистого локального clone с новыми secrets и отдельными volumes: smoke и конкурентная идемпотентность PASS.

REPORT.md: запуск, решения, методика, измерения и ограничения. Raw timings, CPU/RAM и доказательства реальных остановок/замен — в evidence/. Исходные перезаписанные результаты первого прогона сохранены в evidence/baseline/.

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

  • Один Docker-host; единственные LB, PostgreSQL и Redis остаются едиными точками отказа.
  • Краткие ошибки обнаружения отказа и замены контейнеров измерены; бесшовное обновление без ошибок не заявляется. Неопределённый POST сообщения повторяется с исходным ключом.
  • Проверена последовательная замена контейнеров одной версии образа. Миграция 002 аддитивная; первичный переход с lab2 требует остановки старой версии, поскольку смешанный приём не гарантирует новую идемпотентность.
  • Нет автоматического rollback образа и периодической очистки истёкших ключей; гарантия повторов минимум 24 часа. Нагрузочные результаты — короткие прогоны на одном ноутбуке.

Источники и использование ИИ: собственное решение lab2, skeleton текущей лабораторной, официальные Docker/HAProxy/PostgreSQL/Redis/Python/psycopg docs. Codex использовался при подготовке реализации, собственных тестов, проверок и отчёта; источники перечислены в REPORT.md.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены эквивалентными Python-командами на Windows; приложен реальный вывод.
  • Сценарии отказов своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: **Осокин Глеб / БВТ2302**, Gitea `glebossokin`. Целевая оценка (3/4/5): **4**. Трек 5, если заявлен: **не заявлен, задания уровня 5 не выполнялись**. Что реализовано и что перенесено: - Из собственной lab2 перенесены REST API, PostgreSQL с миграциями, Redis-сессии с TTL/AOF, scrypt и keyset-пагинация. - Стенд Docker Compose: две реплики одного API-сервиса за HAProxy, общие PostgreSQL и Redis, единственный публичный вход через LB. - Добавлены X-Instance-Id и общая идемпотентность сообщений: Idempotency-Key, транзакция PostgreSQL, удержание результата минимум 24 часа; конкурентные повторы через разные API создают одно сообщение. - Настроены readiness, Docker DNS, timeouts, обработка SIGTERM, CPU/RAM-лимиты и приватные API-порты. Миграции выполняются отдельным сервисом с блокировкой. - Подготовлены restart/stop-one hooks, проверки отказа каждой API с восстановлением предыдущей и поочерёдная замена контейнеров под нагрузкой. Команды запуска из чистого clone (PowerShell, работающий Docker Desktop с Linux containers): ```powershell python -X utf8 scripts/bootstrap.py docker compose --env-file .env up -d --build --wait python -X utf8 scripts/verify.py ``` Linux: `python3 scripts/bootstrap.py`, `docker compose --env-file .env up -d --build --wait`, `make verify`. Bootstrap создаёт локальные secrets и .env, которые исключены из Git. Безопасная остановка — `docker compose down`, без удаления volumes. Результаты проверок и ссылка на REPORT.md: - Offline check и публичный smoke: PASS; smoke повторно выполнен перед публикацией. - Persistence после перезапуска API, PostgreSQL, Redis и LB: PASS с прежней сессией и сохранёнными данными. - Public failover: PASS, наблюдались две API; в исходном прогоне 112 успешных записей, 2 ошибки, первое восстановление 1.852 s. - 16 конкурентных запросов с одним ключом к двум реальным API-процессам: один Message; также проверены конфликт тела, независимые области ключа и logout. - В повторных нагрузочных проверках отказа каждой API: 58.005 и 61.424 успешных GET/POST в секунду, 73/1938 и 50/2024 ошибок соответственно; первые успешные read/write после stop менее 2 s. - Повторная поочерёдная замена обоих API: 46.956 успешных операций/s, 103/1620 ошибок. Подтверждённых потерь и дубликатов — 0 во всех сохранённых сценариях. - Сборка из чистого локального clone с новыми secrets и отдельными volumes: smoke и конкурентная идемпотентность PASS. [REPORT.md: запуск, решения, методика, измерения и ограничения](https://gitea.privcloud.tech/glebossokin/mtusi2026lab3/src/branch/solution/BVT2302-Osokin/REPORT.md). Raw timings, CPU/RAM и доказательства реальных остановок/замен — в [evidence/](https://gitea.privcloud.tech/glebossokin/mtusi2026lab3/src/branch/solution/BVT2302-Osokin/evidence). Исходные перезаписанные результаты первого прогона сохранены в evidence/baseline/. Ограничения / известные ошибки: - Один Docker-host; единственные LB, PostgreSQL и Redis остаются едиными точками отказа. - Краткие ошибки обнаружения отказа и замены контейнеров измерены; бесшовное обновление без ошибок не заявляется. Неопределённый POST сообщения повторяется с исходным ключом. - Проверена последовательная замена контейнеров одной версии образа. Миграция 002 аддитивная; первичный переход с lab2 требует остановки старой версии, поскольку смешанный приём не гарантирует новую идемпотентность. - Нет автоматического rollback образа и периодической очистки истёкших ключей; гарантия повторов минимум 24 часа. Нагрузочные результаты — короткие прогоны на одном ноутбуке. Источники и использование ИИ: собственное решение lab2, skeleton текущей лабораторной, официальные Docker/HAProxy/PostgreSQL/Redis/Python/psycopg docs. Codex использовался при подготовке реализации, собственных тестов, проверок и отчёта; источники перечислены в REPORT.md. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены эквивалентными Python-командами на Windows; приложен реальный вывод. - [x] Сценарии отказов своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
glebossokin added 1 commit 2026-11-02 20:58:48 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-13 21:47: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
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#91