Files
mtusi2026lab3/KNOWN_ISSUES.md
T
ricoromaandClaude Opus 5.5 5403464cfb docs: add rolling-update compatibility and script failure evidence
Old image passes smoke and student tests on the new schema, rolling
update, rollback and roll forward under tests/load.py give zero failed
requests; the run_docker known issue is not reproduced and is closed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 01:01:33 +03:00

4.9 KiB
Raw Blame History

Известные дефекты

Найдены попутно, не исправлены без отдельной просьбы (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_period 10 с и шлёт SIGKILL. Тем временем реплика успевает стать готовой и получать запросы через LB, а SIGKILL обрывает их. Найдено в apply change rolling-update (2026-10-11): неготовую новую реплику скрипт останавливал 10 с, и она 9 с была UP в LB.
  • Обход в scripts/rolling-update.sh: неготовая новая реплика убирается docker rm -f после maint её слота (design change rolling-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, в первой самопроверке потерял события миграции и старых реплик (change rolling-update, design, решение 8). У фазы failover вызовов docker exec в окне мало, и все прогоны до сих пор находили события. Но запас не измерен, и рост опроса (например, healthcheck реплик в профиле) может его съесть: тогда фаза падает с «docker events … not found».
  • Предложение: как в профиле rollout — поток docker events с фильтром контейнера или проекта, запущенный до фазы (Stand.project_events).