docs: finalize verified replicated API submission

This commit is contained in:
2026-11-15 19:56:42 +03:00
parent ac5c30c214
commit 40523399b7
3 changed files with 4495 additions and 15 deletions
+15 -14
View File
@@ -1,18 +1,19 @@
## Лабораторная 3
Автор / группа: TODO
Целевая оценка (3/4/5): TODO
Трек 5, если заявлен: TODO
Автор / группа: Маслов / БВТ2301
Целевая оценка: 5
Трек: цена масштабирования.
Что реализовано и что перенесено: TODO
Команды запуска из чистого clone: TODO
Результаты проверок и ссылка на REPORT.md: TODO
Ограничения / известные ошибки: TODO
Источники и использование ИИ: TODO
Собственная реализация ЛР2 перенесена поверх skeleton ЛР3: две API за HAProxy, общие PG-сессии, транзакционная идемпотентность24ч, реальные failover/rolling/persistence hooks. Подтверждено устранение повторного SELECT ACL в чтении истории.
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [ ] Контракт и публичные тесты не ослаблены.
- [ ] make check и make test выполнены; приложен реальный вывод.
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Запуск: `uv sync --locked`, `make bootstrap`, `VCS_REF=$(git rev-parse HEAD) docker compose up -d --build --wait`. Порт8083. Проверки и все команды: [REPORT.md](REPORT.md).
Clean clone `ac5c30c`:88 HTTPtests, lint/check/validate/smoke, отказы обеих API, rolling, restart и runtime hashes — PASS.54 исследовательских прогона,59674 успешных HTTP,0 ошибок измерений. Отдельно документированы краткие ошибки при переключениях; zero-error rolling не заявляется. Один Docker-host/LB/PG остаются SPOF; HTTP только loopback. Удалённый CI отдельно не подтверждён.
Источники: официальные HAProxy/PostgreSQL/Compose, библиотеки по uv.lock. Помощь ИИ использована при разборе требований, подготовке реализации и проверок; выводы подтверждены собственными запусками.
- [x] Весь обязательный минимум и все пункты4 выполнены.
- [x] Контракт и публичные tests сохранены.
- [x] Исходный README сохранён; REPORT содержит запуск и доказательства.
- [x] Отказы, исследование и чистый clone воспроизведены.
- [x] Секреты находятся вне Git и runtime-образа.
+8 -1
View File
@@ -106,7 +106,7 @@ HAProxy 3.2.1 закреплён digest, использует Docker DNS 127.0.0
При PostgreSQL1CPU медиана RPS **211.3→247.4 (+17.1%)**, p95 **220.94→200.82ms**; RPS улучшился в каждой из трёх пар. При PG0.1CPU:29.4→32.8RPS, p951290.65→1298.07ms; здесь выигрыш по медиане мал и один after хуже before, улучшение latency не подтверждено. PG расходует квоту в97.2–100% CPU-периодов при0.1CPU против0–6.2% при1CPU. Это контролируемый пример насыщения общей БД: четыре API не заменяют ресурс PostgreSQL. Всего18849 успешных HTTP,0 ошибок. Один из повторов заметно отличается: короткие окна не дают уверенной оценки дальних хвостов.
Таким образом, выбранный трек завершён с фиксированными и растущими ресурсами, контролем общей БД и подтверждённым улучшением SQL-пути при стандартном PG1CPU. Последующая правка src/api.py меняет только форматирование этой же операции. Итоговый код дополнительно проверяется из чистого clone. Для уровня5 предусмотрены фиксированная суммарная квота API1CPU/1024MiB и серия с ростом ресурсов0.5CPU/256MiB на реплику; 1/2/4 процесса, C1/8/32, два повтора,2с прогрева и6с измерения. Смешанный closed-loop профиль:80% чтений истории limit20 и20% отправок с уникальными ключами. Перед каждой ячейкой в отдельном исследовательском проекте очищается только его новая БД и создаётся100 сообщений. Отдельно сравнивается пул1/10 при N2/C32 в трёх чередующихся повторах. Исходные короткие окна, два повтора основной серии и три настройки пула не позволяют оценить стабильность production-tail; необработанные данные сохранены.
Таким образом, выбранный трек завершён с фиксированными и растущими ресурсами, контролем общей БД и подтверждённым улучшением SQL-пути при стандартном PG1CPU. Последующая правка src/api.py меняет только форматирование этой же операции. Итоговый код дополнительно проверен из чистого clone. Для уровня5 предусмотрены фиксированная суммарная квота API1CPU/1024MiB и серия с ростом ресурсов0.5CPU/256MiB на реплику; 1/2/4 процесса, C1/8/32, два повтора,2с прогрева и6с измерения. Смешанный closed-loop профиль:80% чтений истории limit20 и20% отправок с уникальными ключами. Перед каждой ячейкой в отдельном исследовательском проекте очищается только его новая БД и создаётся100 сообщений. Отдельно сравнивается пул1/10 при N2/C32 в трёх чередующихся повторах. Исходные короткие окна, два повтора основной серии и три настройки пула не позволяют оценить стабильность production-tail; необработанные данные сохранены.
## Вопросы защиты
@@ -143,3 +143,10 @@ uv run --locked python scripts/verify_clean.py --output evidence/clean-clone-new
```
Исследования автоматически удаляют только volumes своих уникальных временных проектов; основной messenger не очищается. CPU/RAM собираются по docker stats в измерительном окне, cgroup cpu.stat подтверждает throttling. memory.peak — lifetime peak контейнера, его нельзя объявлять пиком одного измерительного окна. Модель closed-loop, генератор на том же Mac/Docker VM, фоновые задачи host не изолированы, snapshots страниц не фиксированы. Hardware: Apple M1/8 CPU/8GiB host, Docker VM8CPU/6209978368bytes. Точные версии и hardware сохранены в run.json.
## Итоговая проверка из чистого clone
[evidence/clean-clone-first.json](evidence/clean-clone-first.json): source commit `ac5c30c`, новый `.env`, случайные секреты, пустые volumes, отдельный loopback-порт и отдельное имя образа. `uv sync --locked`, lint/check/validate, build, public smoke и **88 HTTP-тестов за273.11с** прошли. Полная cluster-проверка повторена: обе API остановлены по очереди, повторен rolling, сохранены сообщения/прежние сессии после полного restart. Хеши каждого Python-модуля src в ОБЕИХ новых API совпали с clone; OCI revision обеих — `ac5c30c`; прямые API ports отсутствуют. `git fsck --full` завершён успешно. Временный проект и только его volumes удалены; основной проект сохранён остановленным.
Измерения основной матрицы и сравнения версий привязаны к собственным source/image revisions выше. Чистый clone проверяет итоговое поведение;54 нагрузочных прогона повторно в нём не запускались. После source `ac5c30c` меняются только отчёт, evidence и оформление сдачи.
File diff suppressed because it is too large Load Diff