Providers и Registry

Модель iobackup основана на capability-based provider интерфейсах и явных registry.

Readiness snapshot (`v0.55.0`)

Verdicts (1.0): docs/providers/provider-readiness-1.0.md
Smoke vs unit vs examples: docs/providers/provider-smoke-coverage.md

Публичный каталог (0.17-fix.70)

Список зарегистрированных на агенте source/destination провайдеров с maturity, capability-тегами и полями deprecation доступен в read-only виде через GET /api/v1/capabilities (и в CLI: iobackupctl agent capabilities, iobackupctl providers list). Это не deep-probe и не заменяет POST /api/v1/jobs/validate?deep=1. Подробнее: docs/reference/capabilities.md.

Стабилизация `0.38.x` (стандарты и harness)

API: соглашения по ошибкам, заголовкам, фильтрации и политике redaction — docs/reference/api-standards.md.
CLI: режимы вывода, коды выхода, токены, offline/metadata — docs/reference/cli-standards.md.
Harness: общий матричный тест Validate для встроенных source/destination — пакет internal/testutil/providerharness (go test ./internal/testutil/providerharness/...); детали покрытия — docs/providers/provider-validation-matrix.md и docs/providers/provider-maturity.md.
JSON Schema ↔︎ Go: частичное машинное выравнивание (например, pattern metadata.job_id) и честный статус полного parity — docs/reference/job-schema-consistency-matrix.md, docs/internal/reports/stabilization-deferred-after-0.33.md.

Maturity и capability-теги (0.17-fix.70)

В каталоге API/CLI у каждого провайдера есть maturity, типичные значения:

stable — сценарий считается основным для production при соблюдении документации.
beta — рабочий, но возможны ограничения или изменения контракта.
experimental — для проб; поведение может меняться.
deprecated / disabled — не использовать в новых job без миграции (см. deprecation_message, remove_after в JSON capabilities).

Примеры строк capability (не исчерпывающий список; точный набор смотрите в ответе capabilities):

source.stream, source.probe
destination.stream_put, destination.get, destination.delete, destination.list, destination.probe, destination.multipart, destination.object_lock

Связанные endpoint’ы: GET /api/v1/capabilities, GET /api/v1/providers/health, GET /api/v1/agent/facts. Матрица зрелости компонентов и провайдеров — docs/internal/roadmap/status-matrix.md. Матрица автоматизированного покрытия валидации/смоков — docs/providers/provider-validation-matrix.md; снимок editorial maturity — docs/providers/provider-maturity.md.

Registry в v1

OperationRegistry
SourceRegistry
DestinationRegistry
PolicyRegistry
NotificationRegistry

Рабочие provider-ы

Source:

filesystem (документация)
postgres
mysql
clickhouse
openldap
vault
docker_compose

Destination:

Docker fallback для утилит

Для provider-ов, завязанных на внешние утилиты, поддерживается запуск через docker:

postgres source (pg_dump): source.config.dump.runner.mode = docker
mysql source (mysqldump): source.config.dump.runner.mode = docker
s3 destination (aws cli upload): destination.config.upload.runner.mode = docker

Можно указать свои образы и docker аргументы:

runner.docker.image
runner.docker.network (для postgres/mysql, по умолчанию host)
runner.docker.extra_args

S3-compatible endpoint/region

Для s3 destination можно задавать endpoint/region через env:

endpoint_env
region_env

Это удобно для S3-compatible провайдеров (Timeweb, MinIO, Ceph RGW и т.д.) и разных окружений без редактирования YAML.

Policy:

retention

Notification:

webhook (документация)

Stub provider-ы