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>
64 lines
4.9 KiB
Markdown
64 lines
4.9 KiB
Markdown
# Известные дефекты
|
||
|
||
Найдены попутно, не исправлены без отдельной просьбы (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`).
|