Бэкап файлов и каталогов

Агент Sard читает указанные пути хоста и сохраняет их в репозиторий restic: S3, SFTP или локальный диск. Источник только читается.

Что настраивается

paths: от 1 до 64 абсолютных путей, без вложенных друг в друга.
exclude: шаблоны исключения restic.
one_file_system: не заходить в каталоги других файловых систем.
control_paths: файлы и каталоги, которые при каждом бэкапе обязаны существовать и быть непустыми.

{"paths": ["/etc", "/var/www"], "exclude": ["*.log", "/var/www/cache"], "one_file_system": true}

Бэкап, который не изображает успех

Контрольные пути ловят отмонтированный диск: без них пустой каталог сохранился бы «успешно». Нет контрольного пути или он пуст — шаг завершается ошибкой до запуска restic.

Если часть файлов нечитаема, restic создаёт снимок без них, а шаг завершается ошибкой: молча неполный бэкап хуже упавшего. Снимок остаётся в репозитории с пометкой «неполный» и за успешный не считается. Консоль показывает число файлов и первые пути.

Отпечаток для проверки восстановления

Перед бэкапом агент хеширует (SHA-256) случайную выборку файлов, по умолчанию до 100, и сохраняет отпечаток отдельным снимком. Верификатор восстанавливает снимок на своей машине и сравнивает с отпечатком копию: контрольные пути, хеши выборки, число файлов и их объём.

Права на чтение

Файлы читаются от имени пользователя sard-agent, поэтому ему нужны права на указанные пути. Если их нет, бэкап завершится ошибкой и назовёт нечитаемые пути.