2.7 KiB
Операторское расширение: сверка 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; на время ручного восстановления нужен согласованный режим обслуживания.