Проверки реализации 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 объектов каждой версии.