ЛР 3 - БВТ2303 - Ситникова - на 4 #45

Closed
Daria_Sitnikova wants to merge 2 commits from Daria_Sitnikova/mtusi2026lab3:solution/bvt2303-sitnikova into main
First-time contributor

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

Автор / группа: Ситникова Дарья Евгеньевна / БВТ2303
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен

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

  • Из lab2 перенесены Go API, PostgreSQL, Bearer-сессии, Argon2id, keyset-пагинация, Redis-кэш, миграции и собственные тесты.
  • Запущены две API-реплики за HAProxy с общей БД и сессиями.
  • Добавлены X-Instance-Id, readiness-проверки и обновление backend-адресов через Docker DNS.
  • Реализована общая идемпотентность отправки сообщений: обязательный Idempotency-Key, срок 24 часа, защита от конкурентных дублей, конфликт при изменении текста.
  • Настроены таймауты, graceful shutdown и CPU/RAM-лимиты. Наружу опубликован только балансировщик.
  • Добавлены сценарии перезапуска, остановки выбранной API и поочерёдной замены контейнеров под нагрузкой.

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

 ./scripts/init-local.ps1
 docker compose --env-file .env config --quiet
 docker compose --env-file .env up -d --build --wait --wait-timeout 180
 make check test BASE_URL=http://127.0.0.1:8083 PYTHON="py -X utf8"
 py -X utf8 student-tests/replicas.py
 py -X utf8 tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8083
 py -X utf8 tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://127.0.0.1:8083
 docker compose up -d --wait 

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

  • make check/test и Go test/vet — PASS.
  • Один токен принят двумя API-репликами.
  • 16 параллельных запросов с одинаковым ключом создали одно сообщение.
  • После перезапуска стенда сохранены сообщение и прежняя сессия.
  • Проверен отказ каждой API с восстановлением между прогонами; подтверждённые сообщения сохранены, дубли не обнаружены.
  • При нагрузке с четырьмя клиентами: штатная работа — 214,314 успешных RPS; остановка API-1 — 203,505 RPS; остановка API-2 — 192,202 RPS.
  • Поочерёдная замена обеих API под нагрузкой — 202,120 RPS, 151 ошибка (1,4694%). Подтверждены смена container ID и сохранение работающей соседней реплики.
  • Выполнен запуск из чистого клона с новым паролем и пустым volume: сборка, миграции, make check/test, общие сессии, конкурентность и persistence — PASS.
  • В чистом клоне восстановление POST после отказа API-1/API-2 заняло 2,609/2,719 с. Исходники клона не редактировались.

Подробные команды, методика и доказательства:
https://gitea.privcloud.tech/Daria_Sitnikova/mtusi2026lab3/src/branch/solution/bvt2303-sitnikova/REPORT.md

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

  • Один Docker-host; PostgreSQL и HAProxy остаются единичными точками отказа.
  • При отказе и замене есть измеренные краткие ошибки; бесшовное обновление не заявляется.
  • Проверена замена контейнеров с тем же образом, а не совместимость разных версий приложения.
  • Миграции выполняются отдельно; смешанный запуск lab2/lab3 не поддерживается из-за различий идемпотентности.
  • HTTP и упрощённые настройки доступа предназначены для локального стенда с синтетическими данными.
  • Фоновая очистка истёкших сессий и ключей не реализована.
  • Linux-обёртки .sh подготовлены, но проверены Windows-обёртки .cmd.
  • Нагрузочные прогоны единичные; нагрузка и поочерёдная замена повторно в чистом клоне не запускались.

Источники и использование ИИ:
Задание и контракт lab3, реализация lab2, документация Docker Compose и HAProxy. Библиотеки: pgx, go-redis, golang.org/x/crypto.
Codex для помощи с реализацией, объяснениями, проверками и подготовкой отчёта.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 Автор / группа: Ситникова Дарья Евгеньевна / БВТ2303 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен Что реализовано и что перенесено: - Из lab2 перенесены Go API, PostgreSQL, Bearer-сессии, Argon2id, keyset-пагинация, Redis-кэш, миграции и собственные тесты. - Запущены две API-реплики за HAProxy с общей БД и сессиями. - Добавлены X-Instance-Id, readiness-проверки и обновление backend-адресов через Docker DNS. - Реализована общая идемпотентность отправки сообщений: обязательный Idempotency-Key, срок 24 часа, защита от конкурентных дублей, конфликт при изменении текста. - Настроены таймауты, graceful shutdown и CPU/RAM-лимиты. Наружу опубликован только балансировщик. - Добавлены сценарии перезапуска, остановки выбранной API и поочерёдной замены контейнеров под нагрузкой. Команды запуска из чистого clone: ```powershell ./scripts/init-local.ps1 docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --wait --wait-timeout 180 make check test BASE_URL=http://127.0.0.1:8083 PYTHON="py -X utf8" py -X utf8 student-tests/replicas.py py -X utf8 tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8083 py -X utf8 tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://127.0.0.1:8083 docker compose up -d --wait ``` Результаты проверок и ссылка на REPORT.md: - make check/test и Go test/vet — PASS. - Один токен принят двумя API-репликами. - 16 параллельных запросов с одинаковым ключом создали одно сообщение. - После перезапуска стенда сохранены сообщение и прежняя сессия. - Проверен отказ каждой API с восстановлением между прогонами; подтверждённые сообщения сохранены, дубли не обнаружены. - При нагрузке с четырьмя клиентами: штатная работа — 214,314 успешных RPS; остановка API-1 — 203,505 RPS; остановка API-2 — 192,202 RPS. - Поочерёдная замена обеих API под нагрузкой — 202,120 RPS, 151 ошибка (1,4694%). Подтверждены смена container ID и сохранение работающей соседней реплики. - Выполнен запуск из чистого клона с новым паролем и пустым volume: сборка, миграции, make check/test, общие сессии, конкурентность и persistence — PASS. - В чистом клоне восстановление POST после отказа API-1/API-2 заняло 2,609/2,719 с. Исходники клона не редактировались. Подробные команды, методика и доказательства: https://gitea.privcloud.tech/Daria_Sitnikova/mtusi2026lab3/src/branch/solution/bvt2303-sitnikova/REPORT.md Ограничения / известные ошибки: - Один Docker-host; PostgreSQL и HAProxy остаются единичными точками отказа. - При отказе и замене есть измеренные краткие ошибки; бесшовное обновление не заявляется. - Проверена замена контейнеров с тем же образом, а не совместимость разных версий приложения. - Миграции выполняются отдельно; смешанный запуск lab2/lab3 не поддерживается из-за различий идемпотентности. - HTTP и упрощённые настройки доступа предназначены для локального стенда с синтетическими данными. - Фоновая очистка истёкших сессий и ключей не реализована. - Linux-обёртки .sh подготовлены, но проверены Windows-обёртки .cmd. - Нагрузочные прогоны единичные; нагрузка и поочерёдная замена повторно в чистом клоне не запускались. Источники и использование ИИ: Задание и контракт lab3, реализация lab2, документация Docker Compose и HAProxy. Библиотеки: pgx, go-redis, golang.org/x/crypto. Codex для помощи с реализацией, объяснениями, проверками и подготовкой отчёта. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Daria_Sitnikova added 2 commits 2026-10-23 18:31:50 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-24 16:17:04 +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#45