From ce89eba22d166c0c97bbe0abd40ba2c2443b08c3 Mon Sep 17 00:00:00 2001 From: roman Date: Fri, 16 Oct 2026 13:32:33 +0300 Subject: [PATCH] docs: record the clean clone check of ebf080a MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Repeat the REPORT.md "Запуск из чистого clone" sequence from a real git clone of the final strict-id-validation code on the default ports: env setup, stand, no-cache build, check, validate, smoke, instances on two Python versions, persistence, failover of each replica and kill, own tests, fault checks and the isolated run. All steps exit 0. The clone ran as compose project mtusi-lab3-cleancheck while the working stand was only stopped, because removing its volume was refused by the agent's auto mode; the previous checks ran as mtusi-lab3. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 6 +- REPORT.md | 14 +- evidence/tests/clean-clone-final.md | 205 ++++++++++-------- evidence/tests/strict-id-validation-checks.md | 14 +- 4 files changed, 131 insertions(+), 108 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 42212e73..4561dc1f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -40,10 +40,8 @@ PostgreSQL «too many clients», `scaling-improvement` — пул PostgreSQL changes лабы 3 (девятый — `strict-id-validation`), как и changes перехода на lab2, — в `openspec/changes/archive/`, спеки синхронизированы, активных changes нет; `KNOWN_ISSUES.md` без открытых -записей, `REPORT.md` заполнен, чистый clone проверен -(`evidence/tests/clean-clone-final.md` на `8fa12f5`; код -`strict-id-validation` — клоном во временном проекте, -`evidence/tests/strict-id-validation-checks.md`). Дальше — +записей, `REPORT.md` заполнен, чистый clone проверен на итоговом коде +`ebf080a` (`evidence/tests/clean-clone-final.md`). Дальше — перенос в лабу 4 (раздел «Переход в следующую лабу»). Рабочий план лабы (`PLAN.md`) удалён, его решения — в `REPORT.md` и design архивных changes; последняя версия — `git show 063eedb:PLAN.md`. Стек: diff --git a/REPORT.md b/REPORT.md index 34384249..94d665cc 100644 --- a/REPORT.md +++ b/REPORT.md @@ -3,9 +3,10 @@ - Автор, группа: Сафронов Роман Николаевич, БВТ2301 - Целевая оценка 5; выбранный трек 5: трек 1 «Цена масштабирования» (серии сняты, change `scaling-bench`; одно подтверждённое улучшение — пул без переполнения, change `scaling-improvement`, засчитано с оговоркой: раздел «Улучшение по найденному узкому месту: пул без переполнения») - Commit/PR: ветка `solution/bvt2301-safronov`, PR «ЛР 3 — БВТ2301 — - Сафронов — на 5» — https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/6. Из чистого clone проверен commit `8fa12f5` (2026-10-13, код - change `fix-known-issues`, `evidence/tests/clean-clone-final.md`). - После него `Dockerfile`, `pyproject.toml`, `uv.lock`, compose, + Сафронов — на 5» — https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3/pulls/6. Из чистого clone проверен commit `ebf080a` (2026-10-16, итоговый + код change `strict-id-validation`, `evidence/tests/clean-clone-final.md`). + Прошлая такая проверка — `8fa12f5` (2026-10-13, код `fix-known-issues`). + После неё `Dockerfile`, `pyproject.toml`, `uv.lock`, compose, конфигурации, миграции и `scripts/` не менялись; код приложения — только в change `strict-id-validation` (ниже). Изменились инструменты проверок, по verify `fix-known-issues` (`824676b`, @@ -36,8 +37,9 @@ - `git clone` во временном проекте на нестандартных портах (142 passed). - Полная проверка из чистого clone на портах по умолчанию после него не - повторялась (`evidence/tests/strict-id-validation-checks.md`). + Затем полная проверка из чистого clone на портах по умолчанию на + `ebf080a` — все шаги код 0 (`evidence/tests/clean-clone-final.md`; + проверки change — `evidence/tests/strict-id-validation-checks.md`). - Использованные источники, библиотеки и помощь ИИ: раздел «Источники, библиотеки и использование ИИ» в конце отчёта. @@ -693,7 +695,7 @@ SHA-256 тела; `created_at` с индексом; `CHECK` формата и д | `X-Instance-Id` на каждом ответе, `instance_id` в журнале | тесты `api-conventions`, `curl`, `docker compose logs api` | заголовок у 2xx, 4xx, health, 404, 405, 500; значение = короткий ID контейнера; 85 из 85 записей журнала с `instance_id`, включая старт и shutdown; ключей и текста в журнале нет | `evidence/idempotency/instance-id.md` | | Стенд лабы 3 не трогает данные лабы 2 | `make run_docker`, `make wipe_data`, снова `make run_docker`; `docker volume inspect` до и после | `wipe_data` удалил только контейнеры, сеть и volume `mtusi-lab3`; `mtusi-lab2_postgres_data` с прежней датой создания | `evidence/tests/stand-lab3.md` | | Сборка из чистого clone | `git clone`, `docker build -t mtusi-messenger:lab3 .` до `make env_setup`; стенд на этом образе, `make test` | сборка без `.env` и `config.toml`, в образе их нет, процесс от UID 10001; `PASS: lab3 public API scenario` | `evidence/tests/clean-clone.md` | -| Итоговая проверка из чистого clone по разделу «Запуск из чистого clone» (COURSE.md, «Что сдавать»: PR должен собираться из чистого clone по инструкции автора) | настоящий `git clone` commit `8fa12f5` (2026-10-13, итоговый код `fix-known-issues`; прошлая проверка — `dbb9150`, в истории файла), проект `mtusi-lab3` на портах по умолчанию: `make env_setup`, `make run_docker`, `make check`, `make validate`, `make test`, `make instances` (`python3` 3.11 и системный 3.9.6), `make test-persistence`, `make test-failover` для каждой реплики (`stop`, затем `make replicas`; плюс `kill`), `make student_test`, `make failure_checks`, `make test_isolated`; `docker build --no-cache` | все команды — код 0 без правки файлов клона: `PASS` у публичных проверок, `instances: 2`, остановлены по очереди `bbddd2338014` и `4c914e2e525f` (ID = `TARGET_INSTANCE_ID`), первая запись через 0,96–1,21 с (`stop`, неудачных попыток 0) и 0,23 с (`kill`, одна попытка в полёте повторена с тем же ключом); после `restart.sh` те же ID с новым `StartedAt` у LB, реплик, Postgres и Valkey; 133 passed через LB (сверка ссылок исключений зелёная), 17 проверок отказов и журнал PostgreSQL стенда без признаков аварии, 129 passed + 4 пропуска с причиной в изоляции; образ без `.env` и `config.toml`, UID 10001 | `evidence/tests/clean-clone-final.md` | +| Итоговая проверка из чистого clone по разделу «Запуск из чистого clone» (COURSE.md, «Что сдавать»: PR должен собираться из чистого clone по инструкции автора) | настоящий `git clone` commit `ebf080a` (2026-10-16, итоговый код `strict-id-validation`; прошлые проверки — `8fa12f5` и `dbb9150`, в истории файла) на портах по умолчанию: `make env_setup`, `make run_docker`, `make check`, `make validate`, `make test`, `make instances` (`python3` 3.12 и системный 3.9.6), `make test-persistence`, `make test-failover` для каждой реплики (`stop`, затем `make replicas`; плюс `kill`), `make student_test`, `make failure_checks`, `make test_isolated`; `docker build --no-cache`. Проект compose — временный `mtusi-lab3-cleancheck`: удалить рабочий стенд с volume запретил режим auto агента, рабочий стенд на время проверки остановлен; прошлые проверки шли под `mtusi-lab3`. Имя проекта задаёт только имена контейнеров и volume | все команды — код 0 без правки файлов клона: `PASS` у публичных проверок, `instances: 2`, остановлены по очереди `745885fa362c` и `8ad8d07ffe26` (ID = `TARGET_INSTANCE_ID`), первая запись через 1,09–1,61 с (`stop`, неудачных попыток 0) и 0,23 с (`kill`, одна попытка в полёте повторена с тем же ключом); после `restart.sh` те же ID с новым `StartedAt` у LB, реплик, Postgres и Valkey; 142 passed через LB, 17 проверок отказов и журнал PostgreSQL стенда без признаков аварии, 138 passed + 4 пропуска с причиной в изоляции; образ без `.env` и `config.toml`, UID 10001 | `evidence/tests/clean-clone-final.md` | | Стенд `bench/`: отправки с ключом при восстановлении | `make bench_restore_quick` (самопроверка, не замер) | 1000 отправок во время backup на каждом размере, 0 неудачных; сообщений в исходной базе = подтверждённых отправок; сверка баз прошла | `evidence/tests/bench-restore-quick.md` | | «4»: rolling update (поочерёдная замена) проверен под нагрузкой | `make bench_rollout ROLLOUT_LABEL=baseline` (commit `9dcea0b`, код `de654a1`, хост проверен, рабочий стенд остановлен): 100 записей с ключом и 100 чтений в секунду, две реплики образа `c50b721` заменяются на образ текущего checkout тем же `scripts/rolling-update.sh`; на рабочем стенде (итоговый код `84161c0`) — `make rolling_update`, откат `COMMIT=c50b721 MIGRATE=0`, снова вперёд и две замены подряд под `tests/load.py`; быстрый профиль `make bench_rollout_quick` на `84161c0` | замена 8,9 с; **0 ошибок** из 24 002 запросов, доля успешных 1,0 в каждой секунде, p95 5 → макс. 11 мс; по шагам: новая `UP` в LB через 2,0–2,1 с после старта, дренаж старой 0,14–0,16 с, остановка 0,3–0,4 с; после вывода из LB старая не получила ни одного запроса; сообщений 12 001 = ключей 12 001. Рабочий стенд: 0 неуспешных из 21 043 / 16 687 / 18 480 / 27 278 запросов `tests/load.py`; старые реплики завершаются за 0,1 с с кодом 0 («Finished server process»); контейнеров прежних реплик после замены нет. Быстрый профиль на итоговом коде: замена 8,1 с, 0 ошибок, 7 301 = 7 301 | `evidence/rollout/baseline/summary.md`, `evidence/rollout/compatibility.md`, `evidence/tests/rolling-update-checks.md` | | «4»: CPU и память профилей отказа и замены (COURSE.md: CPU/RAM в отчёте о нагрузке) | `make bench_failover FAILOVER_LABEL=resources`, `make bench_rollout ROLLOUT_LABEL=resources` (код `2d267bf`, хост проверен, `Swapouts` без прироста, рабочий стенд остановлен): тот же профиль и сэмплер cgroup в режиме `scan` (0,25 CPU / 128 МиБ, без сети) на всё время нагрузки; самопроверки — быстрые профили, сторож (`docker rm -f` сэмплера посреди фазы) | `failover`, фазы 1–5: до действия реплика 0,28–0,31 ядра, PostgreSQL 0,09–0,10, ВМ 1,03–1,16 из 12; в окне отказа выжившая 0,37–0,43, цель 0 (у `pause` — 0 CPU при той же памяти); после возврата — запуск до 1,06 ядра; CPU на запрос до действия — API 2 810–3 136 мкс, PostgreSQL 432–478. `rollout`: API всего 0,57 → 0,82 ядра и 176 → 279 МиБ на пике замены (три реплики), ВМ 1,0 → 2,8 ядра на сборке; CPU на запрос до / после 2 876 / 2 895 мкс. Доступность та же, что у `baseline`: обнаружение в границах, восстановление ≤ 7 с, у замены 0 ошибок и 0 ответов старой после дренажа. Наблюдатель — 0,003 ядра, 2–3 МиБ, к стенду не обращается; сторож — код 1 с фазой, стенд убран | `evidence/failover/resources/`, `evidence/rollout/resources/` (`summary.md`, `resources.csv`, `samples.csv`), `evidence/tests/profile-resources-checks.md` | diff --git a/evidence/tests/clean-clone-final.md b/evidence/tests/clean-clone-final.md index 882a2ffd..22b2ad96 100644 --- a/evidence/tests/clean-clone-final.md +++ b/evidence/tests/clean-clone-final.md @@ -3,10 +3,22 @@ | | | |---|---| | Что проверялось | раздел `REPORT.md` «Запуск из чистого clone» — буквально, шаг за шагом, как у проверяющего | -| Дата | 2026-10-13 14:54–15:01 UTC | -| Commit | `8fa12f5` — `git clone --branch solution/bvt2301-safronov` локального репозитория во временный каталог; рабочее дерево клона чистое, `.env`, `config.toml` и `.venv` нет. Это итоговый код change `fix-known-issues` (ранний обработчик SIGTERM, проверка журнала PostgreSQL стенда отказов, сверка ссылок исключений); после него менялись только этот файл, `REPORT.md` и файлы change. Прошлая такая проверка (commit `dbb9150`, 2026-10-13) — в истории этого файла | -| Стенд | проект compose `mtusi-lab3` (имя из `docker-compose.yml`, без `COMPOSE_PROJECT_NAME`), порты по умолчанию: LB `127.0.0.1:8080`, Postgres 5433, Valkey 6380. Рабочий стенд с тем же именем проекта перед проверкой удалён вместе с volume (`docker compose down -v`), чтобы клон стартовал на пустой базе со своим паролем, как у проверяющего. После проверки стенд клона удалён (`docker compose down -v`), рабочий поднят заново `make run_docker` | -| Хост | Docker Desktop 29.8.2, Compose v5.5.1, macOS arm64 (Apple M3 Pro); ВМ Docker: 12 CPU, 7,7 GiB RAM; `python3` 3.11.9 и системный `/usr/bin/python3` 3.9.6, uv 0.12.17. От батареи, работал посторонний контейнер `domains-postgres-1` (проверка, а не замер) | +| Дата | 2026-10-16 10:23–10:30 UTC | +| Commit | `ebf080a` — `git clone --branch solution/bvt2301-safronov` локального репозитория во временный каталог; рабочее дерево клона чистое, `.env`, `config.toml` и `.venv` нет. Это итоговый код change `strict-id-validation`: проверка полей курсора `8fe467a`, после него — докстринг `3328450` и документы. Прошлые такие проверки — `8fa12f5` (итоговый код `fix-known-issues`, 2026-10-13) и `dbb9150`, в истории этого файла | +| Стенд | временный проект compose `mtusi-lab3-cleancheck` (`COMPOSE_PROJECT_NAME`), порты по умолчанию: LB `127.0.0.1:8080`, Postgres 5433, Valkey 6380. Клон стартовал на пустой базе со своим паролем, как у проверяющего. Рабочий стенд `mtusi-lab3` на время проверки остановлен (`docker compose stop`), а не удалён; после проверки стенд клона удалён (`down -v`), рабочий запущен снова с прежним volume | +| Хост | Docker Desktop 29.8.2, Compose v5.5.1, macOS arm64 (Apple M3 Pro); ВМ Docker: 12 CPU, 7,7 GiB RAM; `python3` 3.12.12 и системный `/usr/bin/python3` 3.9.6, uv 0.12.17. Питание от сети, посторонних контейнеров нет (проверка, а не замер) | + +**Отличие от прошлых проверок — только имя проекта compose.** Прошлые +проверки поднимали клон под именем `mtusi-lab3` из `docker-compose.yml`, +а рабочий стенд с тем же именем удаляли вместе с volume. В этот раз +удаление рабочего volume запретил режим auto агента как необратимое. +Клон поднят под `COMPOSE_PROJECT_NAME=mtusi-lab3-cleancheck`, а рабочий +стенд только остановлен, чтобы освободить порты. + +Имя проекта задаёт только имена контейнеров, сети и volume. Порты, +`.env`, образ и шаги инструкции те же. Цели `Makefile`, `restart.sh`, +`stop-one.sh`, `run_failures.py` и `run_isolated.py` берут проект у +`docker compose`, то есть из `COMPOSE_PROJECT_NAME`. Пароли из сгенерированного `.env` не выводились: проверялось только, что они есть (32 hex-символа). @@ -16,27 +28,33 @@ ```text $ git clone --branch solution/bvt2301-safronov <репозиторий> clean-clone && cd clean-clone $ git log --oneline -1; git status --short | wc -l; ls .env config.toml .venv -8fa12f5 docs: close the known issues fixed by fix-known-issues +ebf080a docs: archive strict-id-validation 0 ls: .env: No such file or directory ls: .venv: No such file or directory ls: config.toml: No such file or directory +$ export COMPOSE_PROJECT_NAME=mtusi-lab3-cleancheck $ make env_setup # exit 0 env ready: .env, config.toml $ grep -c -E '^(POSTGRES|VALKEY)_PASSWORD=.{32}$' .env 2 +$ grep -E '^(APP_OUT_PORT|POSTGRES_OUT_PORT|VALKEY_OUT_PORT|API_REPLICAS)=' .env +APP_OUT_PORT=8080 +API_REPLICAS=2 +POSTGRES_OUT_PORT=5433 +VALKEY_OUT_PORT=6380 -$ make run_docker # exit 0, 7 с (слои — из кэша BuildKit) - -$ docker compose ps -a --format 'table {{.Name}}\t{{.Status}}\t{{.Ports}}' # через 20 с -NAME STATUS PORTS -mtusi-lab3-api-1 Up 20 seconds (healthy) 8080/tcp -mtusi-lab3-api-2 Up 20 seconds (healthy) 8080/tcp -mtusi-lab3-haproxy-1 Up 20 seconds (healthy) 127.0.0.1:8080->8080/tcp -mtusi-lab3-migrate-1 Exited (0) 20 seconds ago -mtusi-lab3-postgres-1 Up 25 seconds (healthy) 127.0.0.1:5433->5432/tcp -mtusi-lab3-valkey-1 Up 24 seconds (healthy) 127.0.0.1:6380->6379/tcp +$ make run_docker # exit 0, 6 с (слои — из кэша BuildKit) +$ make replicas # ожидание healthy +$ docker compose ps -a --format 'table {{.Name}}\t{{.Status}}\t{{.Ports}}' +NAME STATUS PORTS +mtusi-lab3-cleancheck-api-1 Up 1 second (healthy) 8080/tcp +mtusi-lab3-cleancheck-api-2 Up 1 second (healthy) 8080/tcp +mtusi-lab3-cleancheck-haproxy-1 Up 1 second (health: starting) 127.0.0.1:8080->8080/tcp +mtusi-lab3-cleancheck-migrate-1 Exited (0) 1 second ago +mtusi-lab3-cleancheck-postgres-1 Up 5 seconds (healthy) 127.0.0.1:5433->5432/tcp +mtusi-lab3-cleancheck-valkey-1 Up 5 seconds (healthy) 127.0.0.1:6380->6379/tcp $ docker compose logs migrate --no-log-prefix | tail -5 # поле event Running upgrade -> 16c279725564, added messenger tables @@ -52,7 +70,7 @@ Finished alembic Сборка без кэша слоёв из того же клона (отдельный тег, затем удалён): ```text -$ docker build --no-cache --pull -t mtusi-clean-check:nocache . # exit 0, 77 с +$ docker build --no-cache --pull -t mtusi-clean-check:nocache . # exit 0, 12 с (кэш пакетов uv — mount BuildKit) $ docker run --rm --entrypoint sh mtusi-clean-check:nocache -c 'id -u; ls /app; …' 10001 alembic.ini @@ -72,15 +90,15 @@ $ make validate PYTHON=.venv/bin/python # exit 0 PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. $ make test # exit 0 PASS: lab3 public API scenario; infrastructure and grading evidence remain separate. -$ make instances # python3 3.11.9 -user lb_d2986d44: one login, 12 requests with one token - bbddd2338014: 6 - 4c914e2e525f: 6 +$ make instances # python3 3.12.12 +user lb_12790bdf: one login, 12 requests with one token + 8ad8d07ffe26: 6 + 745885fa362c: 6 instances: 2 $ make instances PYTHON=/usr/bin/python3 # системный python3 3.9.6 macOS -user lb_ef79f8fe: one login, 12 requests with one token - bbddd2338014: 6 - 4c914e2e525f: 6 +user lb_2094bb77: one login, 12 requests with one token + 8ad8d07ffe26: 6 + 745885fa362c: 6 instances: 2 ``` @@ -88,24 +106,24 @@ instances: 2 ```text $ docker inspect … (до) имя, ID, состояние, StartedAt -/mtusi-lab3-api-1 bbddd2338014 running 2026-10-13T14:54:53Z -/mtusi-lab3-api-2 4c914e2e525f running 2026-10-13T14:54:53Z -/mtusi-lab3-haproxy-1 2627286e6f84 running 2026-10-13T14:54:53Z -/mtusi-lab3-postgres-1 25b076681377 running 2026-10-13T14:54:48Z -/mtusi-lab3-valkey-1 ab2c07c37f5c running 2026-10-13T14:54:48Z +/mtusi-lab3-cleancheck-api-1 745885fa362c running 2026-10-16T10:25:07Z +/mtusi-lab3-cleancheck-api-2 8ad8d07ffe26 running 2026-10-16T10:25:07Z +/mtusi-lab3-cleancheck-haproxy-1 1a4040abcee2 running 2026-10-16T10:25:07Z +/mtusi-lab3-cleancheck-postgres-1 f227ba506f36 running 2026-10-16T10:25:03Z +/mtusi-lab3-cleancheck-valkey-1 f39f3a292d60 running 2026-10-16T10:25:03Z $ make test-persistence ACTION_SCRIPT=scripts/restart.sh # exit 0 Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. $ docker inspect … (после) -/mtusi-lab3-api-1 bbddd2338014 running 2026-10-13T14:56:53Z -/mtusi-lab3-api-2 4c914e2e525f running 2026-10-13T14:56:53Z -/mtusi-lab3-haproxy-1 2627286e6f84 running 2026-10-13T14:56:53Z -/mtusi-lab3-postgres-1 25b076681377 running 2026-10-13T14:56:49Z -/mtusi-lab3-valkey-1 ab2c07c37f5c running 2026-10-13T14:56:49Z -$ docker volume inspect -f '{{.Name}} {{.CreatedAt}}' mtusi-lab3_postgres_data -mtusi-lab3_postgres_data 2026-10-13T14:54:47Z +/mtusi-lab3-cleancheck-api-1 745885fa362c running 2026-10-16T10:25:54Z +/mtusi-lab3-cleancheck-api-2 8ad8d07ffe26 running 2026-10-16T10:25:55Z +/mtusi-lab3-cleancheck-haproxy-1 1a4040abcee2 running 2026-10-16T10:25:55Z +/mtusi-lab3-cleancheck-postgres-1 f227ba506f36 running 2026-10-16T10:25:50Z +/mtusi-lab3-cleancheck-valkey-1 f39f3a292d60 running 2026-10-16T10:25:50Z +$ docker volume inspect -f '{{.Name}} {{.CreatedAt}}' mtusi-lab3-cleancheck_postgres_data +mtusi-lab3-cleancheck_postgres_data 2026-10-16T10:25:03Z ``` Перезапущены LB, обе реплики, Postgres и Valkey: те же ID, новый @@ -114,108 +132,111 @@ mtusi-lab3_postgres_data 2026-10-13T14:54:47Z ## `make test-failover` для каждой реплики `STOP_ONE_LOG` — строка hook: какой `TARGET_INSTANCE_ID` выбрал тест и -какой контейнер остановлен. +какой контейнер остановлен. Перед каждым прогоном — ожидание двух `UP` в +`make lb_stats`. ```text $ STOP_ONE_LOG=<файл> make test-failover ACTION_SCRIPT=scripts/stop-one.sh # exit 0 -{"observed_instances_before": 2, "successful_writes": 121, "failed_attempts": 0, "first_recovery_seconds": 1.207} +{"observed_instances_before": 2, "successful_writes": 115, "failed_attempts": 0, "first_recovery_seconds": 1.61} PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. -2026-10-13T14:56:56Z TARGET_INSTANCE_ID=bbddd2338014 container=bbddd2338014a8ff… mode=stop +2026-10-16T10:26:09Z TARGET_INSTANCE_ID=745885fa362c container=745885fa362c73c3… mode=stop $ docker compose ps -a --format '{{.Name}} {{.ID}} {{.Status}}' api -mtusi-lab3-api-1 bbddd2338014 Exited (0) 14 seconds ago -mtusi-lab3-api-2 4c914e2e525f Up 17 seconds (healthy) +mtusi-lab3-cleancheck-api-1 745885fa362c Exited (0) 14 seconds ago +mtusi-lab3-cleancheck-api-2 8ad8d07ffe26 Up 29 seconds (healthy) $ make replicas # exit 0, тот же контейнер api-1 снова healthy $ curl -s -o /dev/null -D - http://127.0.0.1:8080/health/live | grep -i x-instance-id -x-instance-id: 4c914e2e525f # сдвиг очереди round-robin одним запросом +x-instance-id: 8ad8d07ffe26 # сдвиг очереди round-robin одним запросом $ STOP_ONE_LOG=<файл> make test-failover ACTION_SCRIPT=scripts/stop-one.sh # exit 0 -{"observed_instances_before": 2, "successful_writes": 122, "failed_attempts": 0, "first_recovery_seconds": 0.961} +{"observed_instances_before": 2, "successful_writes": 120, "failed_attempts": 0, "first_recovery_seconds": 1.086} PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. -2026-10-13T14:57:14Z TARGET_INSTANCE_ID=4c914e2e525f container=4c914e2e525f002f… mode=stop -mtusi-lab3-api-1 bbddd2338014 Up 17 seconds (healthy) -mtusi-lab3-api-2 4c914e2e525f Exited (0) 14 seconds ago +2026-10-16T10:26:27Z TARGET_INSTANCE_ID=8ad8d07ffe26 container=8ad8d07ffe26af29… mode=stop +mtusi-lab3-cleancheck-api-1 745885fa362c Up 17 seconds (healthy) +mtusi-lab3-cleancheck-api-2 8ad8d07ffe26 Exited (0) 14 seconds ago $ make replicas # exit 0 $ STOP_MODE=kill STOP_ONE_LOG=<файл> make test-failover ACTION_SCRIPT=scripts/stop-one.sh # exit 0 -{"observed_instances_before": 2, "successful_writes": 122, "failed_attempts": 1, "first_recovery_seconds": 0.229} +{"observed_instances_before": 2, "successful_writes": 118, "failed_attempts": 1, "first_recovery_seconds": 0.23} PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. -2026-10-13T14:57:31Z TARGET_INSTANCE_ID=bbddd2338014 container=bbddd2338014a8ff… mode=kill -mtusi-lab3-api-1 bbddd2338014 Exited (137) 15 seconds ago -mtusi-lab3-api-2 4c914e2e525f Up 17 seconds (healthy) +2026-10-16T10:26:46Z TARGET_INSTANCE_ID=8ad8d07ffe26 container=8ad8d07ffe26af29… mode=kill +mtusi-lab3-cleancheck-api-1 745885fa362c Up 36 seconds (healthy) +mtusi-lab3-cleancheck-api-2 8ad8d07ffe26 Exited (137) 15 seconds ago -$ make replicas; make lb_stats # exit 0 (через 2 с после make replicas) +$ make replicas; make lb_stats # exit 0 svname addr status check_status scur stot econ wretr wredis hrsp_5xx -api-1 172.30.0.5:8080 UP L7OK 0 211 0 0 4 0 -api-2 172.30.0.4:8080 UP L7OK 0 322 0 0 2 0 -BACKEND - UP - 0 529 2 0 6 3 +api-1 172.31.0.5:8080 UP L7OK 0 200 0 0 3 0 +api-2 172.31.0.4:8080 UP L7OK 0 320 0 0 3 0 +BACKEND - UP - 0 516 2 0 6 3 free slots: 6 ``` Остановлены по очереди обе реплики: ID остановленного контейнера -совпадает с `TARGET_INSTANCE_ID`, остальные работают; первая запись -после остановки — через 1,21 и 0,96 с (`stop`) и 0,23 с (`kill`). У -`stop` неудачных попыток 0. У `kill` одна: запрос был в полёте на -убитой реплике, LB его не повторяет (`POST` не идемпотентен для LB), -тест повторил его с тем же ключом — без дубля, как в замере -`graceful-failover`. Сразу после `make replicas` слот вернувшейся -реплики — `DOWN 1/2`, через 2 с — `UP`: LB включает её после `rise 2` -проверок. `hrsp_5xx` у `BACKEND` — ответы самого LB во время рестарта -в `restart.sh` (до проверок реплик LB отвечает 503, -`evidence/replicas/test-persistence.md`). +совпадает с `TARGET_INSTANCE_ID`, остальные работают. Первая запись +после остановки — через 1,61 и 1,09 с (`stop`) и 0,23 с (`kill`). + +- **`stop`:** неудачных попыток 0. +- **`kill`:** одна неудачная попытка. Запрос был в полёте на убитой + реплике, LB его не повторяет (`POST` не идемпотентен для LB). Тест + повторил его с тем же ключом — без дубля, как в замере + `graceful-failover`. + +`hrsp_5xx` у `BACKEND` — ответы самого LB во время рестарта в +`restart.sh`: до проверок реплик LB отвечает 503 +(`evidence/replicas/test-persistence.md`). ## Собственные тесты ```text -$ make student_test # exit 0, 22 с -coverage: 137 scenarios in 11 specs, 125 tested (18 by make failure_checks), 12 excluded -one session, 20 requests: {'bbddd2338014': 10, '4c914e2e525f': 10} -key race through replicas: {'4c914e2e525f': 5, 'bbddd2338014': 5} -===================== 133 passed, 17 deselected in 21.68s ====================== +$ make student_test # exit 0 +coverage: 145 scenarios in 11 specs, 133 tested (18 by make failure_checks), 12 excluded +one session, 20 requests: {'745885fa362c': 10, '8ad8d07ffe26': 10} +key race through replicas: {'745885fa362c': 5, '8ad8d07ffe26': 5} +===================== 142 passed, 17 deselected in 26.22s ====================== -$ make failure_checks # exit 0, 70 с -================ 17 passed, 133 deselected in 60.47s (0:01:00) ================= -[failure_checks] postgres log: 380 lines, crash markers 0; "too many clients" 25, "administrator command" 129 +$ make failure_checks # exit 0 +================ 17 passed, 142 deselected in 64.07s (0:01:04) ================= +[failure_checks] postgres log: 381 lines, crash markers 0; "too many clients" 26, "administrator command" 129 [failure_checks] results: {'fault': 0, 'postgres': 0} -$ make test_isolated # exit 0, 61 с +$ make test_isolated # exit 0 PASS: lab3 public API scenario; infrastructure and grading evidence remain separate. -================ 129 passed, 4 skipped, 17 deselected in 53.09s ================ +=========== 138 passed, 4 skipped, 17 deselected in 65.13s (0:01:05) =========== [test_isolated] results: {'test': 0, 'student_test': 0} ``` -133 и 129 вместо прошлых 131 и 127 — два новых теста сверки ссылок -исключений на файлы evidence (они в клоне есть, сверка зелёная). -`make failure_checks` теперь печатает сводку журнала PostgreSQL стенда -отказов: признаков аварийного перезапуска нет. 4 пропуска в изоляции — -тесты реплик с причиной «one API process». +142 и 138 вместо прошлых 133 и 129 — девять тестов change +`strict-id-validation` (подменённый курсор, UUID на входе). Стенд +отказов назван по рабочему проекту — `mtusi-lab3-cleancheck-failures`. +4 пропуска в изоляции — тесты реплик с причиной «one API process». ## Уборка и рабочий стенд ```text $ git status --short | wc -l # в каталоге клона после всех команд 0 -$ docker compose down -v # в каталоге клона, проект mtusi-lab3 - Volume mtusi-lab3_postgres_data Removed - Network mtusi-lab3_default Removed -$ docker ps -a --filter name=failures -q | wc -l; docker ps -a --filter name=test-api -q | wc -l -0 -0 -$ make run_docker # в каталоге рабочего репозитория, exit 0 +$ docker compose down -v # в каталоге клона, проект mtusi-lab3-cleancheck + Volume mtusi-lab3-cleancheck_postgres_data Removed + Network mtusi-lab3-cleancheck_default Removed +cleancheck left: 0 containers, 0 volumes; failures: 0; test-api: 0 +$ docker compose start postgres valkey haproxy api # в каталоге рабочего репозитория +$ make replicas # exit 0 $ docker compose ps --format '{{.Name}} {{.Status}}' -mtusi-lab3-api-1 Up 18 seconds (healthy) -mtusi-lab3-api-2 Up 18 seconds (healthy) -mtusi-lab3-haproxy-1 Up 18 seconds (healthy) -mtusi-lab3-postgres-1 Up 22 seconds (healthy) -mtusi-lab3-valkey-1 Up 22 seconds (healthy) +mtusi-lab3-api-5 Up 2 seconds (healthy) +mtusi-lab3-api-6 Up 2 seconds (healthy) +mtusi-lab3-haproxy-1 Up 2 seconds (healthy) +mtusi-lab3-postgres-1 Up 7 seconds (healthy) +mtusi-lab3-valkey-1 Up 7 seconds (healthy) $ make lb_stats api-1 172.30.0.5:8080 UP L7OK … api-2 172.30.0.4:8080 UP L7OK … free slots: 6 $ make instances PYTHON=/usr/bin/python3 instances: 2 +$ docker volume inspect -f '{{.Name}} {{.CreatedAt}}' mtusi-lab3_postgres_data +mtusi-lab3_postgres_data 2026-10-13T15:00:39Z # прежний volume рабочего стенда ``` Итог: все шаги инструкции из настоящего clone прошли с кодом 0 без -правки файлов клона; дефектов не найдено. Стенд лабы 2 -(`mtusi-lab2_postgres_data`) не затронут. +правки файлов клона; дефектов не найдено. Рабочий стенд и его данные не +затронуты. diff --git a/evidence/tests/strict-id-validation-checks.md b/evidence/tests/strict-id-validation-checks.md index b9c18dc1..dbdded08 100644 --- a/evidence/tests/strict-id-validation-checks.md +++ b/evidence/tests/strict-id-validation-checks.md @@ -229,10 +229,12 @@ PASS: lab3 public API scenario; infrastructure and grading evidence remain separ =========== 138 passed, 4 skipped, 17 deselected in 63.74s =========== ``` -## 4.5. Полная проверка из чистого clone на портах по умолчанию — не делалась +## 4.5. Полная проверка из чистого clone на портах по умолчанию -Она удаляет рабочий стенд с volume (`evidence/tests/clean-clone-final.md`, -шаг «Стенд»), а на это не было явного согласия (design, решение 6). -Последняя такая проверка — `8fa12f5` (итоговый код `fix-known-issues`). -С тех пор в коде приложения изменились только валидация UUID на входе и -разбор курсора. Сборка и запуск из клона на `8fe467a` проверены выше. +В apply не делалась: она удаляла рабочий стенд с volume, а явного +согласия не было (design, решение 6). После архива change пользователь +попросил её сделать. Она прошла на `ebf080a` во временном проекте compose +на портах по умолчанию, рабочий стенд при этом был только остановлен +(`evidence/tests/clean-clone-final.md`). Все шаги — код 0: 142 passed +через LB, 17 проверок отказов, 138 + 4 в изоляции, `test-persistence` и +`test-failover` для обеих реплик и `kill`.