diff --git a/.claude/rules/balancer.md b/.claude/rules/balancer.md index 44ff9035..67476796 100644 --- a/.claude/rules/balancer.md +++ b/.claude/rules/balancer.md @@ -11,8 +11,9 @@ paths: Задание — `README.md` лабы 3, роли — `contracts/infrastructure.json`, семантика `X-Instance-Id` и `Idempotency-Key` — `api-contract.md`. Общие правила compose, пинов и volumes — `docker.md`; здесь то, что -добавляет лаба 3. Почему HAProxy — `PLAN.md`, «Ключевые решения»; -числа и их обоснование — design change `replicas-lb` (архив +добавляет лаба 3. Почему HAProxy — `REPORT.md`, «Балансировщик и +реплики» (таблица сравнения), и design change `replicas-lb`, решение 1; +числа и их обоснование — тот же design (архив `openspec/changes/archive/`), спек `load-balancing`. ``` @@ -242,6 +243,13 @@ Compose не умеет rolling update сам (это `update_config` Swarm). Ц 6. Шаги 3–5 для каждой старой. В конце — N реплик на новом образе, все `UP`, ни одной прежней. +**Имена контейнеров после замены.** Compose нумерует новые контейнеры +сервиса по возрастанию, поэтому после замен реплики называются `api-N` +с растущим номером (`mtusi-lab3-api-3`, `-4`, …). Штатные цели +(`make replicas`, `make test-failover`, `restart.sh`, `stop-one.sh`) с +ними работают: они обращаются к сервису `api` (`docker compose ps -q +api`, `stop` / `start api`), а не к имени контейнера. `make down` + `make run_docker` снова дают `api-1`, `api-2`. + **Runtime API LB** — `stats socket ipv4@127.0.0.1:9999 level admin` в `global`: только loopback контейнера LB, из сети compose и с хоста не достать. Команды — `docker compose exec -T haproxy bash -c 'exec diff --git a/.claude/rules/bench.md b/.claude/rules/bench.md index 6f7c2b37..b7291047 100644 --- a/.claude/rules/bench.md +++ b/.claude/rules/bench.md @@ -26,8 +26,9 @@ paths: переносились: другое хранилище — другая методика, сравнивать их с лабой 2 нельзя. -**Лаба 3, трек «5» №1 «Цена масштабирования»** (`PLAN.md`, раздел -«Трек 5»). Стенд нужен для трёх вещей: +**Лаба 3, трек «5» №1 «Цена масштабирования»** (design change +`scaling-bench` в архиве; результаты — `REPORT.md`, «Цена +масштабирования»). Стенд нужен для трёх вещей: - серия A — фиксированный суммарный бюджет CPU/RAM на 1/2/4 реплики; - серия B — рост числа реплик до точки насыщения Postgres, LB или diff --git a/.claude/rules/infra.md b/.claude/rules/infra.md index 20dafd2e..27f9a0a7 100644 --- a/.claude/rules/infra.md +++ b/.claude/rules/infra.md @@ -40,7 +40,8 @@ paths: `API_REPLICAS × (pool_size + max_overflow)` + migrate + запас (psql, стенд `bench/`) не больше `max_connections` Postgres (по умолчанию 100). Расчёт для заявленного числа реплик — в `REPORT.md`; - граница пула — одна из гипотез трека 1 (`PLAN.md`). + граница пула — гипотеза H3 трека 1 (`REPORT.md`, «Цена + масштабирования»). - Пул — постоянный набор: `pool_size` 10, `max_overflow` 0 по умолчанию (change `scaling-improvement`). Соединение переполнения `QueuePool` закрывает при возврате, если в очереди уже `pool_size` простаивающих, diff --git a/AGENTS.md b/AGENTS.md index 208ff209..4aad0235 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,9 +21,13 @@ API HAProxy (`make rolling_update`), expand-миграция и профиль насыщение пула и PostgreSQL управляемыми опытами) и ответ 503 на отказ PostgreSQL «too many clients», `scaling-improvement` — пул PostgreSQL 10 + 0 без переполнения (улучшение трека 1: профиль `SERIES=db4`, -«до/после» с A/A, засчитано с оговоркой); -дальше — changes из `PLAN.md`. Переход на lab2 завершён changes OpenSpec, они в -`openspec/changes/archive/`. Стек: +«до/после» с A/A, засчитано с оговоркой). Лаба 3 закрыта: все шесть +changes лабы 3, как и changes перехода на lab2, — в +`openspec/changes/archive/`, `REPORT.md` заполнен, чистый clone +проверен (`evidence/tests/clean-clone-final.md`); дальше — перенос в +лабу 4 (раздел «Переход в следующую лабу»). Рабочий план лабы +(`PLAN.md`) удалён, его решения — в `REPORT.md` и design архивных +changes; последняя версия — `git show 063eedb:PLAN.md`. Стек: Python 3.12, uv, FastAPI, pydantic v2, pydantic-settings, structlog (JSON в stdout), redis-py (клиент Valkey). @@ -107,30 +111,6 @@ Python 3.12, uv, FastAPI, pydantic v2, pydantic-settings, structlog варианты — каждое по имени, последним — «все». То же при нескольких подходящих спеках (capability). -## Переходное состояние - -Лаба 3 закрыта не целиком. Этот файл и `.claude/rules/` описывают -целевое состояние лабы 3, поэтому стенд с ними пока расходится. План -работ, решения и трек «5» — `PLAN.md`. Стенд — проект compose -`mtusi-lab3` со своей базой: HAProxy перед двумя репликами `api` -(change `replicas-lb`) с согласованной цепочкой таймаутов (change -`graceful-failover`); `make test`, `make test-persistence` и `make -test-failover` проходят через LB, новый код доходит до реплик без -простоя через `make rolling_update` (change `rolling-update`). Все три -change — в архиве. После замен реплики называются `api-N` с растущим -номером (compose нумерует новые контейнеры сервиса по возрастанию): -штатные цели с ними работают, `make down` + `make run_docker` снова -дают `api-1`, `api-2`. - -- Серии трека 1 сняты, change `scaling-bench` в архиве (метки - `scaling-a`, `-b`, `-pool`, `-aa` на коде `712d245`, `scaling-db` — на - `95539a1`). -- `REPORT.md` заполнен для уровней «3», «4», серий трека 1 и - улучшения (засчитано с оговоркой; по букве критерия — не - подтверждено). - -Закрытый пункт убрать отсюда, закрытый переход — удалить раздел. - ## Согласования с преподавателем Договорённости, которых нет в skeleton. Каждую упомянуть в `REPORT.md` @@ -147,7 +127,6 @@ change — в архиве. После замен реплики называю | Файл | Что в нём | |---|---| | `README.md` | задание лабы: рубрика 3/4/5, сценарий и вопросы защиты, что приложить к PR | -| `PLAN.md` | наш план лабы 3 на «5»: рубрика → change, ключевые решения, трек 1, порядок changes, риски; удаляется, когда все changes закрыты | | `COURSE.md` | карта семи лаб, три объявленных перехода API (1→2, 2→3, 4→5), правила честных измерений | | `contracts/openapi.json` | нормативный OpenAPI 3.1: пути, схемы, коды ответов | | `contracts/README.md` | нормативная семантика: формат ошибок, валидация, пагинация, Basic → Bearer-сессии, TTL и отзыв, с lab3 — `Idempotency-Key` и `X-Instance-Id`; разделы lab4+ — на будущее | @@ -256,6 +235,14 @@ change — в архиве. После замен реплики называю сервис, smoke упадёт с 404 на `/health/live` вместо ошибки соединения. Проверить, кто занял порт: `lsof -nP -iTCP:8080 -sTCP:LISTEN`, `docker ps`. +- Стенд — проект compose `mtusi-lab3` со своей базой. После `make + rolling_update` реплики называются `api-N` с растущим номером + (compose нумерует новые контейнеры сервиса по возрастанию): штатные + цели с ними работают, `make down` + `make run_docker` снова дают + `api-1`, `api-2` (`balancer.md`). +- `make instances` и публичные проверки skeleton запускаются системным + `python3` (3.9+ на macOS), без uv: драйвер скилла — только stdlib и + синтаксис 3.9. - graphify (граф кода, «Где лежат инструкции») — вне проекта, в `uv tool`, версия закреплена: - CLI: `uv tool install --python 3.12 'graphifyy==0.9.72'`. Без diff --git a/REPORT.md b/REPORT.md index ef077dca..ab8453fc 100644 --- a/REPORT.md +++ b/REPORT.md @@ -5,8 +5,12 @@ - Commit/PR: ветка `solution/bvt2301-safronov`, PR «ЛР 3 — БВТ2301 — Сафронов — на 5» — ссылка на PR после публикации (push и PR делает автор). Из чистого clone проверен код commit `67b4303` - (`evidence/tests/clean-clone-final.md`); последующие commit меняют - только документы. + (`evidence/tests/clean-clone-final.md`). После него менялись только + документы (`REPORT.md`, `AGENTS.md`, правила `.claude/rules/`, + удалён `PLAN.md`), проза evidence и драйвер скилла + `.claude/skills/run-mtusi-messenger/driver.py` за `make instances` + (совместимость с `python3` 3.9); код приложения, `Dockerfile`, + `pyproject.toml`, `uv.lock`, compose, конфигурации и скрипты — нет. - Использованные источники, библиотеки и помощь ИИ: раздел «Источники, библиотеки и использование ИИ» в конце отчёта. @@ -42,11 +46,14 @@ Docker Desktop 29.8.2 (ВМ linux/arm64, 12 CPU, 7,7 GiB), Compose v5.5.1, macOS на Apple M3 Pro. **Нужно на машине:** -- Docker с BuildKit и Compose v2, `make`, `openssl` (пароли в - `make env_setup`); +- Docker Engine 25+ (compose использует `healthcheck.start_interval`) + с BuildKit и Compose v2, `make`, `openssl` (пароли в + `make env_setup`), `curl` (шаги последовательности ниже); - `python3` 3.9+ для публичных `make check`, `make test`, `make test-persistence`, `make test-failover`, `make instances`, - `make test_isolated`, `make failure_checks`; + `make test_isolated`, `make failure_checks`. Драйвер `make instances` + — только stdlib, проверен и на системном `python3` 3.9.6 macOS + (`make instances PYTHON=/usr/bin/python3` — `instances: 2`); - uv — для `make validate` (валидатор в dev-группе), `make student_test`, `make failure_checks`, `make test_isolated` (внутри `uv run pytest`), стенда замеров `make bench*` и `make run_dev`; @@ -102,7 +109,9 @@ passed, 4 skipped` (тесты реплик против одного проце `make replicas API_REPLICAS=N`. В консоли (`make run_dev`) — один процесс без LB на `127.0.0.1:8080`, с Postgres и Valkey из того же compose; свой набор против него — `make student_test -EXPECT_REPLICAS=1`. +EXPECT_REPLICAS=1`. Порт 8080 занят HAProxy работающего стенда, поэтому +перед `make run_dev` — `make stop` (или `docker compose stop +haproxy`). ### Сценарий защиты @@ -112,12 +121,16 @@ STOP_ONE_LOG=/tmp/stop-one.log make test-failover ACTION_SCRIPT=scripts/stop-one cat /tmp/stop-one.log; docker compose ps -a # 3. какой контейнер остановлен: ID = TARGET_INSTANCE_ID make replicas; curl -s -o /dev/null http://127.0.0.1:8080/health/live STOP_ONE_LOG=/tmp/stop-one.log make test-failover ACTION_SCRIPT=scripts/stop-one.sh # то же для второй реплики +cat /tmp/stop-one.log; docker compose ps -a # остановлен второй контейнер: ID = TARGET_INSTANCE_ID make replicas make test-persistence ACTION_SCRIPT=scripts/restart.sh # 4. рестарт LB, реплик, Postgres и Valkey, тот же токен # уровень 4 — на своём стенде mtusi-bench, рабочий стенд перед ними: make stop +make stop make bench_failover_quick # отказ каждой реплики под нагрузкой (stop, kill), ~2 мин; полный — make bench_failover make bench_rollout_quick # поочерёдная замена под нагрузкой с образа прежнего commit, ~2 мин; полный — make bench_rollout -make rolling_update # на рабочем стенде: новый код без простоя (под make load в соседнем терминале) +make run_docker # рабочий стенд снова (после make stop) +make load # в соседнем терминале — нагрузка на время замены +make rolling_update # на рабочем стенде: новый код без простоя # уровень 5, трек 1: самопроверка серий (~4 мин), полные серии — make bench_scaling SERIES=… make bench_scaling_quick ``` @@ -220,7 +233,8 @@ clients» (SQLSTATE 53300) — 503, а не 500. Стенды `make failure_chec ### Балансировщик и реплики (change `replicas-lb`) -**Почему Compose + HAProxy** (выбор подтверждён 2026-10-07, `PLAN.md`): +**Почему Compose + HAProxy** (выбор подтверждён автором 2026-10-07; +design change `replicas-lb`, решение 1): | Критерий | HAProxy | Nginx (бесплатный) | Traefik | Swarm | |---|---|---|---|---| @@ -401,7 +415,7 @@ rolling_update`. Сторонний плагин не используется: **Канал управления LB** — `stats socket ipv4@127.0.0.1:9999 level admin` в `haproxy.cfg`. Он слушает только loopback контейнера LB. Из сети compose и с хоста его не достать (`evidence/rollout/script-failures.md`, -случай 6), команды идут через `docker compose exec haproxy`. Страница +случай 8), команды идут через `docker compose exec haproxy`. Страница статистики `:8404` с `stats admin` не годится: она открыта всей сети compose. Альтернатива — readiness 503 по SIGTERM — отвергнута: - она меняет поведение остановки, после SIGTERM реплика ещё ≥ 1,5 с @@ -582,7 +596,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»; сверка покрытия: 135 сценариев, 123 тестом, 12 исключений | `evidence/tests/student-test-lb.md`, `evidence/tests/test-isolated.md`, `evidence/replicas/clean-clone-ports.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` во всех трёх; в изоляции 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` | | «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` | @@ -610,7 +624,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» (`PLAN.md`, этап 7; COURSE.md: «PR собирается из чистого clone») | настоящий `git clone` commit `67b4303`, проект `mtusi-lab3` на портах по умолчанию: `make env_setup`, `make run_docker`, `make check`, `make validate`, `make test`, `make instances`, `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`, остановлены по очереди `0089ca350b2b` и `437292ccaf78` (ID = `TARGET_INSTANCE_ID`), первая запись через 0,99–1,0 с, неудачных попыток 0; после `restart.sh` те же ID с новым `StartedAt` у LB, реплик, Postgres и Valkey; 131 passed через LB, 17 проверок отказов, 127 passed + 4 пропуска с причиной в изоляции; образ без `.env` и `config.toml`, UID 10001 | `evidence/tests/clean-clone-final.md` | +| Итоговая проверка из чистого clone по разделу «Запуск из чистого clone» (COURSE.md, «Что сдавать»: PR должен собираться из чистого clone по инструкции автора) | настоящий `git clone` commit `67b4303`, проект `mtusi-lab3` на портах по умолчанию: `make env_setup`, `make run_docker`, `make check`, `make validate`, `make test`, `make instances`, `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`, остановлены по очереди `0089ca350b2b` и `437292ccaf78` (ID = `TARGET_INSTANCE_ID`), первая запись через 0,99–1,0 с, неудачных попыток 0; после `restart.sh` те же ID с новым `StartedAt` у LB, реплик, Postgres и Valkey; 131 passed через LB, 17 проверок отказов, 127 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»: миграции однократно и совместимы с работающей версией | реплики образа `c50b721` + миграция нового образа в контейнере сервиса `migrate` (команда скрипта), без замены; `make test`, `make student_test`; замена; `SELECT instance_id, count(*)` по сообщениям; миграция под чужой блокировкой и нагрузкой | новая ревизия `e656d6bbe1a4` (колонка `messages.instance_id`, NULL) при прежних репликах: `PASS`, 131 passed; запись прежней версии — NULL, новой — её `X-Instance-Id`; при замене одна миграция в контейнере `migrate` до первой новой реплики, в журналах реплик alembic нет; повторный запуск — no-op; откат кода без отката схемы (после отката `migrate` прежнего образа падает на новой ревизии — ограничение, описано); под чужой транзакцией `lock_timeout` 2 с → миграция падает с кодом 1, схема и реплики не тронуты, 6 запросов из очереди за ней — успешны за 2,0 с (с 5 с в apply — все 6 получили 503), повтор проходит | `evidence/rollout/compatibility.md`, `evidence/rollout/script-failures.md` | @@ -627,7 +641,7 @@ SHA-256 тела; `created_at` с индексом; `CHECK` формата и д | «5», трек 1: исходные данные и графики | `make bench_plots`; таблицы меток | R* от числа реплик, p95 от интенсивности (лог. шкала, линия SLO), CPU по компонентам на R*; строка на ступень, на ячейку и посекундные отсчёты | `evidence/plots/scaling/*.svg`, `evidence/bench/scaling-*/runs.csv`, `searches.csv`, `samples.csv` | | «5», трек 1: уровень шума для улучшения | `make bench_scaling SERIES=ab SCALING_LABEL=scaling-aa`; `make bench_compare BEFORE=scaling-b AFTER=scaling-aa`, `BEFORE=scaling-b AFTER=scaling-a` | шум между сессиями (B → A/A, тот же код `712d245`): 1 × 1 666 (666–704) → 704 (666–704), +5,7 % — одна ступень деления; 6 × 1 2 034 (1 923–2 034) → 2 034 (2 034–2 034), Δ в пределах одной ступени (< 5,7 %); разбросы пересекаются. Согласованность серий: 4 × 1 серии `a` и k = 4 серии `b` — 1 819 и 1 819. Для `scaling-improvement` `scaling-aa` как `AA` не годится: код после правки 53300 другой, A/A снимается заново | `evidence/compare/scaling-b__scaling-aa.md`, `evidence/compare/scaling-b__scaling-a.md` | | «5», трек 1: одно подтверждённое улучшение — пул без переполнения (change `scaling-improvement`) | H4 закоммичена до замеров (`0b0421a`, набор ячеек — `1bb8ea6`, попытка 2 — `a676a52`); изменение `9c3959d` (дефолт `max_overflow` 5 → 0) откачено; в одной сессии хоста: A/A `make bench_scaling SERIES=db4 SCALING_LABEL=scaling-db-aa2`, затем `make bench_ab BEFORE=scaling-db-before2 AFTER=scaling-db-nooverflow2 REAPPLY=5c07923 SERIES=db4`; `make bench_compare … AA=scaling-db-aa2 CHANGE=scaling-improvement`. Попытка 1 — те же команды с метками без `2`, откат `62fa575` | **попытка 2 (окончательная, тихий хост):** основная `4x1-pg0.5` R* 931 (931–984) → 1 101 (1 101–1 101), +18,3 %, «эффект», шум A/A 5,4 %; механизм: новых сессий на первой нарушившей 102 → 4, соединений 60 → 40, CPU PostgreSQL на запрос там 416 → 336 мкс; контроль `4x1-pg2` +5,7 % (в пределах шума). **Подтверждено с оговоркой**: по букве критерия проверка дрейфа (CPU на запрос при 500/с ±5 %) у основной ячейки −5,4 % из-за двух ячеек «до» (переполнения при 500/с нет ни в одной метке); против A/A2 той же сессии (`make bench_compare BEFORE=scaling-db-aa2 AFTER=scaling-db-nooverflow2 AA=scaling-db-before2 CHANGE=scaling-improvement`) дрейфа нет — 1 940 → 1 936 мкс, R* 984 → 1 101, +11,9 % (две ступени), «эффект»; засчитано решением автора после результатов. Попытка 1: +32 %, но шум A/A 20 % из-за помех macOS (iCloud, Zoom) — не прошла дрейф | `evidence/compare/scaling-db-before2__scaling-db-nooverflow2.md`, `evidence/compare/scaling-db-aa2__scaling-db-nooverflow2.md`, `evidence/compare/scaling-db-aa2__scaling-db-before2.md`, `evidence/bench/scaling-db-{aa2,before2,nooverflow2}/`, попытка 1 — `evidence/compare/scaling-db-before__scaling-db-nooverflow.md` и метки без `2`, `evidence/tests/scaling-improvement-checks.md` | -| Пул без переполнения: соединения не переоткрываются | `make failure_checks`: тест `test_pool_keeps_connections` (48 потоков × 5 запросов, пачки больше пула 10, счётчик `pg_stat_database.sessions` через hook `db-sessions`); рабочий `config.toml` с `max_overflow` 5 и 0 | 10 + 5 — красный: 18–21 новая сессия PostgreSQL за 720 запросов; 10 + 0 — 0, 17 проверок отказов прошли (4 прогона); регрессия на коде X: `make test`, `make student_test` (131 passed), `make test_isolated`, `make test-persistence`, `make test-failover` для обеих реплик — `PASS`; соединений приложения на рабочем стенде 17 ≤ 2 × 10 | `evidence/tests/scaling-improvement-checks.md` | +| Пул без переполнения: соединения не переоткрываются | `make failure_checks`: тест `test_pool_keeps_connections` (48 потоков × 5 запросов, пачки больше пула 10, счётчик `pg_stat_database.sessions` через hook `db-sessions`); рабочий `config.toml` с `max_overflow` 5 и 0 | 10 + 5 — красный: 18–21 новая сессия PostgreSQL за 720 запросов; 10 + 0 — 0, 17 проверок отказов прошли (4 прогона); регрессия на коде `80e64cd`: `make test`, `make student_test` (131 passed), `make test_isolated`, `make test-persistence`, `make test-failover` для обеих реплик — `PASS`; соединений приложения на рабочем стенде 17 ≤ 2 × 10 | `evidence/tests/scaling-improvement-checks.md` | | Цена нового соединения PostgreSQL и пинга | микропроба в реплике рабочего стенда (`cd88b48`): проверка сессии и страница истории через repo, из пула с пингом, без пинга и с новым соединением на итерацию | новое соединение — 11,7–11,8 мс CPU реплики (SCRAM-SHA-256 asyncpg в event loop) и 2,7 мс CPU PostgreSQL против 0,6 и 0,15 мс из пула; пинг при выдаче — +0,13 мс реплики и +0,05 мс PostgreSQL на запрос | `evidence/storage/connection-cost.md` | **Сверка с рубрикой README.** Каждому пункту — строка с командой, @@ -659,7 +673,9 @@ session нет (`balance roundrobin` без cookie и stick-table, ответы `scripts/restart.sh`, `scripts/stop-one.sh` (и `scripts/rolling-update.sh`), `Dockerfile`, миграции `migrations/` с `alembic.ini`, результаты отказов — `evidence/failover/`, -`evidence/rollout/`, `evidence/replicas/`, `evidence/tests/`. +`evidence/rollout/`, `evidence/replicas/`, `evidence/tests/`. Файл +compose (README: «compose.yaml или stack.yaml») — `docker-compose.yml`: +Compose находит его сам, как `compose.yaml`. ## Эксперименты и отказы @@ -670,21 +686,24 @@ session нет (`balance roundrobin` без cookie и stick-table, ответы стенда через LB. Хост общий: Apple M3 Pro (6 + 6 ядер, 18 ГиБ), Docker Desktop 29.8.2, ВМ 12 vCPU / 7,7 GiB; перед каждым замером проверены питание от сети, свободная память, отсутствие посторонних контейнеров -и выгрузок в swap (паспорта `meta.json`). Версии — раздел «Запуск из +и выгрузок в swap (паспорта `meta.json`; у профиля `failover` счётчик +выгрузок — в `evidence/failover/detection.md`, у `rollout` — только +занятый swap, у меток попытки 2 улучшения — `Swapouts` 0 в начале и в +конце без поля `swapouts_delta`, `KNOWN_ISSUES.md`). Версии — раздел «Запуск из чистого clone». Сырые итоги k6, журналы LB и посекундные таблицы лежат рядом со сводками, без токенов и паролей. | | Отказ реплик (`failover`) | Поочерёдная замена (`rollout`) | Трек 1 (`scaling_*`) | |---|---|---|---| | Гипотеза | `stop` и `kill` без ошибок недоступности, `pause` исключается ≤ 6,5 с, восстановление ≤ 10 с, без потерь и дублей | 0 ошибок при плановой замене, старая реплика после дренажа запросов не получает | H1–H4 (раздел «Цена масштабирования»), записаны до прогонов | -| Лимиты | API 1 CPU / 512 МиБ × 2, PostgreSQL 2 CPU / 1 ГиБ, HAProxy 1 CPU / 256 МиБ, Valkey 0,5 CPU / 128 МиБ — как у рабочего стенда | те же | реплики 1 × 4 … 6 × 1, PostgreSQL 2 или 0,5 CPU; k6 2 CPU / 1 ГиБ, сэмплер 0,25 CPU; сумма ≤ 12 vCPU | +| Лимиты | API 1 CPU / 512 МиБ × 2, PostgreSQL 2 CPU / 1 ГиБ, HAProxy 1 CPU / 256 МиБ, Valkey 0,5 CPU / 128 МиБ — как у рабочего стенда; k6 без лимита (`.claude/rules/bench.md`) | те же | реплики 1 × 4 … 6 × 1, PostgreSQL 2 или 0,5 CPU; k6 2 CPU / 1 ГиБ, сэмплер 0,25 CPU; сумма ≤ 12 vCPU | | Данные | чат чтения из 1 000 сообщений, отдельный чат записи | те же | чат чтения из 10 000 сообщений, 10 чатов записи | | Нагрузка | открытая модель, постоянная интенсивность: 100 записей с ключом + 100 чтений истории в секунду | та же | открытая модель 70/20/10 (история / запись / `users/me`): 250 и 500/с, затем поиск R* по ступеням | | Длительность, прогрев | фаза 15 с до действия (опорное окно) + 20 с до возврата + 15 с; 6 фаз, ~6 мин | 15 с до замены, замена 8,9 с, ≥ 15 с после; 24 002 запроса | прогрев 15 с (5 с подъёма между ступенями), окно 20 с | | Повторы | один прогон на фазу | один прогон | 3 повтора каждой конфигурации, свежий стенд на ячейку, A/A для шума | | Успешные RPS, ошибки | `stop`, `kill`: ~200/с, 0 ошибок; `pause`: 99–100/с в окне, 584–602 × 504 | 200/с, 0 ошибок | R* 630–2 034 запросов/с при ошибках ≤ 1 % | | p50 / p95 / p99 | фаза `stop` 1: 3,5 / 6,1 / 97,1 мс за прогон; p95 по секундам — до 505 мс в секунду действия | 3,3 / 5,0 / 9,7 мс за прогон | p95 / p99 на 500/с по конфигурациям — таблица R* | -| CPU / RAM | только лимиты, использование не снималось | только лимиты | посекундно у каждого контейнера и ВМ (`samples.csv`), CPU на запрос по компонентам | +| CPU / RAM | только лимиты, использование не снималось: профиль меряет доступность при отказе, цену запроса в CPU — трек 1 при тех же лимитах реплики | только лимиты, по той же причине | посекундно у каждого контейнера и ВМ (`samples.csv`), CPU на запрос по компонентам | | Файлы | `evidence/failover/baseline/` | `evidence/rollout/baseline/` | `evidence/bench/scaling-*/`, `evidence/plots/`, `evidence/compare/` | Ограничения каждого замера — в конце его раздела, сводно — «Ограничения @@ -812,8 +831,9 @@ PostgreSQL делят ВМ Docker. Один прогон на фазу. Инте Commit `9dcea0b` (код `de654a1`), чистое дерево. Хост: Docker Desktop 29.8.2, ВМ 12 CPU / 7,7 GiB, питание от сети, свободной памяти 52–53 %, -swap занят 920 МиБ, но выгрузки за прогон не было (`Swapouts` до и -после одинаковы). Посторонних контейнеров нет, рабочий стенд +swap занят 920 МиБ и за прогон не менялся (`meta.json`, `host_state`); +счётчик `Swapouts` профиль `rollout` в паспорт не пишет. Посторонних +контейнеров нет, рабочий стенд остановлен. Один прогон. Итоговый код change — `84161c0`: после замера verify поменял пути сбоя @@ -1159,7 +1179,7 @@ k_sat = 4. Поэтому в пределах разрешения **k_sat ∈ { Растёт другое: **цена того же запроса в CPU у всех компонентов сразу**. От k = 1 к k = 6 запрос стоит репликам ×1,91, PostgreSQL ×2,03, HAProxy ×2,24, генератору ×1,56 CPU-времени, а на 250 и 500/с, где ВМ занята на -0,8–1,7 ядра, цена запроса у PostgreSQL от k не зависит (230–300 мкс). +0,8–1,7 ядра, цена запроса у PostgreSQL от k не зависит (220–300 мкс). HAProxy и k6 от кода приложения не зависят, а дорожают тоже. Значит, дорожает не код и не база, а **секунда CPU хоста под нагрузкой**: чем больше vCPU ВМ занято (1,8 → 8,1 из 12), тем меньше работы она даёт. @@ -1171,7 +1191,8 @@ HAProxy и k6 от кода приложения не зависят, а дор - снижение частоты производительных ядер под многоядерной нагрузкой; - накладные расходы гипервизора и сетевого стека ВМ, учтённые в cgroup; - конкуренция за кэш и память; -- у k6 — ещё и рост числа занятых VU (66 → 309). +- у k6 — ещё и рост числа занятых VU (медианы по повторам на ступени + R* 66 → 249, максимум 309). Ни одна метрика не показывает, на каких физических ядрах шла работа. Проверено и исключено: генератор (≤ 0,88 ядра из 2 посекундно, @@ -1206,8 +1227,12 @@ keep-alive-сессия держит своё соединение к каждо от самих реплик на перегрузке (1–11 за окно на 2 034/с, 17–27 на 2 274/с): запрос ждал свободное соединение пула дольше `pool_timeout` 5 с (строки API `"status": 503` с `duration_ms` ≈ 5 010 и строки LB - `api/api-N 0/0/0/50xx/50xx 503` в `raw/*-errors.log`); LB реплики не - исключал (`lb_chkdown` 0). Тот же механизм — у 503 серий `a` (4 × 1, + `api/api-N 0/0/0/50xx/50xx 503` в `raw/*-errors.log`); на ступенях с + 503 LB реплики не исключал (`lb_chkdown` 0), одно исключение — на + 1 923/с в `4x1-r1`, без 5xx. При 50 на 1 819/с LB исключал реплики + (по 2 раза в `4x1-c50-r1` и `-r3`) — на ступени с тысячами отказов + «too many clients»; что проверку роняли именно они, журналы не + показывают (строк проверок в `raw/*-errors.log` нет). Тот же механизм — у 503 серий `a` (4 × 1, 1–11 за окно) и `b` (2 × 1 — 1, 3 × 1 — 1–6, 4 × 1 — 1–8) за R*. - `max_connections` 50: пулы упираются в 49 соединений (50 − 1 слот сэмплера). Отказы начинаются уже на 1 455/с — 10–200 за окно при @@ -1251,7 +1276,7 @@ swap 0, брака генератора нет (`evidence/tests/scaling-bench-ch |---|---|---|---|---|---|---| | 1 × 1, PostgreSQL 0,5 | 630 (630–630) | `app` / `app` | 0,19 (0,38) | 0 | 298 → 284 | 15 | | 2 × 1, PostgreSQL 0,5 | 1 101 (1 101–1 101) | `app` / `app` | 0,38 (0,77) | 4,8 % | 348 → 349 | 30 | -| 4 × 1, PostgreSQL 0,5 | **931 (931–931)** | — / **`db_cpu` `db_wal` `host`** | 0,26 (0,52) | **68 %** | 279 → **441** | 41 → 60 | +| 4 × 1, PostgreSQL 0,5 | **931 (931–931)** | `host_cost` / **`db_cpu` `db_wal` `host` `host_cost`** | 0,26 (0,52) | **68 %** | 279 → **441** | 41 → 60 | | 4 × 1, PostgreSQL 2 (контроль) | 1 627 (1 627–1 627) | `app` `host_cost` / `app` `host_cost` | 0,76 (0,38) | 0 | 468 → 492 | 60 | Таблица — разделы «PostgreSQL на R*» `evidence/bench/scaling-db/summary.md` @@ -1269,11 +1294,20 @@ swap 0, брака генератора нет (`evidence/tests/scaling-bench-ch растёт (630 → 1 101), узкое место — CPU реплик, PostgreSQL на 77 % лимита. 2 → 4: R* **падает на 15 %** (1 101 → 931), разбросы не пересекаются (во всех повторах одно и то же значение). Ожидание «почти - не растёт» подтвердилось сильнее, чем предполагали: у 4 реплик вдвое - больше соединений (до 60 против 30), и у насыщенного PostgreSQL CPU на - запрос растёт с 279 до 441 мкс — квоту делят больше backend-процессов, - растут ожидания WAL. Тот же лимит при 2 репликах держит 1 101/с при - 348 мкс на запрос. + не растёт» подтвердилось сильнее, чем предполагали: у 4 реплик за R* + CPU PostgreSQL на запрос растёт с 279 до 441 мкс. Главная причина — + переполнение пула 10 + 5 (установлено change `scaling-improvement`): + 4 реплики набирают до 60 соединений против 30, соединения сверх 10 на + реплику после возврата закрываются и открываются снова — новых сессий + за окно 79–144 на 984/с против 12–24 на 931/с, а новое соединение + стоит ~2,7 мс CPU PostgreSQL и ~11,7 мс CPU реплики + (`evidence/storage/connection-cost.md`). С пулом 10 + 0 R*(4 × 1) — + 1 101, столько же, сколько R*(2 × 1) здесь (другая сессия, справка), + новых сессий на первой нарушившей 102 → 4. Предел, который остаётся, — + квота CPU PostgreSQL 0,5: выше излома база выбирает её при любом пуле + (336 мкс на запрос на первой нарушившей против 277–293 на R*; раздел + «Улучшение…»). Тот же лимит при 2 репликах держит 1 101/с при 348 мкс + на запрос. - **Контроль:** 4 × 1 при 2 CPU PostgreSQL — 1 627/с, PostgreSQL на 38 % лимита, узкое место — реплики и хост, как в серии `b`. С `scaling-b` (1 819) не сравнивается: другая сессия и другой код. @@ -1470,7 +1504,9 @@ swap 0, брака генератора нет (`evidence/tests/scaling-bench-ch (`45a0ad7`), `scaling-db-nooverflow2` (`7a38c5d`). Хост перед A/A и `make bench_ab` и раз в минуту во время прогонов: питание от сети, Zoom не запущен, средняя нагрузка за 5 мин < 8 (≤ 7,88), Spotlight - < 15 % CPU (≤ 12,6 %), выгрузок 0. + < 15 % CPU (≤ 12,6 %), выгрузок 0 (проверка хоста; в паспортах — + `Swapouts` 0 в начале и в конце, поле `swapouts_delta` не записано, + `KNOWN_ISSUES.md`). - Эффект — вывод `make bench_compare … AA=scaling-db-aa` (попытка 1) / `AA=scaling-db-aa2` (попытка 2): разбросы не пересекаются и Δ больше шума A/A; плюс сдвиг не меньше двух ступеней @@ -1717,6 +1753,14 @@ CHANGE=scaling-improvement` хост (энергоэффективные ядра, частота, гипервизор — замер не разделяет); выигрыш пинга только после простоя соединения; эффект пула 10 + 0 на дефолтных лимитах PostgreSQL. +- **Известные дефекты** (`KNOWN_ISSUES.md`, не исправлены): SIGTERM во + время старта реплики теряется (обход — в `rolling-update.sh`); + `fill-connections` в `make failure_checks` перезапускает PostgreSQL + стенда отказов посреди набора (тесты проходят, но следующий тест + видит свежую базу); 5 исключений сверки покрытия ссылаются на + evidence лабы 2, которого в этом репозитории нет; профиль `failover` + берёт события Docker из буфера демона (256 событий); паспорта меток + попытки 2 без `swapouts_delta`. **Следующие шаги:** ранний обработчик SIGTERM или `init` для реплики (`KNOWN_ISSUES.md`); пинг соединения только после простоя (design @@ -1747,8 +1791,10 @@ CHANGE=scaling-improvement` после начала транзакции (`evidence/failover/hung-key.md`). Раньше ключ оставался занят до разморозки. - **Каждая запись дороже на одну вставку** и проверку отложенного - внешнего ключа. Это цена контракта; её измеряет трек 1, там же - кандидат «ключ и сообщение одним SQL-выражением» (`PLAN.md`). + внешнего ключа. Это цена контракта. Отдельно она не измерялась: + запись ключа входит в стоимость записи всех меток лабы 3 + (`.claude/rules/bench.md`). Кандидат «ключ и сообщение одним + SQL-выражением» остался непроверенным. - **После 24 ч** повтор того же тела с тем же ключом создаст новое сообщение: контракт гарантирует повтор только в пределах срока. - **В консоли `X-Instance-Id` — имя машины разработчика**; для локальной @@ -2025,12 +2071,16 @@ k = 6, вместе с числом занятых ядер хоста. Доба Границы БД и пула показаны управляемыми опытами. Серия `db`: при PostgreSQL 0,5 CPU база насыщается около 950–1 000/с (троттлинг до 100 %, `db_cpu`), и 4 реплики дают R* на 15 % меньше, чем 2 (931 против -1 101): лишние реплики только добавляют соединения, и запрос в -насыщенной базе дорожает с 279 до 441 мкс CPU. Главная причина — -переполнение пула 10 + 5: соединения сверх 10 переоткрываются. С пулом -10 + 0 (change `scaling-improvement`) R*(4 × 1) = 1 101 = R*(2 × 1), -новых сессий на первой нарушившей ступени 102 → 4 (раздел «Улучшение -по найденному узкому месту: пул без переполнения»). Серия `pool`: при +1 101): запрос в насыщенной базе дорожает с 279 до 441 мкс CPU. +Главная причина спада — переполнение пула 10 + 5: у 4 реплик +соединения сверх 10 на реплику закрываются и открываются снова (79–144 +новых сессий за окно на 984/с), а новое соединение стоит ~2,7 мс CPU +PostgreSQL. С пулом 10 + 0 (change `scaling-improvement`) R*(4 × 1) — +1 101, столько же, сколько R*(2 × 1) в `scaling-db` (другая сессия, +справка), новых сессий на первой нарушившей ступени 102 → 4. Предел, +который остаётся, — квота CPU PostgreSQL 0,5: выше излома база выбирает +её при любом пуле (раздел «Улучшение по найденному узкому месту: пул +без переполнения»). Серия `pool`: при `max_connections` 50 — отказы и падение R* на 15 % (после правки 53300 отказ — 503). LB не насыщался нигде: ≤ 0,30 ядра из 1. @@ -2075,7 +2125,7 @@ PostgreSQL 0,5 CPU база насыщается около 950–1 000/с (тр `preAllocatedVUs`, `dropped_iterations`, итоговый JSON. - FastAPI — : параметры `Header`, зависимости, порядок валидации, обработчики исключений. -- uvicorn — : `timeout_keep_alive`, +- uvicorn — : `timeout_keep_alive`, `timeout_graceful_shutdown`, поведение по SIGTERM. - Docker Compose — : [services](https://docs.docker.com/reference/compose-file/services/) @@ -2105,9 +2155,14 @@ structlog, SQLAlchemy, asyncpg, alembic, argon2-cffi, redis-py, uvicorn changes лабы 3). Каждый change проходил этапы propose → apply → verify → правки по verify и archive. Каждый этап выполнял отдельный субагент, основная сессия координировала: передавала этапы, проверяла итоги, -присылала автору прогресс. 77 из 81 commit после skeleton помечены -`Co-Authored-By: Claude`; остальные четыре сделал скрипт `make bench_ab` -по ходу замера. +присылала автору прогресс. Все commit после skeleton помечены +`Co-Authored-By: Claude Opus 5.5`, кроме четырёх, которые сделал скрипт +`make bench_ab` по ходу замера (`dfd9ecc`, `53eb38e`, `de6001c`, +`7a38c5d`). Рабочий план лабы (`PLAN.md`: рубрика → changes, ключевые +решения, трек 5, риски) удалён после закрытия всех changes; его +решения перенесены в этот отчёт и в design архивных changes, последняя +версия — `git show 063eedb:PLAN.md` (на неё ссылаются архивные +changes). Что делал ИИ: - код приложения, миграции, `docker-compose.yml`, `haproxy.cfg`, @@ -2120,7 +2175,7 @@ changes лабы 3). Каждый change проходил этапы propose → Что решал автор: - выбор трека 1 «Цена масштабирования» и Compose + HAProxy без Swarm - (2026-10-07, `PLAN.md`); + (2026-10-07; сравнение вариантов — раздел «Балансировщик и реплики»); - согласования с преподавателем (FastAPI, `config.toml`); - по verify `scaling-bench`: исправить ответ на «too many clients» (500 → 503, правка `68edc66`) и добавить серию `db` с насыщением diff --git a/evidence/failover/test-failover-kill.md b/evidence/failover/test-failover-kill.md index 7e161268..68ca27ef 100644 --- a/evidence/failover/test-failover-kill.md +++ b/evidence/failover/test-failover-kill.md @@ -79,7 +79,8 @@ instances: 1 `restart: unless-stopped` не поднял контейнер после `docker kill`: Docker считает kill ручной остановкой (`RestartCount` 0). Его `X-Instance-Id` в ответах через LB не встречается. Поэтому `docker stop --t 0` вместо `kill` (риск из `PLAN.md`) не понадобился. То же для +-t 0` вместо `kill` (риск, записанный в плане до change `replicas-lb`) +не понадобился. То же для `stop` — конец `test-failover.md`. ## Оборванный ответ не повторяется diff --git a/evidence/idempotency/config-checks.md b/evidence/idempotency/config-checks.md index 7fd1a1fb..182117bd 100644 --- a/evidence/idempotency/config-checks.md +++ b/evidence/idempotency/config-checks.md @@ -23,7 +23,7 @@ $ kill -INT # остановка, как Ctrl+C ``` Без переменной в консоли значение было бы hostname машины -(`MacBook-Pro-Roman`), так что `api-a` пришёл именно из окружения. +разработчика, так что `api-a` пришёл именно из окружения. Журнал этого запуска: 14 JSON-записей, без `instance_id` — 0, значений — одно: `api-a`. Записи по порядку (поля сокращены; строка reloader с diff --git a/evidence/replicas/clean-clone-ports.md b/evidence/replicas/clean-clone-ports.md index cfe4395d..62828db9 100644 --- a/evidence/replicas/clean-clone-ports.md +++ b/evidence/replicas/clean-clone-ports.md @@ -118,4 +118,4 @@ mtusi-lab3-valkey-1 Up About a minute (healthy) сам создаёт `.env` и `config.toml`, собирает образ и поднимает хранилища, миграции, две реплики и LB. Полная проверка «из чистого clone» перед PR (`make test` на образе из клона и стенд на портах по -умолчанию) — этап 7 `PLAN.md`. +умолчанию) — `evidence/tests/clean-clone-final.md`. diff --git a/evidence/storage/connection-cost.md b/evidence/storage/connection-cost.md index 5fa2147c..0a9a6f17 100644 --- a/evidence/storage/connection-cost.md +++ b/evidence/storage/connection-cost.md @@ -44,7 +44,9 @@ python3 -I /scaling-improvement/probe_conn_run.py "$API" "$PG" `probe_conn_run.py` (хост) для каждого режима запускает `docker exec -i "$API" python - <режим> < probe_conn.py` и читает `cpu.stat` PostgreSQL до и после. План: `ping` 3 000, `noping` 3 000, -`fresh` 600, затем то же ещё раз. +`fresh` 600, затем то же ещё раз. Сам `probe_conn_run.py` жил в +scratchpad и в репозиторий не сохранён: его логика — этот абзац и +раздел «Что меряется» выше; скрипт в реплике — целиком ниже. Скрипт в реплике (`probe_conn.py`, без изменений с пробы propose): diff --git a/evidence/tests/bench-restore-quick.md b/evidence/tests/bench-restore-quick.md index ead48fc0..116f9e3b 100644 --- a/evidence/tests/bench-restore-quick.md +++ b/evidence/tests/bench-restore-quick.md @@ -62,4 +62,6 @@ exit=0 Попутно: backup в пересчёте на сообщение вырос с ~40 до ~135 байт (лаба 2 — 36,9–40,9, здесь 131,9–137,5). Это строки `idempotency_keys`, по одной на сообщение. Это наблюдение самопроверки -на батарее, а не замер; цену ключа измеряет трек 1 (`PLAN.md`). +на батарее, а не замер; цена ключа отдельно не измерялась (она входит +в стоимость записи всех меток лабы 3, `REPORT.md`, «Ограничения и +следующие шаги»). diff --git a/evidence/tests/scaling-improvement-checks.md b/evidence/tests/scaling-improvement-checks.md index dddb62f8..c285372b 100644 --- a/evidence/tests/scaling-improvement-checks.md +++ b/evidence/tests/scaling-improvement-checks.md @@ -274,7 +274,8 @@ R* основной ячейки выросла на 32 % (≈ 5 ступене ## 11. Попытка 2 (окончательная) Хост перезагружен; перед A/A2 и перед `make bench_ab` — условия -пользователя (`hostcheck.sh` в scratchpad, `LC_ALL=C`: в локали хоста +пользователя (`hostcheck.sh` в scratchpad, в репозиторий не сохранён: +что он проверял — столбцы таблицы ниже; `LC_ALL=C`: в локали хоста дроби печатаются через запятую): питание от сети, процесса `zoom.us` нет, средняя нагрузка за 5 мин < 8, Spotlight (`mds_stores`, `mdworker`) < 15 % CPU, выгрузок в swap 0, посторонних контейнеров нет.