Справочник CLI — резервное копирование и восстановление

komrad-cli backup create

Создаёт набор резервных копий.

komrad-cli backup create [флаги]

Флаг	Тип	Умолчание	Описание
--to	[]string	/var/backups/komrad	Хранилище: локальный путь, sftp:host/path, s3:bucket/prefix или @name из --config. Флаг повторяется.
--passphrase	string	—	Фраза-пароль шифрования (или KOMRAD_BACKUP_PASSPHRASE)
--cipher	string	age	Бэкенд шифрования: age | aes-gcm | openssl
--config	string	—	Путь к komrad-backup.yaml с настройками хранилищ и шифрования
--no-pg	bool	false	Пропустить поверхность PostgreSQL
--no-ch	bool	false	Пропустить поверхность ClickHouse
--no-natsjs	bool	false	Пропустить поверхность NATS JetStream
--no-events	bool	false	Пропустить таблицу событий (только управляющая плоскость)
--ch-mode	string	full	Режим ClickHouse: full | incremental
--ch-base-rotate	string	7d	Создать новую базовую копию, если старше этого возраста
--events-window	string	—	Окно событий: 1h | 1d | 1w | 1m | 6m | 1y | all
--events-since	string	—	Начало периода событий YYYY-MM-DD
--events-until	string	—	Конец периода событий YYYY-MM-DD
--exact	bool	false	Точное окно партиций через логический экспорт
--exclude	[]string	—	Исключить поверхность или под-объект: <поверхность>[:<под>] (например, natsjs, natsjs:EVENTS). Флаг повторяется.
--files	[]string	—	Файловая поверхность: имя=путь. Флаг повторяется.
--pg-bindir	string	—	Директория с pg_dump/pg_restore (по умолчанию — встроенный echelonpg)
--pg-config-dir	string	/etc/echelon/komrad/	Директория конфигов сервисов KOMRAD (для обнаружения БД PostgreSQL)
--fail-fast	bool	false	Прервать выполнение при ошибке любого хранилища

komrad-cli backup verify

Проверяет целостность набора резервных копий.

komrad-cli backup verify <set-dir> [флаги]

Флаг	Тип	Умолчание	Описание
--passphrase	string	—	Фраза-пароль шифрования (или KOMRAD_BACKUP_PASSPHRASE)

Команда проверяет манифест и sha256-контрольные суммы всех блобов. Завершается с ненулевым кодом, если хотя бы один блоб повреждён.

komrad-cli restore

Восстанавливает узел KOMRAD из набора резервных копий.

komrad-cli restore <set-dir> [флаги]

Флаг	Тип	Умолчание	Описание
--passphrase	string	—	Фраза-пароль шифрования (или KOMRAD_BACKUP_PASSPHRASE)
--only	[]string	—	Восстановить только указанные поверхности: postgres | clickhouse | natsjs | files. Флаг повторяется.
--restore-root	string	/	Корневая директория для файловых поверхностей
--pg-bindir	string	—	Директория с pg_dump/pg_restore
--pg-config-dir	string	/etc/echelon/komrad/	Директория конфигов сервисов (для подключения к PostgreSQL)
--config	string	—	Путь к komrad-backup.yaml
--force	bool	false	Игнорировать проверку версии и проверку запущенных сервисов
--no-start	bool	false	Восстановить данные без запуска сервисов
--start	bool	false	Запустить сервисы после восстановления (явно)