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

1. Установка агента

Агент — один статически собранный бинарник и unit-файл. Ему нужен доступ на чтение к данным, которые вы копируете, и исходящее соединение на наш приёмник по TCP 443. Входящих соединений агент не принимает и порт не слушает.

Токен подключения выдаётся в панели и действует 24 часа. После регистрации агент переходит на собственный ключ, а токен становится бесполезен.

Запускайте от отдельного пользователя, а не от root, если копируете только файлы.
Для дампов баз нужен доступ к сокету СУБД и роль с правом чтения всех схем.
Ключ шифрования печатается при первой инициализации ровно один раз. Сохраните его вне этого сервера.

Если вы потеряете ключ шифрования, восстановить копии не сможет никто, включая нас. Это не формальность: у нас физически нет второй половины ключа.

2. Первая копия

Первое задание лучше сделать узким — один каталог или одна база — и убедиться, что оно проходит целиком. Полная копия всего сервера в качестве первого шага обычно упирается в окно обслуживания и маскирует настоящую ошибку конфигурации.

Прогресс виден в панели и в журнале агента. Скорость на первой копии ограничена вашим каналом; мы не шейпим приём.

3. Расписание

Задайте время запуска и максимальную длительность окна. Если задание регулярно выходит за окно, разделите его: два задания по 40 минут ведут себя предсказуемее одного на полтора часа.

Тип данных	Разумный интервал	Примечание
Файлы приложения	1 сутки	Меняются при деплое, а не постоянно
Пользовательские загрузки	1–4 часа	Инкремент мал, окно короткое
PostgreSQL база	1 сутки + WAL	WAL даёт точку на любой момент
MySQL база	6–12 часов	Логический дамп на реплике, если есть

4. Восстановление

Восстановление всегда идёт в новое место, никогда поверх источника. Это осознанное ограничение: восстановление поверх работающей системы — самый частый способ превратить частичную аварию в полную.

Выберите точку восстановления и целевой сервер, где установлен агент.
Укажите каталог назначения. Существующий непустой каталог агент не примет.
Дождитесь завершения и сверьте отчёт: количество файлов и суммарный размер.
Для баз — поднимите экземпляр на восстановленных данных и проверьте его отдельно, до переключения приложения.

Скорость восстановления обычно выше скорости копирования: данные читаются из ближайшего региона и не сжимаются повторно.

5. Проверка целостности

Плановая проверка идёт на нашей стороне и вашего участия не требует. Внеплановую можно запустить вручную — она тарифицируется отдельно и занимает от нескольких минут до нескольких часов в зависимости от объёма.

Отчёт о проверке содержит список сверенных объектов, расхождения и версию агента, которым копия была снята. Расхождения не «схлопываются» в число — вы видите конкретные пути.

6. Частые ошибки

agent: token expired: Токен подключения старше 24 часов. Выпустите новый в панели; переустанавливать агент не нужно.
snapshot: no space for LVM snapshot: В группе томов нет свободного места под снимок. Нужен запас порядка 10–15% от размера тома.
pg: role lacks CONNECT on database: Роль агента не видит одну из баз. Дайте CONNECT либо исключите базу из задания явно.
window exceeded, job marked partial: Задание не уложилось в окно. Данные, успевшие передаться, сохранены; точка помечена как неполная и не используется при проверке.

Не нашли нужного — напишите на support@clouderra.ru, приложив журнал агента за нужный период и идентификатор задания.