lab3: доказательство операторского GC журнала идемпотентности

Вставлены просроченная и свежая записи, выполнен npm/CLI-прогон GC внутри
контейнера API: удалена ровно просроченная (expired_left=0), свежая осталась.
Файл evidence/level4/idempotency-gc.txt добавлен в отчёт и индекс доказательств.
This commit is contained in:
2026-10-15 23:25:08 +03:00
parent 06431d824b
commit 1802ca12d4
3 changed files with 20 additions and 0 deletions
+1
View File
@@ -135,6 +135,7 @@ Argon2id, Basic→Bearer-сессии в общем Redis, чаты, keyset-па
| Последовательная остановка каждой реплики под нагрузкой: RPS, ошибки, восстановление | `python3 scripts/lab3/lab3.py failover --replicas all --rate 200 --duration 60` | по каждой реплике: 0 ошибок у клиента и у LB, 0 дублей и 0 потерь, реплика возвращается за ≈3 s; k6 держит 200 req/s без dropped | `evidence/level4/failover-sweep.json`, `.md` |
| Лимиты CPU/RAM, отсутствие портов API, отсутствие `container_name`, секреты | `docker inspect`, `docker compose ps/config` | у api `NanoCpus`/`Memory` = лимитам конфигурации, `bindings=map[]`; суммарные лимиты стенда 2304 MiB; `container_name` отсутствует; пароль БД и токен метрик в трекаемых файлах не встречаются | `evidence/level4/limits-and-ports.txt` |
| Rolling update под нагрузкой, миграции однократно | `python3 scripts/lab3/lab3.py rolling-update --under-load --rate 200 --build-id …` | реплики заменяются по одной, `BUILD_ID` и image id меняются, 0 ответов 5xx из 884 попыток, `migrate` не перезапускался | `evidence/level4/rolling-update.json`, `.md` |
| Идемпотентность: удаление просроченных ключей | `docker compose --env-file .env exec -T api node dist/messages/idempotency/idempotency-gc.cli.js` (или `npm run idempotency:gc`) | GC удаляет ровно просроченную запись (created_at = now() − 2 суток): `Purged 1`, `expired_left=0`, свежая запись не тронута (`fresh_left=1`) | `evidence/level4/idempotency-gc.txt` |
| Отказы зависимостей | `make test-dependencies` | 2/2: bounded `503 unavailable` с `request_id` для Redis и PostgreSQL, запрос без сессии остаётся `401`, после возврата зависимости данные и сессия целы | `evidence/level4/dependency-faults.txt` |
| Трек 1: цена масштабирования | `python3 scripts/lab3/lab3.py sweep/growth/ab/analyze` | серия 1/2/4 реплики, точки сатурации, серия роста ресурсов, подтверждённое улучшение | `evidence/track1/summary-*.md`, `evidence/track1/graphs/*.png`, `evidence/track1/raw/` |
| Воспроизводимость с чистого clone | `git clone -b lab3 … /tmp/lab3-clean` → `cp .env.example .env` → `docker compose down -v` → `make stand-up && make test && make test-persistence && make test-failover` | `PASS`: миграции применяются с пустого тома, smoke, сохранность и отказ реплики проходят без правок репозитория | `evidence/level3/clean-clone.txt` |
+1
View File
@@ -26,6 +26,7 @@
| `level4/idempotency-concurrency.txt` | 4 теста идемпотентности, включая 8 параллельных POST с одним ключом через LB: одно сообщение, один id; другой body → 409; без ключа → 400 | `python3 scripts/lab3/lab3.py check idempotency` |
| `level4/failover-sweep.json`, `.md` | отказ каждой реплики под нагрузкой 200 req/s: 0 ошибок клиента и LB, 0 дублей, 0 потерянных подтверждений, реплика возвращается за ≈3 s, HAProxy помечает узел `DOWN` | `python3 scripts/lab3/lab3.py failover --replicas all --rate 200 --duration 60` |
| `level4/rolling-update.json`, `.md` | поочерёдная замена реплик под нагрузкой: `BUILD_ID`/image id меняются по шагам, 0 ответов 5xx из 880 попыток, `migrate` не перезапускался | `python3 scripts/lab3/lab3.py rolling-update --under-load --rate 200 --build-id <id>` |
| `level4/idempotency-gc.txt` | операторский GC удаляет ровно просроченную запись журнала идемпотентности и не трогает свежую | `docker compose --env-file .env exec -T api node dist/messages/idempotency/idempotency-gc.cli.js` |
| `level4/dependency-faults.txt` | bounded `503 unavailable` (с `request_id`, без деталей драйвера) при отказе Redis и PostgreSQL, `401` без сессии остаётся, после возврата зависимости данные и сессия целы | `make test-dependencies` |
| `level4/limits-and-ports.txt` | лимиты CPU/RAM каждого контейнера, отсутствие опубликованных портов у реплик API, отсутствие `container_name`, отсутствие секретов в трекаемых файлах | см. команды внутри файла |
+18
View File
@@ -0,0 +1,18 @@
=== Операторский GC журнала идемпотентности (проверка детерминированного SQL)
captured_at 2026-10-15T20:25:04Z
commit: 06431d824bea50776d91836fded8788f3066f877
Сценарий: в журнал вставлены две записи одного пользователя — просроченная
(created_at = now() - 2 days) и свежая (created_at = now()); затем выполнен
операторский прогон GC внутри контейнера API и проверено, что удалена ровно
просроченная запись. Команда (из корня репозитория):
docker compose --env-file .env exec -T api node dist/messages/idempotency/idempotency-gc.cli.js
На хосте без Docker: npm run idempotency:gc (нужен доступный DATABASE_URL).
--- вставка записей: INSERT 0 1 / INSERT 0 1, всего 2
--- вывод GC: Purged 1 idempotency key(s) older than 86400 seconds
--- проверка после GC: expired_left=0, fresh_left=1 (свежая запись не тронута)
Порог берётся из IDEMPOTENCY_TTL_SECONDS (по умолчанию 86400 s = 24 ч, как
требует контракт); фоновый проход с тем же SQL выполняется на реплике не чаще
одного раза на 512 успешных записей под pg_try_advisory_xact_lock.