Обновить REPORT.md

This commit is contained in:
2026-11-06 02:01:23 +03:00
parent 7088791d5c
commit ebf065aa8c
+2 -76
View File
@@ -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 не выполнялись.