3.2 KiB
Расширения лабораторной 5
Обязательный контракт contracts/openapi.json не изменён. Ниже — операторский интерфейс и параметры pipeline, нужные для уровня 4 и трека 5. Эти маршруты не входят в публичный API и требуют заголовок X-Operator-Token.
Pipeline
Ключ эффекта: (attachment_id, pipeline_version, variant).
| Версия | Назначение | JPEG thumbnail/crop | WebP optimized |
|---|---|---|---|
| 1 | Основной курс | quality 85, optimize, без progressive и без EXIF | quality 80, method 6, lossy |
| 2 | Эксперимент идемпотентности | quality 60 / 70 | quality 50, method 4 |
Геометрия одинаковая: thumbnail вписывается в 256×256 без увеличения, crop — центр 128×128, optimized вписывается в 1280×1280 без увеличения. EXIF orientation применяется до кодирования, альфа-канал кладётся на белый. Метаданные исходника в варианты не копируются. Версия 2 нужна только чтобы отличить новый результат от старого по SHA-256.
Повторная доставка, смена порядка и устаревшая версия не создают второй набор объектов одной и той же версии и не заменяют уже опубликованный более новый ready_pipeline_version.
Операторские маршруты
POST /internal/control/outbox{"paused": true}— остановить публикацию outbox после COMMIT.POST /internal/control/fault{"mode": "before_effect"|"after_s3"|"after_commit"|"duplicate"|"transient"|"permanent", "remaining": 1}— одноразовая инъекция.transientуменьшаетremaining.POST /internal/control/backpressure{"max_queued_jobs": 0}илиnull— вернуть лимит окружения.GET /internal/metrics,GET /internal/attachments/{id},GET /internal/failed.POST /internal/attachments/{id}/replay— новая попытка того жеjob_id. Ужеreadyзадание не исполняется повторно.POST /internal/attachments/{id}/reprocess{"pipeline_version": 2}— новая версия pipeline.POST /internal/jobs/{id}/redeliver— ещё одна доставка того же сообщения брокером.
Повторы
JOB_MAX_ATTEMPTS по умолчанию 5. Временная ошибка возвращает задание в queued с задержкой base * 2^(attempt-1), умноженной на случайный коэффициент 0.5–1.5, но не дольше JOB_BACKOFF_CAP_SECONDS. Постоянная ошибка и исчерпание попыток пишут failed_jobs и копию сообщения в DLQ. Коды: invalid_image, processing_failed, retry_exhausted.