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

64 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Известные дефекты
Найдены попутно, не исправлены без отдельной просьбы (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`).