Обновить REPORT.md
This commit is contained in:
@@ -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 не выполнялись.
|
||||
|
||||
Reference in New Issue
Block a user