Files
mtusi2026lab4/contracts/extensions.md

2.7 KiB
Raw Permalink Blame History

Операторское расширение: сверка S3/PostgreSQL

Обязательный OpenAPI лабораторной 4 не изменён. Новых публичных HTTP endpoints нет. CLI python -m src.reconcile [--apply] [--grace-seconds N] выполняется оператором внутри API-контейнера с его scoped S3-credentials. По умолчанию dry-run и grace=3600; минимальное разрешённое значение — 60 секунд, для воспроизводимого эксперимента.

Внутренние состояния Attachment: ready и failed с error_code=missing_object. В lab4 схема успешного Attachment допускает только ready. Поэтому GET metadata или content для внутреннего failed возвращает 409 в общем формате ошибки; новое состояние не публикуется как несовместимый успешный JSON. Привязка failed к сообщению также даёт 409. Все проверки ACL выполняются раньше.

Orphan — ключ из управляемого originals/ без метаданных. Он удаляется только после grace, повторных HEAD/SQL-проверок и при exclusive advisory lock. Missing — старые метаданные без оригинала, подтверждённые HEAD 404. Они сохраняются, а статус меняется на failed. Правильная резервная копия возвращает ready после проверки исходного размера и SHA-256; неправильная остаётся failed.

JSON-результат CLI содержит mode, grace_seconds, scanned_objects/scanned_metadata, list_requests/head_requests, orphan/missing/repaired, fresh_skipped, elapsed_seconds. Поле head_requests считает только HEAD, а не LIST/GET/DELETE и не SQL. Ключи в операторском выводе — внутренняя диагностика; HTTP API их не возвращает. CLI не является планировщиком: оператор запускает его явно, сначала с dry-run.

Безопасность предполагает, что обычные изменения prefix выполняются API и этим reconciler. Внешний администратор с root-правами способен обойти advisory lock; на время ручного восстановления нужен согласованный режим обслуживания.