6.9 KiB
6.9 KiB
Известные дефекты
Найдены попутно, не исправлены без отдельной просьбы (AGENTS.md). Исправленные удаляются отсюда, история — в git.
Исключения сверки покрытия ссылаются на evidence лабы 2
- Где:
student-tests/spec_coverage.py,EXCLUDED: сценарииchat-cache«Чтение из кэша», «Срок записи», «Временная база» (evidence/cache/hits.md),sessions«Токена нет в хранилище» иusers«Хэш в БД» (evidence/auth/passwords-and-tokens.md). - Что не так:
evidence/перенесён в лабу 3 без содержимого лабы 2 (AGENTS.md, карта кода), этих файлов в репозитории нет. Исключение называет способ проверки, но доказательства по ссылке нет. - Найдено: change
replicas-lb(2026-10-10). Ссылки двух сценариев рестарта (evidence/storage/test-persistence.md) этот change перевёл на свойevidence/replicas/test-persistence.md. - Предложение: снять те же проверки на стенде лабы 3 (
valkey-cliдля ключей и TTL кэша,psqlдля хэшей паролей и токенов) вevidence/cache/иevidence/auth/, либо сослаться на файлы репозитория лабы 2 с commit. Тестtest_coverage.pyсуществование файлов не проверяет.
SIGTERM во время старта реплики теряется
- Где:
Dockerfile(CMD ["python", "-m", "src"], процесс — PID 1),src/main.py(uvicorn.run). - Что не так: у PID 1 ядро не доставляет сигнал без обработчика, а
обработчики SIGTERM uvicorn ставит только на старте сервера, после
импорта приложения и до lifespan.
docker stopреплики, которая ещё стартует (первые ~1–2 с), теряет SIGTERM: Docker ждётstop_grace_period10 с и шлёт SIGKILL. Тем временем реплика успевает стать готовой и получать запросы через LB, а SIGKILL обрывает их. Найдено в apply changerolling-update(2026-10-11): неготовую новую реплику скрипт останавливал 10 с, и она 9 с былаUPв LB. - Обход в
scripts/rolling-update.sh: неготовая новая реплика убираетсяdocker rm -fпослеmaintеё слота (design changerolling-update, Risks). Штатные остановки (stop-one.sh, замена старой реплики) касаются уже запущенного процесса и не затронуты. - Предложение: ранний обработчик SIGTERM в
src/__main__.pyдо импорта приложения (выставить флаг, который uvicorn проверит после старта), либоinit: trueв compose (tini как PID 1 пересылает сигнал, а у Python без обработчика SIGTERM завершает процесс). Второе расходится сdocker.md(«сервер — PID 1»), поэтому решать отдельным change.
Профиль failover берёт события Docker из буфера демона
- Где:
bench/run.py,Bench.run_phase—stand.events(target_id, started - 5, ended + 1)(docker events --since … --until …после фазы). - Что не так: демон Docker хранит только последние 256 событий всех
контейнеров. Каждый
docker execдаёт три события (exec_create,exec_start,exec_die). Профильrollout, который много раз обращается к LB черезdocker exec, в первой самопроверке потерял события миграции и старых реплик (changerolling-update, design, решение 8). У фазыfailoverвызововdocker execв окне мало, и все прогоны до сих пор находили события. Но запас не измерен, и рост опроса (например, healthcheck реплик в профиле) может его съесть: тогда фаза падает с «docker events … not found». - Предложение: как в профиле
rollout— потокdocker eventsс фильтром контейнера или проекта, запущенный до фазы (Stand.project_events).
fill-connections роняет PostgreSQL стенда отказов в crash recovery
- Где:
student-tests/fault_hook.py,FILL_SHиCLEAR_FILL_SH(действияfill-connections/clear-connectionsтестаtest_connection_limit_reached). - Что не так:
FILL_SHзапускаетсяdocker compose exec -dи отвязываетpsql … &. Послеkillцикла и обрыва сессий эти процессы становятся сиротами, их наследует PID 1 контейнера — postmaster. Он считает их своими «untracked child process», и выход с ненулевым кодом (psqlполучил FATAL) для него — авария: «all server processes terminated; reinitializing», recovery и сброс статистикиpg_stat_database. Журнал PostgreSQL стенда отказов, 2026-10-11:untracked child process (PID 79) exited with exit code 2сразу послеclear-connections. Тесты проходят: к следующему тесту база уже поднята, а пулы API переподключаются. Но каждый прогонmake failure_checksперезапускает PostgreSQL посреди набора, и следующий тест видит пустую статистику и только что поднятую базу. - Найдено: change
scaling-improvement(2026-10-11), разбор шума тестаtest_pool_keeps_connections(журнал сlog_connections). - Предложение: запускать заполнение под отдельным init —
init: trueуpostgresвstudent-tests/failures.compose.yml(tini реапит сирот сам), либо держатьpsqlдетьми долгоживущегоsh(waitв концеFILL_SH,CLEAR_FILL_SHубивает группу процессов).