From f02694e1024fba9b2fd9be87b599aad9b26989a7 Mon Sep 17 00:00:00 2001 From: roman Date: Tue, 13 Oct 2026 18:23:23 +0300 Subject: [PATCH] docs: update expected test counts and notes after fix-known-issues verify REPORT: 133 and 129 + 4 in the clean clone section, the postgres log summary of failure_checks, the isolated count on the final code. AGENTS: do not copy lab 3 evidence, cache-check --require-test-keys. script-failures: the closed KNOWN_ISSUES entry points to decision 7. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 7 +++++-- REPORT.md | 8 +++++--- evidence/rollout/script-failures.md | 6 ++++++ 3 files changed, 16 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 53292761..217f9ede 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -497,13 +497,16 @@ KNOWN_ISSUES.md # найденные попутно дефекты, - Доказательства исключений сверки покрытия снять заново на стенде новой лабы, иначе `make student_test` красный (`test_exclusion_evidence_exists` называет сценарий и путь): `make test_isolated`, затем `driver.py - --port cache-check` → `evidence/cache/hits.md`; `driver.py --port + --port cache-check --require-test-keys` → + `evidence/cache/hits.md`; `driver.py --port auth-storage` → `evidence/auth/passwords-and-tokens.md`; `make test-persistence ACTION_SCRIPT=scripts/restart.sh` → `evidence/replicas/test-persistence.md` (или путь, который назовёт исключение); повтор отправки с ключом после `docker compose up -d --force-recreate api` → `evidence/idempotency/replay-after-restart.md` - (`student-tests.md`). + (`student-tests.md`). Файлы `evidence/` лабы 3 в новую лабу не + копировать, даже эти четыре: сверка проверяет только наличие файла и + с копией останется зелёной без пересъёмки. - Сначала прочитать переходы API в `COURSE.md` и `contracts/README.md` нового skeleton, потом править код. Обновить этот файл: номер лабы, таблицу важных файлов, новые правила. diff --git a/REPORT.md b/REPORT.md index 840fea84..aab9fbe6 100644 --- a/REPORT.md +++ b/REPORT.md @@ -107,8 +107,10 @@ make test_isolated # образ на временной базе test_messeng Ожидаемо: `make check`, `make validate`, `make test`, `make test-persistence` и оба `make test-failover` — `PASS`; -`make instances` — `instances: 2`; `make student_test` — `131 passed`; -`make failure_checks` — `17 passed`; `make test_isolated` — `127 +`make instances` — `instances: 2`; `make student_test` — `133 passed`; +`make failure_checks` — `17 passed` и строка сводки журнала PostgreSQL +стенда отказов `[failure_checks] postgres log: … crash markers 0` +(признаков аварийного перезапуска нет); `make test_isolated` — `129 passed, 4 skipped` (тесты реплик против одного процесса пропускаются с причиной). Строка `STOP_ONE_LOG` называет `TARGET_INSTANCE_ID`, который выбрал тест, и полный ID остановленного контейнера; `docker compose ps @@ -630,7 +632,7 @@ SHA-256 тела; `created_at` с индексом; `CHECK` формата и д | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | -| Публичный smoke | `make test` через LB на стенде `make run_docker`; `make test_isolated` (образ из `a4ca9ef`, временная база, один контейнер): `make test` + `make student_test EXPECT_REPLICAS=1`; `make test` через LB стенда из настоящего `git clone` на нестандартных портах | `PASS: lab3 public API scenario` во всех трёх; в изоляции 127 passed, 4 теста реплик пропущены с причиной «one API process»; сверка покрытия на итоговом коде: 137 сценариев, 125 тестом (18 — `make failure_checks`), 12 исключений (на `a4ca9ef` было 135 / 123) | `evidence/tests/student-test-lb.md`, `evidence/tests/test-isolated.md`, `evidence/replicas/clean-clone-ports.md`, `evidence/tests/clean-clone-final.md` | +| Публичный smoke | `make test` через LB на стенде `make run_docker`; `make test_isolated` (образ из `a4ca9ef`, временная база, один контейнер): `make test` + `make student_test EXPECT_REPLICAS=1`; `make test` через LB стенда из настоящего `git clone` на нестандартных портах | `PASS: lab3 public API scenario` во всех трёх; в изоляции на `a4ca9ef` 127 passed, 4 теста реплик пропущены с причиной «one API process» (на итоговом коде `fix-known-issues` — 129 passed + 4 пропуска: два новых теста сверки ссылок, `evidence/tests/clean-clone-final.md`); сверка покрытия на итоговом коде: 137 сценариев, 125 тестом (18 — `make failure_checks`), 12 исключений (на `a4ca9ef` было 135 / 123) | `evidence/tests/student-test-lb.md`, `evidence/tests/test-isolated.md`, `evidence/replicas/clean-clone-ports.md`, `evidence/tests/clean-clone-final.md` | | «3»: стенд одной командой, ≥2 API, одна точка входа, общие БД и сессии | `make run_docker` (рабочий стенд и настоящий `git clone`); `docker compose ps`, `docker port`, `docker compose config` | `haproxy` — единственный порт API на хосте (`127.0.0.1:8080`), `api` × 2 без портов и `container_name`; общие Postgres (сессии, данные, ключи) и Valkey; миграции — один прогон `migrate` на каждый up, в журналах реплик `alembic` нет; из клона стенд поднимается одной командой, `.env` и `config.toml` создаются сами | `evidence/replicas/stand.md`, `evidence/replicas/clean-clone-ports.md` | | «3»: разные запросы одного пользователя — разными репликами без повторного входа | `make instances` (один вход, 12 × `GET /users/me` с одним токеном); `test_load_balancing.py` | ответы чередуются `3681880fc55f` / `8100f940a5fa` по 6; 20 запросов сессии — по 10; запись через одну реплику видна в чтениях через другую | `evidence/replicas/distribution.md`, `evidence/tests/student-test-lb.md` | | «3»: отказ любой одной реплики — ≤10 с до новых чтений и записей; `make test-failover` | `make test-failover ACTION_SCRIPT=scripts/stop-one.sh` для каждой реплики, `make replicas` и сдвиг очереди round-robin одним запросом между прогонами; `STOP_ONE_LOG` — какой `TARGET_INSTANCE_ID` выбрал тест; `docker compose ps -a` и `StartedAt` до и после | 2 × `PASS`: остановлены `8100f940a5fa`, затем `3681880fc55f`; первая запись через 1,10–1,11 с, 0 неудачных попыток, по 2 запроса перенаправлены LB; ID остановленного контейнера = `TARGET_INSTANCE_ID`, остальные контейнеры с прежним `StartedAt`; через 20 с реплика всё ещё `exited`. С цепочкой таймаутов `graceful-failover` (commit `459f84c`) — снова `PASS` для каждой реплики: `stop` — 0 неудачных попыток, первая запись через 1,62 с; `kill` — 1 неудачная попытка (запрос в полёте), повторена с тем же ключом, первая запись через 0,23 с | `evidence/failover/test-failover.md`, `evidence/tests/graceful-failover-checks.md` | diff --git a/evidence/rollout/script-failures.md b/evidence/rollout/script-failures.md index 321f966e..a272846a 100644 --- a/evidence/rollout/script-failures.md +++ b/evidence/rollout/script-failures.md @@ -100,6 +100,12 @@ make: *** [rolling_update] Error 1 (`KNOWN_ISSUES.md`), и `docker stop` ждал бы все 10 с. Если DNS уже отдал ей слот, он сначала уходит в `maint`. +> Позже: запись `KNOWN_ISSUES.md` закрыта change `fix-known-issues` +> (решение 7): ранний обработчик SIGTERM, неготовая реплика со слотом +> останавливается штатно (`maint` → `docker stop` → `rm -f` → `ready`), +> без слота — по-прежнему `rm -f`, как в этом случае +> (`evidence/failover/stop-at-start.md`). Выше — снимок на `84161c0`. + ## 5. Ctrl+C во время дренажа под нагрузкой Настоящий Ctrl+C: `make rolling_update` запущен в псевдотерминале