IOBackup v1.0.0

Примеры YAML-конфигураций

На этой странице собраны готовые YAML-примеры заданий и фрагментов конфигурации IOBackup. Их можно использовать как основу для своих заданий: открыть пример с подсветкой синтаксиса, скопировать YAML и привести пути, хранилища и переменные окружения в соответствие с вашей инфраструктурой.

Перед запуском любого примера замените тестовые адреса, пути, имена баз, bucket, prefix и переменные окружения на свои значения. Не храните пароли и ключи доступа прямо в YAML — используйте переменные окружения или отдельные файлы секретов (документация по полям).

Быстрый старт (локальное хранилище)

Минимальные примеры: каталог или база в локальный каталог — удобно для первого запуска и проверки агента.

filesystem-local.yaml

Описание: Сохраняет каталог с сервера в локальный каталог (часто /tmp/backups или свой путь).

Ссылки: Просмотр · Сырой YAML

postgres.local.yaml

Описание: Дамп PostgreSQL в локальное назначение.

Ссылки: Просмотр · Сырой YAML

mysql.local.yaml

Описание: Дамп MySQL в локальный каталог.

Ссылки: Просмотр · Сырой YAML

postgres-local.yaml

Описание: Каноническое имя файла для примера postgres local (дубликат postgres.local.yaml).

Ссылки: Просмотр · Сырой YAML

mysql-local.yaml

Описание: Каноническое имя файла для примера mysql local (дубликат mysql.local.yaml).

Ссылки: Просмотр · Сырой YAML

Потоковая отправка в S3 без полной промежуточной копии

Streaming: данные уходят в S3 по мере чтения, без обязательного хранения всего объёма на диске агента.

filesystem.s3.streaming.yaml

Описание: Потоковое резервное копирование файлов в S3 без полной промежуточной копии на диске агента.

Ссылки: Просмотр · Сырой YAML

mysql.s3.streaming.yaml

Описание: Потоковое резервное копирование MySQL в S3 без полной промежуточной копии на локальном диске.

Ссылки: Просмотр · Сырой YAML

postgres.s3.streaming.yaml

Описание: Потоковый дамп PostgreSQL в S3.

Ссылки: Просмотр · Сырой YAML

Если на сервере нет нужных утилит (Docker)

Утилиты дампа или aws-cli в контейнере — когда на хосте не установлены нужные инструменты, но доступен Docker.

mysql.s3.docker-fallback.yaml

Описание: MySQL → S3 через mysqldump в контейнере (Docker runner).

Ссылки: Просмотр · Сырой YAML

postgres.s3.docker-fallback.yaml

Описание: PostgreSQL → S3 с pg_dump в Docker runner.

Ссылки: Просмотр · Сырой YAML

filesystem.s3.aws-docker-fallback.yaml

Описание: Файловая система → S3: утилиты aws в Docker, если их нет на хосте.

Ссылки: Просмотр · Сырой YAML

Production-сценарии и политики

Правила хранения, проверка после запуска, webhook, таймауты и составные примеры — как основа для собственного регламента.

full-production.yaml

Описание: Составной production-пример: несколько заданий, webhook, retention, таймауты и проверки.

Ссылки: Просмотр · Сырой YAML

job-with-retention.yaml

Описание: Задание с правилами хранения старых копий.

Ссылки: Просмотр · Сырой YAML

job-with-verify-after-run.yaml

Описание: После успешного запуска включается проверка доступности копии (verify.after_run).

Ссылки: Просмотр · Сырой YAML

job-with-webhooks.yaml

Описание: События о запуске, успехе и ошибке во внешнюю систему (webhook).

Ссылки: Просмотр · Сырой YAML

s3.destination.yaml

Описание: Фрагмент настройки S3-хранилища как назначения.

Ссылки: Просмотр · Сырой YAML

Webhooks (безопасный payload)

Минимальный job с token_env и policy — как шаблон без plaintext секретов в YAML.

webhook-safe.yaml

Описание: Минимальный job с webhook: только token_env, без plaintext секретов.

Ссылки: Просмотр · Сырой YAML

Файловая система: дополнительные варианты

Другие варианты путей имён файлов, S3 без streaming, переменные окружения и отправка по SSH.

filesystem-s3.yaml

Описание: Копирует файлы с сервера в S3-совместимое объектное хранилище.

Ссылки: Просмотр · Сырой YAML

filesystem.local.yaml

Описание: Вариант с локальными путями в стиле «точечных» имен файлов.

Ссылки: Просмотр · Сырой YAML

