Files
mtusi2026lab5/student-tests
2026-11-16 09:28:38 +03:00
..
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00
2026-11-16 09:28:38 +03:00

Проверки реализации lab5

Нужны Linux amd64, Docker Engine с Compose v2, Python 3.10+ и Pillow. Полный прогон создаёт только синтетические данные. Для сборки нужен доступ к пакетным репозиториям Ubuntu и закреплённым исходникам GitHub.

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt -r student-tests/requirements.txt
make check validate PYTHON=.venv/bin/python
make test-async PYTHON=.venv/bin/python TEST_ARGS="--output evidence/async-suite.json"

Первый запуск собирает API/worker, MinIO и mc из этого репозитория. При повторе можно добавить --no-build, если исходники и Dockerfiles не изменились. Полный тест занимает несколько минут; отдельное ожидание ready ограничено 60 s. Тесты запускайте последовательно: они кратковременно меняют состояние своих API/брокеров и используют ресурсы Docker, хотя имена проектов изолированы.

Отдельные сценарии

После активации venv или с PYTHON=.venv/bin/python:

student-tests/test_upload_async.sh --no-build --output evidence/upload-async.json
student-tests/test_worker_down.sh --no-build --output evidence/worker-down.json
student-tests/test_outbox_crash.sh --no-build --output evidence/outbox-crash.json
student-tests/test_reliability.sh --no-build --output evidence/reliability.json

Эквивалентные Make targets: test-upload-async, test-worker-down, test-outbox-crash, test-reliability; параметры передаются через TEST_ARGS. Каждый сценарий заканчивается неизменённым публичным tests/smoke.py.

  • test_upload_async.sh: worker остановлен → POST 202 со снимком queued → GET queued и content 409 → worker запущен → ready. Проверяются исходные bytes, SHA-256, реальные JPEG/WebP, размеры и метаданные всех трёх вариантов, доступ другого участника и отказ постороннему. Остановка делает GET queued детерминированным: при работающем worker контракт разрешает первый GET ready.
  • test_worker_down.sh: дополнительно создаёт сообщение с queued-вложением, перезапускает PostgreSQL, Valkey, MinIO и API с сохранением volumes, проверяет прежнюю сессию/вложение и запускает worker. В JSON evidence есть реальные container IDs, StartedAt и имена volumes до/после рестарта.
  • test_outbox_crash.sh: API принимает upload с выключенным брокером; API падает с exit 86 после COMMIT до XADD; затем отдельно падает после XADD до published=true. После рестарта та же job завершается без нового POST; повтор события не создаёт второго эффекта. Используются PostgreSQL-сессии, поэтому остановка Valkey не отключает синхронную аутентификацию.
  • test_reliability.sh: атомарный rollback outbox; шесть попыток с backoff/jitter и проверкой due time; replay с checksum и audit; устаревшее событие; SIGKILL после S3 до COMMIT/ACK; watchdog; конкурентные дубли у двух worker; два API-публикатора; retention, presigned complete и гонка GC/upload; RGB PNG на 40 млн пикселей при 512 MiB без swap. Для GC/upload проверяется, что DB INSERT всё ещё находится в паузе до и после S3-пробы; наблюдение после COMMIT не принимается как доказательство гонки.

Изоляция и результаты

Общий runner async_suite.py создаёт случайный lab5test… Compose-проект, частный каталог build/student-tests/<project>, свои env/credentials/volumes и случайный loopback-порт API. Основной LB не запускается. Рабочие .env, secrets, volumes и сервисы других проектов не используются. Экспортированные S3/Compose переменные не могут перенаправить тестовый стенд во внешнее хранилище.

В finally удаляются только собственные контейнеры/volumes и файлы credentials. Каталог с диагностикой остаётся в игнорируемом build. build/ исключён и из Docker build context. При ошибке cleanup runner сообщает точное имя своего проекта; не применяйте глобальный prune. Обрыв питания/SIGKILL самого runner может потребовать удаления его проекта оператором.

--output сохраняет только итог, проверки, ID синтетических объектов, идентификаторы контейнеров/образов, лимиты, время и SHA-256 исходников. Пароли, Bearer-токены, подписанные URL и HTTP bodies в evidence не записываются. Проверки header/JSON используют неизменённые публичные helpers; Pillow независимо декодирует изображения. Измерение RSS/нагрузки не выполняется: memory case подтверждает завершение одного RGB fixture при заданном cgroup limit.

Геометрия изображений отдельно

Если binaries собраны локально с зависимостями из Dockerfile:

.venv/bin/python student-tests/test_thumbnail.py --binary build/thumbnail_smoke
.venv/bin/python student-tests/test_variants.py --binary build/variants_smoke

Второй тест также проверяет центральный crop, WebP без увеличения, округление, EXIF orientation 1–8 для JPEG/PNG, большой PNG eXIf, alpha и удаление metadata.

Уровень 5, трек 2

make test-track2 PYTHON=.venv/bin/python TEST_ARGS="--output evidence/track2.json"
# Если образы уже собраны из текущих исходников:
PYTHON=.venv/bin/python student-tests/test_pipeline_idempotency.sh --no-build

Default — 3 независимых повтора; --repetitions 1 запускает отладочный прогон. Методика, гипотеза, fault-точки и инварианты: infra/track2.md. Используется тот же isolated runner и независимая проверка images; сохраняется отдельный evidence с source/method hashes и SHA объектов каждой версии.