diff --git a/REPORT.md b/REPORT.md index ea5f6c2f..09fa5f91 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,14 +1,11 @@ # Лабораторная №3 — Балансировка и отказ API-реплики -Автор: **Дугина Александра, БПИ2301**. Целевая оценка: **4**. Треки на 5 не выполнялись. -Работа выполнена локально 06.11.2026 (Москва; UTC-файлы датированы также 05.11 вечером). -Ветка `solution/BPI2301-Dugina`. Исходный HEAD lab3: `0ab3a341aa7ba32363ce43061d4ff02b1f2964af`. -Коммиты, staging и публикация не выполнялись: изменения оставлены для предварительной проверки. +Автор: **Дугина Александра, БПИ2301**. Целевая оценка: **4**. ## Запуск из чистого clone Нужны Docker Desktop с Compose v2, Python 3.11+ и make. На использованном Mac Python хоста — 3.13, контейнера — 3.11.16. -Все команды выполняются из **mtusi2026lab3**, соседняя lab2 не нужна. +Все команды выполняются из **mtusi2026lab3**. ```sh python3 -m venv .venv @@ -163,74 +160,3 @@ Rolling новым образом: обе замены заняли 3,447 и 6,2 Все пути доказательств в таблице относительны `evidence/`. HTTP-тесты не заменяют анализа конфигурации миграций/лимитов: оба вида доказательств приведены вместе. -## Ограничения, источники и ИИ - -Защищён отказ одного API-процесса. Host Docker Desktop, PostgreSQL, LB, Redis-volume/storage — одиночные компоненты; потеря узла/диска, HA БД, backup/restore и power-loss durability в этой работе не испытывались. Redis не критичен для авторизации, PostgreSQL критичен. Рестарт хранилищ даёт временную недоступность, persistence проверяет последующее сохранение данных, а не нулевой downtime. HTTP допустим здесь только на localhost с synthetic данными; TLS, распределённый секретный менеджер и multi-host не входят в объём. Идемпотентность без GC расходует место; нет удаления пользователей/чатов и динамического membership. Rolling не откатывает неработающий образ автоматически. Активный healthcheck не гарантирует отсутствие каждого запроса в переходный интервал. - -Основные материалы: README.md, COURSE.md, CONTRIBUTING.md, contracts/openapi.json, contracts/README.md и публичные проверки данного skeleton; исходники собственной lab2. Использованы библиотеки из requirements.txt и Docker-образы перечисленных версий. Codex/ИИ использован для переноса, реализации инфраструктуры и идемпотентности, написания собственных сценариев, запуска реальных тестов и подготовки отчёта. Числа взяты из запусков, результаты не моделировались. Публичные тесты/контракты не изменены. Окончательную оценку выставляет преподаватель. - -## Точечные исправления замечаний от 06.11.2026 - -Версия проверки: `fixes-20261106-threadpool-timeout`. Предыдущие таблицы и файлы -экспериментов выше относятся к прежнему коду и сохранены без перезаписи. Все новые -результаты — в `evidence/fixes-20261106/`, дата/параметры/SHA-256 конфигурации и -исходников — `metadata.json`, точный diff — `implementation.patch`. - -В `stop-one.sh` и `rolling-update.py` заменено `docker stop --time 6` на -`docker stop --timeout 6`, прежние таймаут и обработка ошибок сохранены. В новых -выводах остановки/замены предупреждения об устаревшем параметре не наблюдались. - -Аудит async handlers выявил синхронные SQL/Redis и Argon2 в event loop. Login стал -`def` и целиком выполняется FastAPI в worker. В регистрации хеширование и INSERT, -в создании чата проверка сессии и транзакция, в отправке сообщения проверки сессии -и доступа теперь явно ожидаются через `run_in_threadpool`. Атомарный -`insert_message` уже исполнялся в потоке и не изменён. Startup/shutdown ожидают -открытие/закрытие прежнего пула также в потоке; синхронные lifecycle callbacks -Starlette в отличие от sync HTTP endpoints автоматически туда не переносятся. -OpenAPI-файл загружается один раз до готовности API, аварийный logger.error -в middleware также перенесён в поток. Остальные async error handlers и read_json -не выполняют SQL/Redis/Argon2; явных Depends нет. Полный аудит — `async-audit.md`. - -Используется общий механизм Starlette/AnyIO, без нового executor на запрос. -Repository получает и возвращает соединение в рамках одного worker-вызова; -открытые connection/cursor между вызовами не передаются, транзакции не разделены. -Пул, SQL, commit/rollback и ограничения идемпотентности остались прежними. -Регрессионный `student-tests/test_event_loop.py` проверяет thread ID блокирующих -границ через ASGI: **7 failures на прежнем образе, 7 OK на исправленном**, включая -сохранение 503/request_id при исключении из worker. Это дополнено реальными -HTTP/БД-тестами; подмены regression test не применяются к работающему серверу. - -Все обязательные команды повторно прошли: `make check`, `make validate -PYTHON=.venv/bin/python`, `make test BASE_URL=http://localhost:8080`, -`make test-persistence ACTION_SCRIPT=scripts/restart.sh` и -`make test-failover ACTION_SCRIPT=scripts/stop-one.sh` (BASE_URL=тот же localhost). -24 конкурентных повтора через обе реплики снова дали один Message и одну копию -в истории; другие body/scope, сессии и права также проверены. Swagger UI и -семантическое равенство /openapi.json обязательному контракту подтверждены. - -| Новое испытание, 4 writers | Successful RPS | Успехи / ошибки | Доля ошибок | Восстановление | Потери подтверждений | -|---|---:|---:|---:|---:|---:| -| Отказ первой реплики | 159,853 | 2658 / 52 | 1,9188% | 2,327 с | 0 из 2659 | -| Отказ второй после восстановления первой | 181,418 | 2904 / 43 | 1,4591% | 1,792 с | 0 из 2905 | -| Последовательный rolling под нагрузкой | 234,740 | 3637 / 275 | 7,0297% | см. ниже | 0 из 3638 | - -Rolling: 1602 успешных запроса начаты во время action; максимальный промежуток -между успешными завершениями 0,998 с. Полный action двух замен занял 9,272 с, -это не длительность простоя. Обновлялся тот же исправленный образ; контейнеры -реально заменены по одному с готовым survivor. ID/StartedAt HAProxy, PostgreSQL -и Redis одинаковы до/после всех failover/rolling: они не останавливались этими -скриптами (`infrastructure-isolation.txt`). Persistence отдельно перезапустил -API и хранилища, сохранив подтверждённые данные и сессию. - -Дополнительные сопоставимые по команде короткие POST-нагрузки (15 с, concurrency=4, -одинаковые Compose-лимиты, новый synthetic чат на запуск) дали до/после: -493,781 / 436,912 RPS, p50 7,056 / 7,930 мс, p95 11,083 / 12,978 мс, -p99 38,780 / 42,866 мс, ошибок 0 / 0. **Улучшение задержек не подтверждено**: -в этих единичных запусках latency увеличилась. Полная БД росла, cache/VM не -изолировались; это не причинный эксперимент и не оценка предельной мощности. -Исправление подтверждает отсутствие SQL/Argon2 в event loop, а не обещает рост -POST throughput; переключения потоков сами добавляют накладные расходы. - -После тестов обе API, HAProxy, PostgreSQL и Redis healthy; мигратор Exited(0). -Публичные tests/contracts и .gitignore при этих исправлениях не изменялись. -Существующие незакоммиченные файлы сохранены; staging/commit/push/PR не выполнялись.