10 KiB
Proposal
Why
Лаба 3 закрыта, но в KNOWN_ISSUES.md остались пять записей. Две из
них — дефекты поведения. Реплика, остановленная в первую секунду
старта, теряет SIGTERM и через 10 с получает SIGKILL;
scripts/rolling-update.sh обходит это docker rm -f. make failure_checks посреди набора роняет PostgreSQL своего стенда в crash
recovery. Третья запись — дыра в доказательствах: пять исключений
сверки покрытия ссылаются на evidence лабы 2, которого в этом
репозитории нет. Ещё две — хрупкость стенда bench/: профиль failover
берёт события Docker из буфера демона (256 событий, запас около двух
раз), а поле паспорта swapouts_delta пропадает при нулевом счётчике
выгрузок. Пользователь попросил исправить всё, что можно, до переноса
кода в лабу 4: дефекты переехали бы вместе с кодом.
What Changes
- Исключения сверки покрытия — доказательства лабы 3.
- Сценарии
chat-cache«Чтение из кэша», «Срок записи», «Временная база»,sessions«Токена нет в хранилище» иusers«Хэш в БД» проверяются заново на стенде лабы 3 (HAProxy и две реплики). - Проверки делают две новые команды драйвера скилла
run-mtusi-messenger:cache-checkиauth-storage. Результаты — вevidence/cache/hits.mdиevidence/auth/passwords-and-tokens.md, только факты, счётчики и префиксы, без токенов, паролей и полных хэшей. - Исключения называют эти команды.
- Сверка покрытия падает, если исключение ссылается на файл
evidence/, которого нет в репозитории.
- Сценарии
- SIGTERM на старте реплики больше не теряется.
- Точка входа
python -m srcдо импорта приложения ставит свой обработчик SIGTERM и SIGINT. Пока сервер не стартовал, запросов нет, и процесс завершается сразу: код 0, одна запись журналаinfo. - Сигнал во время старта сервера и остановка работающей реплики
обрабатываются как раньше. Сервер по-прежнему PID 1, без
init. rolling-update.shубирает неготовую новую реплику со слотом LB штатной остановкой послеmaint.docker rm -fостаётся для реплики без слота.- Воспроизведение «до/после» — новая команда драйвера
stop-at-start.
- Точка входа
- События фазы
failover— поток. События реплики фазы читаются потокомdocker events, запущенным до нагрузки фазы, как у профиляrollout, а не из буфера демона после фазы. - PostgreSQL стенда отказов без аварий.
- У
postgresвstudent-tests/failures.compose.yml—init: true: сиротpsqlизfill-connectionsподбирает init, а не postmaster. make failure_checksперед уборкой проверяет журнал PostgreSQL стенда и падает на признаках аварийного перезапуска.
- У
swapouts_deltaпри нулевом счётчике. Паспорт метки пишет прирост выгрузок и тогда, когда счётчик в конце равен 0.- Регрессия на новом коде — смоук, собственные тесты, проверки
отказов, failover, persistence,
make rolling_updateпод нагрузкой, быстрые профили. Плюс повтор проверки из чистого clone: код приложения меняется после итоговой проверки (dbb9150). - Документы:
KNOWN_ISSUES.mdбез исправленных записей;REPORT.md,AGENTS.md;- правила
.claude/rules/; SKILL.mdдрайвера.
Non-goals
- Окно запуска интерпретатора. В первые десятки миллисекунд, до
первых строк точки входа, SIGTERM процессу с PID 1 по-прежнему не
доставляется:
docker stopв этот миг ждёт 10 с и SIGKILL. Закрыть это окно может только init-процесс, а он противоречит.claude/rules/docker.mdи спекуcontainer-image(«Сервер — основной процесс контейнера»). Вrolling-update.shэто окно обходится: реплику без слота LB скрипт убираетdocker rm -f, запросов на ней нет. - Метки
failover/baselineиfailover/resourcesне переснимаются. События в них найдены, а величины фазы зависят только от отметок тех же событий демона. Способ чтения их не меняет: это проверяется сверкой обоих способов на одном прогоне (design). - Паспорта меток
scaling-db-aa2,scaling-db-before2,scaling-db-nooverflow2не правятся. Это измеренное состояние;Swapouts0 в начале и в конце в них записаны. Отсутствие поля оговаривается вREPORT.md. - Профиль
rolloutне меняется: он уже читает события потоком. - Evidence лабы 2 не копируется, и ссылок на репозиторий лабы 2 нет. У лабы 3 другой стенд (LB, две реплики, общий Valkey), и каждая лаба держит свои доказательства.
Capabilities
New Capabilities
Нет.
Modified Capabilities
graceful-shutdown: новое требование «Остановка во время старта» — сигнал до старта сервера и во время старта не теряется, сроки, код выхода, запись журнала.student-tests: новые требования:- «Доказательства исключений сверки в репозитории» — файл, на который ссылается исключение, есть в репозитории лабы, снят на её стенде и без секретов; иначе сверка падает;
- «PostgreSQL стенда отказов без аварийных перезапусков» — проверки
не роняют PostgreSQL стенда,
make failure_checksпроверяет его журнал.
load-benchmark: новое требование «События Docker профилей отказа и замены» — поток, запущенный до нагрузки, без зависимости от истории демона.
Не меняются:
chat-cache,sessions,users: сценарии те же, меняется только доказательство исключений;load-balancing: «Сбой поочерёдной замены» выполняется по-прежнему, неготовая новая реплика удаляется;service-logging: запись ранней остановки — JSON сtimestamp,level,eventиinstance_id;container-image: сервер — по-прежнему PID 1.
Impact
- Приложение:
src/__main__.py, новый модуль вsrc/infra/(только stdlib), lifespan вsrc/main.py. Контракт, API,Dockerfileи compose рабочего стенда не меняются. - Скрипты:
scripts/rolling-update.sh, функцияremove_new. - Тесты и стенд отказов:
student-tests/spec_coverage.py,test_coverage.py;run_failures.py,failures.compose.yml;fault_hook.py— только комментарии.
- Стенд
bench/:run.py— профильfailoverи паспорт. Методика меток не меняется. - Драйвер скилла: команды
stop-at-start,cache-check,auth-storage,SKILL.md. - Evidence:
- новые:
evidence/cache/hits.md,evidence/auth/passwords-and-tokens.md,evidence/failover/stop-at-start.md,evidence/tests/fix-known-issues-checks.md; - переписывается:
evidence/tests/clean-clone-final.md.
- новые:
- Документы:
REPORT.md,AGENTS.md,KNOWN_ISSUES.md, правилаdocker.md,run-modes.md,logging.md,infra.md,balancer.md,student-tests.md,bench.md. - Рабочий стенд:
- новый код — через
make rolling_update, без простоя; - итоговая проверка из чистого clone удаляет его данные (
down -v), как в прошлый раз, и поднимает заново.
- новый код — через
- Следующая лаба: сверка покрытия упадёт, пока доказательства
исключений не сняты на её стенде. Это намеренно, а переснять их — по
команде на файл (
AGENTS.md, «Переход в следующую лабу»). - Время:
- четыре быстрых профиля
failoverи одинrollout— ~12 мин; make failure_checksчетыре раза — ~5 мин;make test_isolatedдважды — ~2 мин;- проверка из чистого clone — ~25 мин.
- четыре быстрых профиля