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`.