filesystem.s3.env.streaming.yaml

Описание: Как filesystem.s3.streaming, с параметрами через переменные окружения.

Ссылки: Просмотр · Сырой YAML

filesystem.ssh.streaming.yaml

Описание: Потоковая отправка архива файлов на удалённый узел по SSH.

Ссылки: Просмотр · Сырой YAML

PostgreSQL: дополнительные варианты

Дамп в S3 и альтернативное имя файла примера (postgresql.local).

postgres-s3.yaml

Описание: Дамп PostgreSQL → объектное хранилище.

Ссылки: Просмотр · Сырой YAML

postgresql.local.yaml

Описание: PostgreSQL локально — альтернативное имя примера.

Ссылки: Просмотр · Сырой YAML

MySQL: дополнительные варианты

Дамп MySQL в S3 без streaming — если не нужен потоковый режим.

mysql-s3.yaml

Описание: Дамп MySQL → S3; проверьте переменные для пароля и ключей.

Ссылки: Просмотр · Сырой YAML

ClickHouse

Примеры резервного копирования ClickHouse.

clickhouse-s3.yaml

Описание: Снимок ClickHouse → S3.

Ссылки: Просмотр · Сырой YAML

clickhouse.local.yaml

Описание: Снимок ClickHouse в локальное хранилище.

Ссылки: Просмотр · Сырой YAML

OpenLDAP

Примеры резервного копирования OpenLDAP (разные варианты имён файлов).

openldap-local.yaml

Описание: Экспорт каталога OpenLDAP в локальное хранилище.

Ссылки: Просмотр · Сырой YAML

openldap.local.yaml

Описание: OpenLDAP локально.

Ссылки: Просмотр · Сырой YAML

Vault

Примеры резервного копирования данных Vault (разные варианты имён файлов).

vault-local.yaml

Описание: Резервное копирование данных из Vault KV в локальный путь.

Ссылки: Просмотр · Сырой YAML

vault.local.yaml

Описание: Vault локально.

Ссылки: Просмотр · Сырой YAML

Docker Compose

Примеры сохранения конфигурации и окружения Docker Compose.

docker-compose-local.yaml

Описание: Снимок проекта Docker Compose в локальное хранилище.

Ссылки: Просмотр · Сырой YAML

docker-compose.local.yaml

Описание: Docker Compose: альтернативное имя файла примера.

Ссылки: Просмотр · Сырой YAML

Future / reserved (не исполнять как готовый job)

Только каталог `examples/future/`: ожидаемо не проходят submit или требуют включённых feature gates. См. `examples/future/README.md`.

future/filesystem-incremental-restic.yaml

Описание: Reserved source filesystem_incremental — ожидайте SOURCE_UNSUPPORTED.

Ссылки: Просмотр · Сырой YAML

future/encryption.yaml

Описание: Encryption в backup — ENCRYPTION_UNSUPPORTED при features.encryption=false.

Ссылки: Просмотр · Сырой YAML

future/hooks.yaml

Описание: Hooks в task — HOOKS_UNSUPPORTED при features.hooks=false.

Ссылки: Просмотр · Сырой YAML

Дополнительные примеры

Файлы в каталоге examples/, не вошедшие в группы выше.

filesystem.local.encrypted.yaml

Описание: Готовый фрагмент конфигурации; откройте просмотр для деталей.

Ссылки: Просмотр · Сырой YAML

retention-dry-run.local.yaml

Описание: Готовый фрагмент конфигурации; откройте просмотр для деталей.

Ссылки: Просмотр · Сырой YAML

runtime-hooks.local.yaml

Описание: Готовый фрагмент конфигурации; откройте просмотр для деталей.

Ссылки: Просмотр · Сырой YAML

scheduler.local.yaml

Описание: Готовый фрагмент конфигурации; откройте просмотр для деталей.

Ссылки: Просмотр · Сырой YAML

Как выбрать пример

  1. Начните с группы «Быстрый старт», если нужен простой локальный сценарий.
  2. Для отправки в S3 без полной промежуточной копии на диске — группа «Потоковая отправка в S3».
  3. Если на хосте нет mysqldump, pg_dump или aws CLI — смотрите группу с Docker fallback.
  4. Для регламента с политиками и уведомлениями — «Production-сценарии», затем адаптируйте под себя.
  5. Остальные группы — по типу данных (файлы, PostgreSQL, MySQL, Vault и т. д.). Точные поля см. в документации.

Подробности по полям, ошибкам валидации и API см. техническую документацию IOBackup.