Files
mtusi2026lab5/docs/lab5-defense.md
2026-11-12 17:28:28 +03:00

3.2 KiB

Памятка к защите лабораторной 5 — оценка 4

Запуск и проверки

./scripts/bootstrap.sh
docker compose up -d --build
./scripts/wait_ready.sh 180
make test
make test-pipeline

make test-pipeline сам останавливает и восстанавливает учебные сервисы. Он создаёт синтетические изображения и пользователей. Результат — evidence/lab5-pipeline.json; токены не записываются. Полная последовательность, включая Go, persistence и failover: make verify-level4.

Что изменилось относительно lab4

Раньше API записывал оригинал в конечный S3 и отвечал 201 ready. Теперь он проверяет файл, сохраняет его в приватный staging/, затем в одной транзакции создаёт attachment, job и outbox. Ответ — 202 queued. API не выполняет resize, даже когда worker недоступен. Проверка допустимости изображения до приёма остаётся синхронной и ограниченной по ресурсам.

Outbox relay читает зафиксированные намерения и отправляет JSON в Redis Streams. Отдельный worker забирает задание, арендует его в PostgreSQL и создаёт оригинал, thumbnail, crop и optimized. Метаданные всех вариантов публикуются одной транзакцией вместе с ready; после этого staging удаляется и выполняется ack.

docker compose run --rm --no-deps worker ./worker -mode=failed
docker compose run --rm --no-deps worker ./worker -mode=replay \
  -job=<UUID_из_реестра> -reason='S3 восстановлен'

Replay разрешён только для failed с сохранённым staging. Запись причины попадает в job_replays; нумерация попыток монотонная, после replay даётся новый ограниченный бюджет. Повтор replay для queued/processing/ready отклоняется. После retention исходник надо загрузить заново.

Ограничения

Один Docker host, один PostgreSQL, один broker и один S3 — это локальный стенд, а не HA всего сервиса. Лимиты worker защищают машину, но могут отклонить ресурсоёмкое изображение, которое укладывается в 10 MiB и 40 млн пикселей. Старые файлы lab4 сохраняют оригинал; новые uploads проходят pipeline v1. История Redis Streams/outbox/audit в учебной реализации автоматически не сокращается. Сравнение настроек и исследования на оценку 5 не заявляются.