Документация

Основы

Обзор

Архитектура

Агент, провайдеры, registry и поток выполнения backup.

YAML / JSON

Формат job (v1)

Схема BackupJob, tasks, defaults, docker runner, ссылки на провайдеры.

Registry

Провайдеры

Списки source, destination, policy, notification и принципы.

Streaming

Потоковая выдача

Streaming-first, артефакты и интеграция с destination.

DEB / RPM

Репозитории пакетов

Локальная раздача, подпись, metadata — без публикации из этого репозитория.

API и запуск

curl · iobackupctl

API и CLI

Примеры запросов, submit, run, validate, verify, артефакты.

Практика

Runbook

Пошаговые сценарии smoke и интеграционных проверок.

YAML

Примеры job

Все образцы из examples/: просмотр с подсветкой и исходные файлы.

Эксплуатация и безопасность

Ops

Эксплуатация

Регламенты, ротация логов, мониторинг, интеграции.

Политика

Retention

Очистка артефактов и аудит удалений.

Качество копий

Verify

Проверка артефактов и verify-run после job.

Hardening

Безопасность

Токены, TLS, секреты, сетевые профили.

Метрики

Prometheus

Счётчики, гистограммы и идеи по алертингу.

Уведомления

Webhooks

События job/task, аутентификация, retry и аудит доставки.

Источники и назначения

Source

Filesystem

Пути, exclude, симлинки и формат tar.gz.

Source

Docker Compose

Snapshot проекта и опционально volumes.

Source

Vault KV

Экспорт секретов из HashiCorp Vault.

Source

OpenLDAP

Snapshot каталога в JSON.

Source

ClickHouse

HTTP-снимок таблиц (JSONL).

Destination

Local

Каталог на диске агента, streaming и retention.

Destination

S3

Bucket через AWS CLI, endpoint и runner local/docker.

Destination

SSH

Запись артефактов по SSH.

Foundation / контракты 0.17-fix.x

Детали сущностей, Bolt, манифеста, статусной матрицы и JSON Schema job — синхронно с каталогом docs/.

Политика

Retention: YAML и dry-run

Поля политики, алиасы, аудит без удаления.

Verify

Коды и причины

Статусы и поле reason у результата проверки.

Справочник

Модель данных

Job, run, task, manifest и связь с HTTP API.

Storage

Layout Bolt

Bucket’ы метаданных и индексы.

Состояния

Run и task lifecycle

Переходы статусов и инварианты.

Артефакт

Схема манифеста

Поле version, checksum, размер.

Жизненный цикл

От backup до удаления

Стадии объекта артефакта в системе.

RC

Pre-RC smoke

Матрица self-contained сценариев перед релиз-кандидатом.

schemas/

JSON Schema job

Спека рядом с Go-валидацией (job.schema.json).

Релизы

Версионирование

Семантика версий совместимо с версией процесса и OpenAPI.

Pre-0.18

Навигатор модели

Сводная таблица ссылок на job, manifest, bolt и статусную матрицу.

Inventory

Capabilities / facts

Feature gates, провайдеры, health readiness, CLI.

UI

Panel Lite

Read-only обзор jobs/runs и сводки health/capabilities.

Bolt

Metadata DB

Retention, backup/check/export, DR-направление.

DR

Ручной DR

Потеря agent.db и восстановление из бэкапов.

API

Коды ошибок

Стабильные error.code и redaction details.

Identity

Агент

Стабильный agent_id, instance_id и ссылки на API.

Risk

Модель угроз

Поверхность атаки и операционный фокус.

Справочный гайд

Обзор для людей

Гайд пользователя (RU)

Смысл платформы, сценарии и практика эксплуатации.