Публичные проверки
Python 3.9+, стандартная библиотека. Сервер уже должен быть запущен; проверки не создают готовое приложение и сами не управляют Docker. make check можно выполнить на исходном skeleton, make test — только после реализации API. Полная OpenAPI-валидация отдельно: make validate после установки requirements-dev.txt в venv.
make check
make test BASE_URL=http://localhost:8080
# без make:
python3 tests/smoke.py --base-url http://localhost:8080
smoke.py выполняет один сквозной сценарий, автоматически выбирая профиль из lab.json: health → три пользователя → вход с lab2 → чат → сообщения → пагинация → ошибки доступа → идемпотентность с lab3 → файл с lab4 → thumbnail с lab5 → logout. Он проверяет JSON по используемому подмножеству схемы, коды/headers, Unicode, SHA-256 оригинала и фактические JPEG-размеры thumbnail. Это публичный минимум, не полный fuzz/security/load suite.
Каждый запуск создаёт уникальных синтетических пользователей, чат и сообщения. Данные автоматически не удаляются: в API курса нет delete. Для чистого повтора используйте отдельный тестовый стенд/volume и осознанный сброс своего окружения. Session tokens хранятся только в памяти процесса и не печатаются/не сохраняются.
Проверка сохранности, lab2+
Скопируйте scripts/restart.example.sh в scripts/restart.sh, реализуйте перезапуск API и всех используемых хранилищ с сохранением volumes и задайте executable bit. Скрипт может опираться на ваш compose.yaml или stack.yaml. Он не должен удалять volumes, повторно seed-ить БД или менять тестовые данные.
chmod +x scripts/restart.sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh
Тест создаёт данные и сессию, запускает указанный файл без shell interpolation, ожидает готовности и проверяет те же данные с прежним токеном. В lab4+ также проверяется исходный файл. Hook может работать до 90 секунд, готовность затем ожидается до 90 секунд. TTL сессии для этого теста — минимум 300 секунд. Успех не доказывает, что hook действительно перезапустил БД: приложите команды/состояния контейнеров до и после.
Проверка отказа, lab3+
Реализуйте scripts/stop-one.sh на основе примера. TARGET_INSTANCE_ID в окружении содержит alias обслужившей тест API-реплики: сопоставьте его своему контейнеру/Swarm task и остановите именно его. Скрипт должен быстро вернуть 0 и оставить эту реплику остановленной; восстановление выполняйте отдельно. Swarm может создать новую task с другим ID — это допустимо.
chmod +x scripts/stop-one.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
Перед отказом тест наблюдает ≥2 API-реплики; 15 секунд отправляет сообщения параллельно выполнению hook, повторяет неопределённый POST с тем же ключом, проверяет восстановление записи за ≤10 секунд, отсутствие остановленной реплики в последних ответах, сохранность подтверждённых сообщений и отсутствие дублей. Ошибки переходного периода учитываются. Затем восстановите реплику и повторите для другой. Скрипт — проверка одного отказа API, не гарантия HA БД/LB/host. Вывод hook скрыт, чтобы не утекли секреты; отлаживайте его отдельно с безопасным выводом.
Нагрузка
python3 tests/load.py --duration 30 --concurrency 4 --output evidence/load.json
Это простой closed-loop генератор POST сообщений; он ограничен производительностью клиента и страдает coordinated omission. Он выдаёт successful RPS, ошибки и p50/p95/p99 только успешных запросов. Во время нагрузки нет прозрачных retry; timeout мог скрыть совершённую запись, поэтому это throughput HTTP-подтверждений, не точный счётчик COMMIT. Изменение размера истории входит в профиль. Для серьёзного исследования используйте k6/Locust/wrk либо свой обоснованный генератор, а не выводите максимальную пропускную способность из одного запуска этого скрипта. Для нагрузки pipeline изображений нужен отдельный сценарий студента.
HTTPS, lab7
make test BASE_URL=https://localhost:8443 CA_FILE=/absolute/path/to/ca.crt
make test-security BASE_URL=https://localhost:8443 CA_FILE=/absolute/path/to/ca.crt
Все скрипты принимают --ca-file/CA_FILE и проверяют серверный сертификат и hostname. --insecure отсутствует. TLS-тест сначала проверяет рабочее доверенное соединение, затем намеренно пустой trust store и именно ошибку проверки сертификата; network timeout не засчитывается как правильный отказ. Внутреннее mTLS, identity/authorization, OpenBao policy и hardening проверяют отдельные тесты студента по trust matrix. Клиентский сертификат внешнему учебному REST-клиенту не требуется: mTLS находится на внутренних связях.
Что ещё остаётся доказать
Smoke не доказывает persistence, число реальных контейнеров, durability брокера, outbox, отсутствие утечек/уязвимостей, полноту telemetry или выполнение уровня 4/5. Конкурентные/нагрузочные/негативные проверки своего решения добавляйте отдельно. Список защиты текущей лабы находится в README.md. Проверки рассчитаны на localhost-стенд, не на production.
Дополнительные проверки реализации lab5
Windows: команды из корня, Python launcher py. Для дополнительных сценариев нужен Pillow (py -m pip install Pillow==12.0.0), для JSON Schema job — jsonschema. Публичные smoke/resilience используют только stdlib и не менялись.
pwsh -File scripts/bootstrap.ps1
docker compose -f docker-compose.yml -f compose.local.yaml -f compose.test.yaml up -d --build
$env:BASE_URL='http://127.0.0.1:18085'
py tests/smoke.py
py tests/pipeline_core.py
py tests/pipeline_faults.py
py tests/pipeline_retention.py
compose.local.yaml меняет только внешний порт на 18085 из-за резервирования 8080 Windows. compose.test.yaml включает закрытые операторские fault points, retry budget=3, lease=8s, timeout=25s, pending limit=6. Ранний lease намеренно создаёт ситуацию ещё живого старого worker. Количество API всегда 2.
- pipeline_core: queued snapshot при остановленных workers, 409 до готовности, сообщение с queued attachment, original/thumbnail/crop/WebP, EXIF/alpha/без увеличения, MIME/corrupt/oversize/filename/ACL, 24 конкурентных повтора через 2 API.
- pipeline_faults: crash publisher до/после publish, API и broker restart при остановленном worker, 24 дубля, worker crash до/после effects/COMMIT/ack, expired lease со старым живым worker, hard timeout, новая версия раньше старой доставки, постоянная/временная ошибка, failed registry и операторский replay/noop. В конце 10 параллельных upload → 6 accepted/4 unavailable, затем drain, RSS/CPU samples и ledger всех 202.
- pipeline_retention: отдельная операторская инъекция полного PNG 49 млн пикселей в staging с согласованными checksum/size (API штатно такой файл отвергает). Worker должен ограничить декодирование. Затем искусственно состаренный FAILED источник очищается, replay после retention отклоняется, свежий orphan и используемый READY original сохраняются.
Запускайте эти сценарии последовательно на изолированном стенде. Они останавливают реальные сервисы и добавляют синтетические данные. Fault injection в обычной конфигурации выключен, HTTP управляющих endpoints нет. После проверок: docker compose -f docker-compose.yml -f compose.local.yaml up -d возвращает production-настройки. Volumes не удалять.
Операторские команды (через существующий dispatcher контейнер):
docker compose exec -T dispatcher python -m pipeline.operator replay ATTACHMENT_UUID
docker compose exec -T dispatcher python -m pipeline.operator upgrade ATTACHMENT_UUID --version 2
Сохранность/failover: py tests/resilience.py --mode persistence --action-script scripts/restart.cmd и py tests/resilience.py --mode failover --action-script scripts/stop-one.cmd. После failover восстановить docker compose -f docker-compose.yml -f compose.local.yaml up -d api. Windows restart hook сохраняет StartedAt до/после всех хранилищ/процессов; stop hook записывает остановленную API. Linux .sh — эквивалентные действия, перед запуском chmod +x.
py tests/pipeline_boundaries.py проверяет межоперационные окна настоящими блокировками: задержка Message INSERT удерживает FOR SHARE на Attachment и запрещает параллельный перевод в FAILED до COMMIT; затем FAILED → POST Message 409. Отдельный holder exclusive cleanup lock блокирует content до освобождения; байты совпадают, shared lock после ответа освобождён. Запускать отдельно, без других инъекций.
py tests/pipeline_ack_guard.py (test profile): после S3 writes worker задерживается, dispatcher останавливается до lease recovery. Проверяется, что истёкший worker не публикует READY и не удаляет pending delivery / publication index. После запуска dispatcher та же job заканчивается на попытке 2 с одним manifest и четырьмя S3 result-объектами.
py scripts/capture_evidence.py сохраняет whitelisted параметры контейнеров, проверку persisted outbox templates по jobs.schema.json, сводку дискретных RSS/CPU samples, JUnit и SHA-256 исходников. .env, secrets и сырой docker inspect в доказательства не записываются.
py tests/pipeline_filename.py: границы filename 255 ASCII / 255 emoji / 256 emoji и скачивание через LB с длинным Content-Disposition.
py tests/pipeline_upload_crash.py останавливает обе API через SIGKILL в подтверждённом окне между S3 PUT и INSERT/COMMIT Attachment. Проверяет отсутствие 202 и записи БД, unreferenced staging и успешный upload с прежней сессией после запуска API. SQL trigger удаляется в finally; staged orphan остаётся для штатного cleanup после grace.
py tests/pipeline_history_capacity.py: создаёт отдельный синтетический чат, заполняет историю до limit−1 через SQL, одновременно отправляет десять разных POST. Ожидаются один 201, девять 413 и ровно limit строк в БД. Строка чата блокируется до COMMIT, поэтому проверка COUNT и запись сериализованы между API-репликами. Данные проверки остаются в учебном volume.
Полный воспроизводимый прогон: py -m pip install -r requirements-tools.txt, затем pwsh -File scripts/run_tests.ps1 при доступном JDK 21. Он последовательно запускает все исполняемые lab5-сценарии в этой папке, оба режима resilience, 30 секунд load, Java-тесты, OpenAPI и проверки стиля. client.py, image_probe.py, pipeline_support.py — вспомогательные модули, используемые сценариями. Общий журнал — evidence/test-suite.txt; профиль со сбоями включается только на время экспериментов, обычная конфигурация восстанавливается в finally.
Стиль собственной реализации: Java AOSP через google-java-format 1.28.0 (JAR проверяется по SHA-256), Python Black 25.9.0. Проверка: py scripts/style.py; исправление форматирования: py scripts/style.py --apply. Публичные Python-тесты и контракты задания не форматируются. Java API-интерфейсы содержат Javadoc и HTTP-аннотации. Контроллеры используют @RequiredArgsConstructor, final-зависимость и один вызов сервиса на операцию; эти правила проверяет style.py. Контроллер скачивания получает от сервиса готовый ResponseEntity с вычисленными заголовками.
Начальная схема находится только в src/main/resources/db/migration/V1__init.sql. py scripts/check_migration.py создаёт временную БД, применяет V1 и сравнивает схему с текущим стендом без истории Flyway; временная БД удаляется в finally. Результаты — evidence/migration-check.txt и migration-check.json. Для уже применённых на этом локальном стенде V1–V4 выполнено отдельное согласование истории через Flyway repair после сравнения схем, с сохранением данных; детали и доказательства в REPORT.md. Обычный запуск на новой БД не требует repair и выполняет одну V1.