Files
mtusi2026lab3-fork/EVIDENCE.md
T
2026-11-02 20:05:33 +03:00

5.0 KiB

Доказательства lab3

Что выполнено в среде подготовки

Реальные локальные результаты находятся в evidence/local/: 37 unit-тестов с подменой внешних зависимостей, проверка структуры контракта, валидация OpenAPI и синтаксиса Python/sh, структурные ограничения Compose. manifest.json перечисляет команды и коды возврата. Это не проверка Docker networking, реальной конкурентности PostgreSQL и исправности Nginx runtime.

Docker CLI и PostgreSQL в этой среде недоступны. В evidence/local/runtime_status.json это записано явно. Результаты lab2 перенесены в evidence/lab2-history/ и не доказывают работу lab3. Утверждение «все критерии оценки 4 пройдены» до прогона на стенде отсутствует.

Как получить реальные результаты уровня 4

docker compose --env-file .env up -d --build
python3 scripts/replicas.py restore
make lab3-evidence

Каждый прогон использует синтетические пользователей, чаты и сообщения. Токены в файлы не сохраняются. По умолчанию evidence/lab3/; для нового прогона задайте --output. Нельзя накладывать несколько сценариев, управляющих одними контейнерами.

Файл Проверяемый факт
00_environment.json UTC-время, платформа, CPU count, длительность и профиль нагрузки
01_docker.txt Реальная версия Docker и daemon
02_compose_config.txt Успешная проверка Compose без вывода credentials
03_processes.json Разные container ID, PID и alias до действия
03_container_limits.txt Фактические CPU/RAM limits и опубликованные порты
04_smoke.txt Публичный smoke именно lab3 через Nginx
05_concurrent_idempotency.json 12 одинаковых одновременных ключей, ≥2 API, одно сообщение
06_failover_api-a.json / api-b Поочерёдный реальный stop; RPS, ошибки, восстановление ≤10 с, данные без дублей
07_public_failover.txt Публичный сценарий с scripts/stop-one.sh
08_rolling_api-a.json / api-b Поочерёдная замена под нагрузкой; новые процессы, подтверждения не потеряны
09_persistence.txt Тот же токен и сообщения после restart всего стенда с volume
10_processes_after.json Состояния реальных процессов после экспериментов
11_nginx.txt Проверенный runtime-конфиг Nginx и текущий upstream
12_student_tests.txt Тесты настоящего PostgreSQL/Redis, включая race/rollback/lost response
result.json PASS только после завершения всех этапов; ошибка — FAIL

В JSON-файлах нагрузки есть успешные RPS всего потока и отдельно read/write, failed attempts, error ratio, p50/p95/p99 успешных запросов, время чтения/записи после начала action. Время action включает вызов и завершение stop/replace. «Восстановление» для stop — первый успешный ответ после завершения hook, отсчитываемый от его запуска; это консервативная метрика, которая не считает ответ ещё работающей целевой API.

Есть две очереди closed-loop клиентов с паузой 20 мс на пару POST+GET. Это проверка корректности при заданной нагрузке, не benchmark максимальной пропускной способности. Неопределённый POST повторяется с тем же ключом и текстом; сверяется вся история, включая сообщения, подтверждённые до действия. Неподтверждённая запись может существовать ровно один раз, поэтому количество строк иногда больше числа подтверждений.

После успешного прогона внесите фактические числа из 06/08 в REPORT.md. Не переносите старые 153 passed или RPS lab2 в результаты lab3.