Справочник CLI Rediacc
Обзор
**Rediacc CLI** (`rdc`) — это интерфейс командной строки для управления всеми аспектами платформы Rediacc — аутентификацией, инфраструктурой, репозиториями, очередями, хранилищем и многим другим.
Установка
Загрузите последний бинарный файл для вашей платформы со [страницы релизов Rediacc](https://www.rediacc.com) или установите через ваш менеджер пакетов:
# macOS / Linux
curl -fsSL https://www.rediacc.com | sh
# Or use the packaged binary directly
./rdc --helpГлобальные параметры
Каждая команда поддерживает эти глобальные флаги:
| Флаг | Описание |
|---|---|
--output | Формат вывода (table|json|yaml|csv). Переопределить по умолчанию через REDIACC_DEFAULT_OUTPUT. |
--config | Использовать конкретную конфигурацию для этой команды |
--lang | Переопределение языка ({{languages}}) |
--force | Пропустить подсказки подтверждения |
1. Утилиты агента
Утилиты для AI-ассистентов программирования
1.1 capabilities
Список всех доступных команд с аргументами и опциями
rdc agent capabilities1.2 schema
Показать подробную схему конкретной команды
rdc agent schema [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--command <path> | Выполнить команду вместо интерактивной оболочки | Да | - |
1.3 exec
Выполнить команду с JSON-вводом из stdin
rdc agent exec [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--command <path> | Выполнить команду вместо интерактивной оболочки | Да | - |
1.4 generate-reference
Сгенерировать справочник команд в формате Markdown для навыков Claude
rdc agent generate-reference2. Управление конфигурацией
Управление файлами конфигурации, машинами и SSH-подключениями
Файлы конфигурации хранят данные подключения (URL API, учётные данные, команда/регион/мост по умолчанию), что позволяет быстро переключаться между средами.
2.1 prune
Удаляет лишний груз из локального файла конфигурации по адресу ~/.config/rediacc/<config>.json. Очищаются три категории, все чисто локально (без вызовов SSH/renet): (1) записи кэша сертификатов ACME, чей якорь GUID/репо/машина больше не в активной конфигурации; (2) архивированные репозитории с истёкшим льготным периодом (по умолчанию 7 дней, см. defaults.pruneGraceDays); (3) висячие перекрёстные ссылки (machine→strategy, strategy→repo). Используемые ресурсы, учётные данные, токены хранилища и known-hosts никогда не затрагиваются. По умолчанию изменения применяются; используйте --dry-run для предпросмотра.
rdc config prune [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--dry-run | Предпросмотр того, что будет удалено, без изменения файла конфигурации. Отражает семантику по умолчанию-выкл других команд prune. | Нет | - |
--certs-only | Ограничить корзиной кэша сертификатов ACME. Пропускает очистку архивов и перекрёстных ссылок. Взаимоисключающее с --archives-only и --refs-only. | Нет | - |
--archives-only | Ограничить очисткой просроченных архивов. Пропускает кэш сертификатов и очистку перекрёстных ссылок. Исключающее с --certs-only и --refs-only. | Нет | - |
--refs-only | Ограничить висячими перекрёстными ссылками (machine→strategy, strategy→repo excludes/includes). Пропускает кэш сертификатов и архивы. Исключающее с --certs-only и --archives-only. | Нет | - |
--purge-archived | Удалить ВСЕ архивированные репозитории независимо от возраста, а не только те, которые прошли льготный период. Эквивалентно выполнению 'rdc config repository purge-archived'. Используйте только когда вы уверены, что не нуждаетесь ни в одних из сохранённых учётных данных для восстановления. | Нет | - |
--grace-days <days> | Переопределяет окно льготного периода архива (в днях) для этого вызова. Откатывается к defaults.pruneGraceDays в конфигурации, затем к 7, если ничего не задано. | Нет | - |
2.2 init
Создать новый именованный файл конфигурации
В локальном режиме можно добавлять машины напрямую:
rdc config init [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
--ssh-key <path> | Путь к SSH приватному ключу (например, ~/.ssh/id_rsa) | Нет | - |
--renet-path <path> | Путь к двоичному файлу renet (по умолчанию: renet в PATH) | Нет | - |
--master-password <password> | Зашифровать ресурсы с помощью мастер-пароля | Нет | - |
-u, --api-url <url> | URL API | Нет | - |
--server <url> | URL сервера аккаунта | Нет | - |
2.3 list
Список всех файлов конфигурации
rdc config list2.4 show
Показать детали текущей конфигурации
rdc config show [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--reveal | Показать открытый текст для конфиденциальных значений (только интерактивный режим) | Нет | - |
2.5 delete
Удалить файл конфигурации
rdc config delete [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
2.6 set
Задать значение по умолчанию (команда, регион, мост)
rdc config set [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--key <key> | Ключ конфигурации | Да | - |
--value <value> | Значение конфигурации | Да | - |
Совет: Задав значения по умолчанию, вам не потребуется передавать `--team`, `--region` или `--bridge` с каждой командой.
2.7 clear
Сбросить значения по умолчанию (все или конкретный ключ)
rdc config clear [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--key <key> | Ключ конфигурации | Нет | - |
2.8 recover
Восстановить конфигурацию из файла резервной копии (.bak)
rdc config recover [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
-y, --yes | Пропустить подсказку подтверждения | Нет | - |
2.9 set-ssh
Обновить конфигурацию SSH для текущей конфигурации
rdc config set-ssh2.10 set-renet
Задать путь к бинарному файлу renet для локального режима
rdc config set-renet2.11 ssh
Управление конфигурацией SSH-ключа
set
Задать SSH-ключ для текущей конфигурации
rdc config ssh set [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--key <path> | Путь к файлу закрытого SSH-ключа | Да | - |
--embed | Встроить содержимое ключа в конфигурацию вместо сохранения пути | Нет | - |
show
Показать текущую конфигурацию SSH-ключа
rdc config ssh showremove
Удалить SSH-ключ из текущей конфигурации
rdc config ssh remove2.12 remote
Управление подключением к удалённому хранилищу конфигурации
enable
Привязать эту конфигурацию к удалённому зашифрованному хранилищу
rdc config remote enable [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--headless | Использовать поток кода устройства (для серверов без интерфейса) | Нет | - |
--api-url <url> | URL сервера аккаунта | Нет | - |
disable
Отключиться от удалённого хранилища и сохранить конфигурацию локально
rdc config remote disablestatus
Показать состояние удалённого подключения
rdc config remote statusrefresh
Принудительно загрузить конфигурацию из удалённого хранилища
rdc config remote refresh2.13 machine
Управление машинами в текущей конфигурации
add
Добавить машину в текущую конфигурацию
rdc config machine add [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--ip <address> | IP-адрес или имя хоста машины | Да | - |
--user <username> | Имя пользователя SSH | Да | - |
--port <port> | Порт SSH | Нет | 22 |
--datastore <path> | Путь хранилища данных на машине | Нет | /mnt/rediacc |
remove
Удалить машину из текущей конфигурации
rdc config machine remove [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
list
Показать список машин в текущей конфигурации
rdc config machine listscan-keys
Сканировать SSH-ключи хостов для машин в текущей конфигурации
rdc config machine scan-keys [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Нет | - |
setup
Подготовить удалённую машину для репозиториев (устанавливает renet, настраивает Docker, хранилище BTRFS). Идемпотентно. Требуется после config machine add и перед repo create
rdc config machine setup [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--datastore <path> | Путь к хранилищу данных на удалённой машине | Нет | /mnt/rediacc |
--datastore-size <size> | Размер хранилища данных (напр.: 95%, 100G) | Нет | 95% |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
set-ceph
Задать конфигурацию Ceph RBD для машины
rdc config machine set-ceph [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--pool <name> | Имя пула Ceph (например, rbd) | Да | - |
--image <name> | Имя образа RBD (например, datastore-prod1) | Да | - |
--cluster <name> | Имя кластера Ceph | Нет | ceph |
2.14 repository
Управление привязками репозиториев в текущей конфигурации
add
Добавить привязку GUID репозитория в текущую конфигурацию
rdc config repository add [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--guid <guid> | GUID репозитория (UUID из имён файлов резервных копий) | Да | - |
--tag <tag> | Тег репозитория | Нет | latest |
--credential <credential> | Учётные данные репозитория (парольная фраза для шифрования) | Нет | - |
--network-id <id> | Сетевой идентификатор для изоляции Docker (2816, 2880, ...). Назначается автоматически, если не указан | Нет | - |
remove
Удалить привязку репозитория из текущей конфигурации
rdc config repository remove [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
list
Показать список привязок GUID репозиториев в текущей конфигурации
rdc config repository listlist-archived
Показать список архивированных учётных данных репозиториев
rdc config repository list-archivedrestore-archived
Восстановить архивированные учётные данные репозитория
rdc config repository restore-archived [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--new-name <name> | Новое имя ресурса | Нет | - |
purge-archived
Безвозвратно удалить все архивированные учётные данные
rdc config repository purge-archived2.15 provider
Управление облачными провайдерами для автоматического создания машин
add
Добавить облачного провайдера
rdc config provider add [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--provider <source> | Известный источник провайдера (например, linode/linode, hetznercloud/hcloud) | Нет | - |
--source <source> | Пользовательский источник провайдера OpenTofu (например, vultr/vultr) | Нет | - |
--token <token> | API-токен для облачного провайдера | Да | - |
--region <region> | Регион по умолчанию для новых машин | Нет | - |
--type <type> | Тип/размер инстанса по умолчанию | Нет | - |
--image <image> | Образ ОС по умолчанию | Нет | - |
--ssh-user <user> | SSH-пользователь для новых ВМ (по умолчанию: root) | Нет | - |
--resource <type> | Пользовательский: тип ресурса OpenTofu для ВМ | Нет | - |
--label-attr <attr> | Пользовательский: имя атрибута метки ВМ | Нет | - |
--region-attr <attr> | Пользовательский: имя атрибута региона | Нет | - |
--size-attr <attr> | Пользовательский: имя атрибута типа инстанса | Нет | - |
--image-attr <attr> | Пользовательский: имя атрибута образа ОС | Нет | - |
--ipv4-output <attr> | Пользовательский: атрибут вывода IPv4-адреса | Нет | - |
--ipv6-output <attr> | Пользовательский: атрибут вывода IPv6-адреса | Нет | - |
--ssh-key-attr <attr> | Пользовательский: имя атрибута SSH-ключей | Нет | - |
--ssh-key-format <format> | Пользовательский: формат SSH-ключа (inline_list или resource_id) | Нет | - |
--ssh-key-resource <type> | Пользовательский: тип ресурса OpenTofu для SSH-ключей | Нет | - |
remove
Удалить конфигурацию облачного провайдера
rdc config provider remove [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
list
Показать список настроенных облачных провайдеров
rdc config provider list2.16 storage
Управление бэкендами хранения в текущей конфигурации
import
Импортировать хранилища из конфигурационного файла rclone
rdc config storage import [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--file <path> | Путь к файлу | Да | - |
--name <name> | Импортировать только указанный раздел | Нет | - |
remove
Удалить хранилище из текущей конфигурации
rdc config storage remove [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
list
Показать список хранилищ в текущей конфигурации
rdc config storage list2.17 infra
Управление конфигурацией инфраструктуры (прокси, DNS, сертификаты)
set
Настройка инфраструктуры машины (для машины: IP, домен, порты; общие: email сертификата, CF DNS-токен)
rdc config infra set [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--public-ipv4 <ip> | Публичный IPv4-адрес (для каждой машины) | Нет | - |
--public-ipv6 <ip> | Публичный IPv6-адрес (для каждой машины) | Нет | - |
--base-domain <domain> | Базовый домен для приложений (для каждой машины) | Нет | - |
--cert-email <email> | Email для уведомлений о TLS-сертификатах (общий для всех машин) | Нет | - |
--cf-dns-token <token> | Cloudflare DNS API-токен для ACME DNS-01 проверки (общий для всех машин) | Нет | - |
--tcp-ports <ports> | TCP-порты для проброса (через запятую, например, 25,143,465) | Нет | - |
--udp-ports <ports> | UDP-порты для проброса (через запятую, например, 53) | Нет | - |
show
Показать конфигурацию инфраструктуры для машины
rdc config infra show [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
push
Отправить конфигурацию инфраструктуры на машину (Traefik-прокси, маршрутизатор, Cloudflare DNS). Сначала выполните 'config infra set <machine>'
rdc config infra push [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
2.18 cert-cache
Управление кэшированными TLS-сертификатами
pull
Скачать и кэшировать TLS-сертификаты с машины
rdc config cert-cache pull [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--no-prune | Пропустить очистку устаревших сертификатов сетевых ID | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
push
Загрузить кэшированные TLS-сертификаты на машину
rdc config cert-cache push [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
status
Показать инвентарь кэшированных сертификатов
rdc config cert-cache statusclear
Удалить кэш сертификатов
rdc config cert-cache clear2.19 field
Операции над полями конфигурации по JSON-указателю (get/set/unset/rotate/list). Указатели JSON (RFC 6901), например /credentials/cfDnsApiToken.
get
Прочитать значение конфигурации по указателю JSON. Секретные поля скрываются, если не указан --reveal (только для человека).
rdc config field get [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--pointer <pointer> | JSON Pointer к полю (например, /credentials/cfDnsApiToken) | Да | - |
--reveal | Показать секретные значения в открытом виде (только интерактивный TTY; аудируется) | Нет | - |
--digest | Вывести дайджест SHA-256 вместо значения (безопасно для агентов) | Нет | - |
set
Записать значение конфигурации по JSON-указателю. Для секретных путей требуется --current (шлюз знаний).
rdc config field set [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--pointer <pointer> | JSON Pointer к полю (например, /credentials/cfDnsApiToken) | Да | - |
--new <value> | Новое значение (парсится как JSON, если начинается с {, [, " или равно true/false/null/числу) | Да | - |
--current <value> | Текущее значение в открытом виде — обязательно для изменения секретных путей (доказательство знания) | Нет | - |
unset
Удалить значение конфигурации по JSON-указателю. Для секретных путей требуется --current.
rdc config field unset [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--pointer <pointer> | JSON Pointer к полю (например, /credentials/cfDnsApiToken) | Да | - |
--current <value> | Текущее значение в открытом виде — обязательно для удаления секретных путей | Нет | - |
rotate
Ротация секретного значения без --current. Только интерактивный TTY; подробно аудируется.
rdc config field rotate [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--pointer <pointer> | JSON Pointer к конфиденциальному полю (например, /credentials/cfDnsApiToken) | Да | - |
--new <value> | Новое значение | Да | - |
list
Показать все зарегистрированные шаблоны указателей с типом и политикой commit/шифрования.
rdc config field list [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--sensitive | Показать только секретные (непубличные) шаблоны | Нет | - |
2.20 edit
Открыть активную конфигурацию в $EDITOR как редактированную JSONC-проекцию. Только для человека; агенты отклоняются.
rdc config edit [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--reveal | Показать секретные значения в открытом виде (только интерактивный TTY; аудируется) | Нет | - |
--dump | Вывести текущую конфигурацию в stdout как JSONC вместо открытия редактора (только чтение; безопасно для агентов при редактировании) | Нет | - |
--apply <file> | Применить отредактированный файл JSONC (пропуская запуск $EDITOR) | Нет | - |
--current-secrets <file> | JSON-файл, сопоставляющий указатель→старый открытый текст для шлюза знаний при --apply | Нет | - |
--editor <cmd> | Команда редактора (следует порядку git: --editor > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR) | Нет | - |
2.21 audit
Проверка журнала аудита конфигурации (JSONL с хеш-цепочкой в ~/.config/rediacc/audit.log.jsonl)
log
Вывести недавние записи аудита в формате JSON
rdc config audit log [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--since <spec> | Показать только записи новее (например '24h', '7d', ISO-временная метка) | Нет | - |
--path <glob> | Фильтровать по шаблону JSON-указателя (например /credentials/*) | Нет | - |
--actor <kind> | Фильтровать по виду участника (human|agent) | Нет | - |
tail
Стримить новые записи по мере появления (Ctrl+C — остановка)
rdc config audit tailverify
Проверить целостность SHA-256-цепочки по всем записям аудита
rdc config audit verify2.22 backup-strategy
Управление именованными стратегиями резервного копирования (горячий/холодный режимы, назначения, расписание)
set
Создать или обновить стратегию резервного копирования
rdc config backup-strategy set [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя стратегии (обязательно) | Да | - |
--destination <name> | Имя назначения в рамках стратегии | Нет | - |
--storage <name> | Имя конфигурации хранилища (учётные данные rclone) | Нет | - |
--cron <expression> | Расписание cron (напр. "0 * * * *" для ежечасного запуска) | Нет | - |
--mode <mode> | Режим резервного копирования: "hot" (без простоя) или "cold" (остановка, снимок, перезапуск) | Нет | - |
--bwlimit <limit> | Ограничение пропускной способности rclone (напр. "6M", "10M:off", "08:00,3M;22:00,10M") | Нет | - |
--include <repos> | Копировать только эти репозитории (имена через запятую) | Нет | - |
--exclude <repos> | Исключить эти репозитории из резервного копирования (имена через запятую) | Нет | - |
--folder <path> | Подпапка в хранилище для этого назначения (напр. hot, cold) | Нет | - |
--enable | Включить стратегию или назначение | Нет | - |
--disable | Отключить стратегию или назначение | Нет | - |
remove
Удалить стратегию резервного копирования или назначение
rdc config backup-strategy remove [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя стратегии (обязательно) | Да | - |
--destination <name> | Удалить только это назначение (остальные назначения сохраняются) | Нет | - |
list
Показать все стратегии резервного копирования
rdc config backup-strategy listshow
Показать детали стратегии резервного копирования
rdc config backup-strategy show [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя стратегии (показывает все, если не указано) | Нет | - |
3. Управление хранилищем данных
Управление жизненным циклом хранилища данных Ceph RBD (init, fork, unfork, status)
3.1 init
Инициализировать хранилище данных на машине (локальное или Ceph RBD)
rdc datastore init [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины (где размещено хранилище данных Ceph) | Да | - |
--size <size> | Размер хранилища данных (например, 5G, 50G, 100G) | Да | - |
--backend <type> | Тип бэкенда: local (по умолчанию) или ceph | Нет | local |
--pool <name> | Имя пула Ceph (по умолчанию: из конфигурации машины или rbd) | Нет | rbd |
--image <name> | Имя образа Ceph RBD (по умолчанию: из конфигурации машины через set-ceph) | Нет | - |
--cluster <name> | Имя кластера Ceph (по умолчанию: ceph) | Нет | ceph |
--force | Принудительная инициализация, даже если хранилище данных уже существует (ВНИМАНИЕ: переформатирует хранилище) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
3.2 fork
Создать локальную COW-копию хранилища данных Ceph через снимок RBD + клон (< 2 сек). Сохраните имена снимка/клона из вывода для unfork. Только один fork на целевое имя; выполните unfork перед повторным fork
rdc datastore fork [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины (где размещено хранилище данных Ceph) | Да | - |
--to <name> | Суффикс клона (создаёт клон с именем <image>-fork-<name>). Fork остаётся на исходной машине | Да | - |
--cow-size <size> | Размер резервного файла COW (по умолчанию: auto, увеличивается по мере необходимости) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
3.3 unfork
Очистить fork: отмонтировать COW, удалить клон, удалить снимок
rdc datastore unfork [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины (где размещено хранилище данных Ceph) | Да | - |
--source <image> | Исходный RBD-образ, который был разветвлён (из config set-ceph --image, напр. ds-prod) | Да | - |
--snapshot <name> | Снимок для удаления (значение "Snapshot:" из вывода fork, напр. fork-<timestamp>) | Да | - |
--dest <image> | Образ клона для удаления (значение "Clone:" из вывода fork, напр. ds-prod-fork-<machine>) | Да | - |
--pool <name> | Имя пула Ceph (по умолчанию: из конфигурации машины) | Нет | - |
--mount-point <path> | Точка монтирования fork для отмонтирования (по умолчанию: /mnt/rediacc) | Нет | - |
--force | Продолжить очистку, даже если отдельные шаги не удались (напр., отмонтирование, удаление снимка) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
3.4 status
Показать бэкенд хранилища данных, размер, использование, статус монтирования и cow_mode (если разветвлено)
rdc datastore status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины (где размещено хранилище данных Ceph) | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
4. Управление машинами
Управление удалёнными машинами (статус, контейнеры, сервисы, здоровье)
4.1 list
Список машин
rdc machine list [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--search <text> | Поиск в {{field}} | Нет | - |
--sort <field> | Сортировать по полю | Нет | - |
--desc | Сортировка по убыванию | Нет | - |
4.2 create
Создать новую машину
rdc machine create [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
-b, --bridge <name> | Имя моста | Нет | - |
--vault <json> | Данные хранилища машины в виде строки JSON | Нет | - |
4.3 rename
Переименовать машину
rdc machine rename [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--current-name <name> | Текущее имя ресурса | Да | - |
--new-name <name> | Новое имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
4.4 delete
Удалить машину
rdc machine delete [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
--dry-run | Показать действия без внесения изменений | Нет | - |
4.5 vault
Управление хранилищем машины (только облачный адаптер)
rdc machine vault4.6 vault-status
{{t:cli.commands.machine.vault-status.description}}
rdc machine vault-status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
4.7 update
Обновить конфигурацию машины
rdc machine update4.8 health
Проверить состояние машины для CI/CD пайплайнов
Команда health выводит системные метрики, статус контейнеров, стабильность сервисов и информацию о хранилище — полезно для проверок CI/CD-конвейеров.
rdc machine health [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
4.9 containers
Список запущенных контейнеров на машине
rdc machine containers [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
--health-check | Режим проверки состояния - завершается с кодом 2 при наличии нездоровых | Нет | - |
4.10 services
Список systemd-сервисов на машине
rdc machine services [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
--stability-check | Режим проверки стабильности - завершается с кодом 2 при наличии сбойных/перезапускающихся | Нет | - |
4.11 query
Показать полный статус машины (система, репозитории, контейнеры, сервисы)
rdc machine query [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--system | Включить только информацию о системе | Нет | - |
--repositories | Включить только репозитории | Нет | - |
--containers | Включить только контейнеры | Нет | - |
--services | Включить только сервисы | Нет | - |
--network | Включить только сетевые интерфейсы | Нет | - |
--block-devices | Включить только блочные устройства | Нет | - |
--licenses | Включить статусы лицензий репозиториев | Нет | - |
--storage-health | Показать фрагментацию BTRFS и экономию reflink по репозиториям | Нет | - |
--sync-certs | Также получить кэш сертификатов ACME с машины после запроса | Нет | - |
--strict | Завершиться с ненулевым кодом (код 2), если какой-либо контейнер превысил порог отклонения здоровья | Нет | - |
4.12 vault-status
Показать статус разобранного хранилища для машины
rdc machine vault-status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
4.13 repos
Список развернутых репозиториев на машине
rdc machine repos [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
--search <text> | Фильтровать репозитории по имени | Нет | - |
4.14 test-connection
Тестировать SSH-соединение с машиной и захватить ключ хоста
rdc machine test-connection [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--ip <address> | IP-адрес или имя хоста машины | Да | - |
--user <name> | Имя пользователя SSH | Да | - |
-t, --team <name> | Имя команды | Нет | - |
-b, --bridge <name> | Имя моста | Нет | - |
--port <number> | Порт SSH | Нет | 22 |
--password <pwd> | Пароль SSH для начальной аутентификации | Нет | - |
--datastore <path> | Путь хранилища данных на машине | Нет | /mnt/rediacc |
-m, --machine <name> | Имя машины (для обновления хранилища после теста) | Нет | - |
--save | Сохранить known_hosts в хранилище машины после успешного теста | Нет | - |
Совет: Используйте `--save-known-hosts` для автоматического сохранения ключа хоста в хранилище машины после успешного теста.
4.15 provision
Создать новую машину у облачного провайдера с помощью OpenTofu
rdc machine provision [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--provider <name> | Имя облачного провайдера (из config provider add) | Да | - |
--region <region> | Переопределить регион по умолчанию | Нет | - |
--type <type> | Переопределить тип инстанса по умолчанию | Нет | - |
--image <image> | Переопределить образ ОС по умолчанию | Нет | - |
--ssh-user <user> | Имя пользователя SSH для новой ВМ (по умолчанию: root) | Нет | - |
--base-domain <domain> | Базовый домен для инфраструктуры (напр. example.com). Подразумевает --infra | Нет | - |
--no-infra | Пропустить настройку инфраструктуры (прокси + DNS) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
4.16 deprovision
Уничтожить облачную машину и удалить из конфигурации
rdc machine deprovision [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--force | Пропустить подсказку подтверждения | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
4.17 backup
Управление резервным копированием машины
list
Показать стратегии резервного копирования для всех машин
rdc machine backup listschedule
Развернуть расписание резервного копирования на удалённой машине (таймеры systemd)
rdc machine backup schedule [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--dry-run | Предварительный просмотр сгенерированных юнитов без развёртывания | Нет | - |
--force | Продолжить, даже если в данный момент выполняется резервное копирование (новый юнит применится при следующем срабатывании таймера; запущенный вызов сохранит старый юнит) | Нет | - |
--reset-failed | Сбрасывать состояние failed у затронутых сервисов после успешного развёртывания (по умолчанию выключено, сохраняет сигнал об ошибках) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
now
Немедленно запустить резервное копирование на удалённой машине
rdc machine backup now [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--strategy <name> | Имя стратегии (запускает все, если не указано) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
status
Показать статус резервного копирования и состояние таймера на удалённой машине
rdc machine backup status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--strategy <name> | Показать подробности для конкретной стратегии | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
cancel
Отменить выполняемое резервное копирование на удалённой машине
rdc machine backup cancel [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
--strategy <name> | Имя стратегии (отменяет все, если не указано) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
4.18 prune
Удалить осиротевшие ресурсы хранилища данных и устаревшие снапшоты с машины
rdc machine prune [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--dry-run | Показать, что будет удалено, без внесения изменений | Нет | - |
--orphaned-repos | Также удалить образы репозиториев, отсутствующие во всех конфигурациях | Нет | - |
--prune-unknown | Удалить только репо, которые зеркало renet .interim/state не может классифицировать (не в локальной конфигурации И без отмеченного как форк зеркала). Строго уже, чем --orphaned-repos: форки без конфигурации сохраняются, когда зеркало их идентифицирует. Pre-mirror унаследованные сироты и устаревшие grands, чья конфигурационная запись была удалена, оба попадают в эту корзину. | Нет | - |
--force-delete-mounted | Переопределить предполётную проверку монтирования и удалить репозитории, даже если они в данный момент смонтированы или имеют запущенные контейнеры Docker. Отличается от --force (который переопределяет только льготный период архива). Применяется как к --orphaned-repos, так и к --prune-unknown. | Нет | - |
--force | Пропустить подсказки подтверждения | Нет | - |
--grace-days <days> | Период отсрочки в днях для недавно архивированных репозиториев (по умолчанию: 7) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
5. Сервер MCP
Сервер Model Context Protocol для AI-агентов
5.1 serve
Запустить MCP-сервер (транспорт stdio)
rdc mcp serve [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--config <name> | Имя конфигурации для всех команд | Нет | - |
--timeout <ms> | Тайм-аут команды по умолчанию в миллисекундах | Нет | 120000 |
--allow-grand | Разрешить деструктивные операции над grand-репозиториями (не fork). По умолчанию: режим только fork | Нет | - |
6. Жизненный цикл репозиториев
Развёртывание и управление зашифрованными репозиториями на машинах
6.1 mount
Смонтировать репозиторий (открыть контейнер LUKS)
rdc repo mount [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--checkpoint | Восстановить из контрольной точки после монтирования | Нет | - |
--no-docker | Не запускать Docker-демон после монтирования | Нет | - |
--parallel | Запускать репозитории параллельно | Нет | - |
--concurrency <n> | Максимум параллельных репозиториев (по умолчанию: 3) | Нет | 3 |
-y, --yes | Пропустить подтверждение для пакетных операций | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.2 unmount
Размонтировать репозиторий
rdc repo unmount [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--checkpoint | Создать контрольную точку перед размонтированием | Нет | - |
--parallel | Запускать репозитории параллельно | Нет | - |
--concurrency <n> | Максимум параллельных репозиториев (по умолчанию: 3) | Нет | 3 |
-y, --yes | Пропустить подтверждение для пакетных операций | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.3 up
Развернуть или обновить репозиторий (монтирование, запуск сервисов)
rdc repo up [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--skip-checkpoint | Пропустить восстановление из checkpoint CRIU, даже если данные checkpoint существуют (принудительный чистый запуск) | Нет | - |
--tls | Запросить выделенный TLS-сертификат для этого репозитория (форки по умолчанию используют общий сертификат машины) | Нет | - |
--include-forks | Также монтировать/запускать форкнутые репозитории | Нет | - |
--mount-only | Только монтировать, не запускать сервисы | Нет | - |
--parallel | Запускать репозитории параллельно | Нет | - |
--concurrency <n> | Максимум параллельных репозиториев (по умолчанию: 3) | Нет | 3 |
-y, --yes | Пропустить подтверждение для пакетных операций | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
--dry-run | Показать действия без внесения изменений | Нет | - |
6.4 up-all
Развернуть все репозитории на машине
rdc repo up-all6.5 down
Остановить сервисы репозитория
rdc repo down [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--unmount | Размонтировать репозиторий после остановки | Нет | - |
--checkpoint | Создать checkpoint CRIU перед остановкой (сохранить состояние памяти процессов для последующего восстановления через 'repo up') | Нет | - |
-y, --yes | Пропустить подтверждение для пакетных операций | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
--dry-run | Показать действия без внесения изменений | Нет | - |
6.6 status
Получить статус репозитория
rdc repo status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.7 list
Список репозиториев на машине
rdc repo list [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя целевой машины | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.8 create
Создать новый зашифрованный репозиторий
rdc repo create [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--size <size> | Размер репозитория (напр. 10G, 100G, 1T) | Да | - |
--no-docker | Не запускать Docker-демон после создания | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.9 delete
Удалить репозиторий (уничтожает контейнеры, тома и зашифрованный образ). Запись конфигурации сохраняется. Используйте --archive-config для перемещения учётных данных в deletedRepositories для восстановления через 'config restore-archived'
rdc repo delete [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--archive-config | Переместить запись конфигурации в deletedRepositories для последующего восстановления | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
--dry-run | Показать действия без внесения изменений | Нет | - |
6.10 fork
Создать CoW-форк (копирование при записи) репозитория
rdc repo fork [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--parent <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--tag <name> | Тег для форка (создаёт имя:тег) | Да | - |
--checkpoint | Создать checkpoint CRIU на источнике перед fork (захватить состояние памяти процессов для восстановления в fork) | Нет | - |
--up | Монтировать и запустить сервисы после форка (fork + mount + up одной командой) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.11 takeover
Заменить данные главного репозитория данными форка. Главный сохраняет свою идентичность (GUID, networkId, домены, автозапуск, цепочку резервных копий), но получает обновлённые данные форка. Старые производственные данные сохраняются как резервный форк. Использование: протестировать обновление на форке → проверить → перенести в продакшн.
rdc repo takeover [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--force | Пропустить предупреждения об изменениях | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.12 resize
Изменить размер репозитория офлайн (поддерживает увеличение и уменьшение)
rdc repo resize [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--size <size> | Новый размер репозитория (напр. 10G, 100G, 1T) | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.13 expand
Расширить смонтированный репозиторий онлайн (без простоя)
rdc repo expand [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--size <size> | Новый размер репозитория (напр. 10G, 100G, 1T) | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.14 validate
Проверить целостность репозитория
rdc repo validate [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.15 autostart
Управление автозапуском репозиториев при загрузке
enable
Включить автозапуск для репозитория
rdc repo autostart enable [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
disable
Отключить автозапуск для репозитория
rdc repo autostart disable [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
list
Показать репозитории с включённым автозапуском
rdc repo autostart list [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя целевой машины | Да | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.16 ownership
Изменить владельца каталога репозитория
rdc repo ownership [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
--uid <uid> | UID владельца (по умолчанию: 7111) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.17 template
Применить шаблон к репозиторию
list
Список всех встроенных шаблонов развёртывания CLI
rdc repo template listapply
Apply a template to a repository. Use a built-in template name (e.g. app-postgres) or --file for a custom JSON template. The template writes Rediaccfile, docker-compose.yml, and any additional files to the repository mount
rdc repo template apply [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя целевой машины | Да | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Да | - |
--file <path> | Путь к файлу шаблона JSON | Нет | - |
--grand <name> | Имя главного репозитория (автоматически разрешается в GUID) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.18 push
Отправить репозиторий на удалённый ресурс (машину или хранилище). Опустите имя для отправки всех репозиториев. Тип цели определяется автоматически из конфигурации. При передаче между машинами зашифрованный образ репозитория копируется с тем же GUID — это резервное копирование/миграция, а не форк. Для создания независимого форка сначала используйте 'repo fork', затем push. Используйте --up для развёртывания после push
rdc repo push [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
--to <remote> | Имя целевой машины или хранилища (определяется автоматически из конфигурации) | Нет | - |
--to-machine <machine> | — | Нет | - |
--provision <provider> | Автоматически создать целевую машину через облачного провайдера, если она не существует | Нет | - |
--checkpoint | Создать контрольную точку CRIU перед резервным копированием (захват состояния памяти процессов для живой миграции) | Нет | - |
--force | Принудительно перезаписать существующую резервную копию | Нет | - |
--up | После отправки смонтировать и развернуть репозиторий на целевой машине | Нет | - |
--tag <tag> | Тег развёртывания для управления версиями | Нет | - |
-m, --machine <name> | Имя машины | Да | - |
-w, --watch | Следить за изменениями | Нет | - |
--parallel | Запускать репозитории параллельно | Нет | - |
--concurrency <n> | Максимум параллельных репозиториев (по умолчанию: 3) | Нет | 3 |
-y, --yes | Пропустить подтверждение для пакетных операций | Нет | - |
--bwlimit <limit> | Ограничение пропускной способности rsync (напр., "6M", "10M") | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.19 pull
Получить репозиторий с удалённого ресурса (машины или хранилища). Опустите имя для получения всех репозиториев. Тип источника определяется автоматически из конфигурации. Используйте --up для развёртывания после pull
rdc repo pull [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Нет | - |
--from <remote> | Имя исходной машины или хранилища (определяется автоматически из конфигурации) | Нет | - |
--from-machine <machine> | — | Нет | - |
--force | Принудительно перезаписать существующий репозиторий | Нет | - |
--up | После pull смонтировать и развернуть репозиторий на этой машине | Нет | - |
-m, --machine <name> | Имя машины | Да | - |
-w, --watch | Следить за изменениями | Нет | - |
--parallel | Запускать репозитории параллельно | Нет | - |
--concurrency <n> | Максимум параллельных репозиториев (по умолчанию: 3) | Нет | 3 |
-y, --yes | Пропустить подтверждение для пакетных операций | Нет | - |
--bwlimit <limit> | Ограничение пропускной способности rsync (напр., "6M", "10M") | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.20 migrate
Живая миграция репозитория с одной машины на другую с минимальным простоем. Двухфазный rsync: массовая передача во время работы, затем короткая остановка для синхронизации дельты. Поддержка контрольных точек CRIU для миграции памяти процессов и автоматического создания целевых машин
rdc repo migrate [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--from <machine> | Имя исходной машины | Да | - |
--to <machine> | Имя целевой машины | Да | - |
--provision <provider> | Автоматическое создание целевой машины через облачного провайдера (напр., hetzner, linode) | Нет | - |
--bwlimit <limit> | Ограничение пропускной способности rsync (напр., 10M) | Нет | - |
--checkpoint | Живая миграция CRIU: захват и восстановление состояния памяти процесса | Нет | - |
--skip-dns | Пропустить переключение DNS-записей после миграции | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
6.21 backup
Управление резервными копиями репозиториев
list
Показать доступные резервные копии на удалённом ресурсе (машине или хранилище)
rdc repo backup list [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--from <remote> | Имя исходной машины или хранилища (определяется автоматически из конфигурации) | Нет | - |
--from-machine <machine> | — | Нет | - |
-m, --machine <name> | Имя машины | Да | - |
--path <subdir> | Подкаталог внутри корня хранилища. При отсутствии перечисляются и объединяются и hot/, и cold/. | Нет | - |
-w, --watch | Следить за изменениями | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
6.22 sync
Синхронизация репозиториев и файлов (массовый push/pull, передача файлов)
push
Отправить репозитории в облачное хранилище (без имени — все)
rdc repo sync pushpull
Получить репозитории из облачного хранилища (без имени — все)
rdc repo sync pullupload
Загрузить файлы в репозиторий
rdc repo sync upload [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Да | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
--local <paths...> | Один или несколько локальных путей к файлу или каталогу (по умолчанию: текущий каталог) | Нет | - |
--remote <path> | Путь к удаленной поддиректории в репозитории | Нет | - |
--remote-file <path> | Путь к одному удалённому файлу (относительно корня репозитория) для загрузки. Несовместим с --remote. | Нет | - |
--mirror | Режим зеркала - удалить удаленные файлы, отсутствующие локально | Нет | - |
--verify | Проверить файлы с помощью контрольных сумм после синхронизации | Нет | - |
--confirm | Предпросмотр изменений и запрос подтверждения перед синхронизацией | Нет | - |
--exclude <patterns...> | Шаблоны для исключения из синхронизации | Нет | - |
--dry-run | Показать действия без внесения изменений | Нет | - |
download
Скачать файлы из репозитория
rdc repo sync download [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Да | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
--local <path> | Путь к локальной директории (по умолчанию: текущая директория) | Нет | - |
--remote <path> | Путь к удаленной поддиректории в репозитории | Нет | - |
--remote-file <path> | Путь к удалённому файлу в репозитории (альтернатива --remote для передачи одного файла) | Нет | - |
--mirror | Режим зеркала - удалить локальные файлы, отсутствующие на удаленной машине | Нет | - |
--verify | Проверить файлы с помощью контрольных сумм после синхронизации | Нет | - |
--confirm | Предпросмотр изменений и запрос подтверждения перед синхронизацией | Нет | - |
--exclude <patterns...> | Шаблоны для исключения из синхронизации | Нет | - |
--dry-run | Показать действия без внесения изменений | Нет | - |
status
Проверить статус синхронизации и сравнить локальные/удалённые файлы
rdc repo sync status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Да | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
--local <path> | Путь к локальной директории (по умолчанию: текущая директория) | Нет | - |
--remote <path> | Путь к удаленной поддиректории в репозитории | Нет | - |
--remote-file <path> | Путь к удалённому файлу в репозитории (альтернатива --remote для передачи одного файла) | Нет | - |
6.23 snapshot
Управление снимками BTRFS на удалённых машинах
create
Создать снимок BTRFS репозитория
rdc repo snapshot createlist
Список снимков на удалённой машине
rdc repo snapshot listdelete
Удалить снимок с удалённой машины
rdc repo snapshot delete6.24 tunnel
Создать SSH-туннель с перенаправлением портов к порту контейнера на удалённой машине. Автоматически определяет контейнер и порт, если они однозначны. Туннель остаётся открытым до нажатия Ctrl+C
rdc repo tunnel [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Нет | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
-c, --container <name> | Имя контейнера (определяется автоматически, если запущен только один) | Нет | - |
--port <port> | Порт удалённого контейнера для перенаправления | Нет | - |
--local <port> | Локальный порт (по умолчанию совпадает с удалённым) | Нет | - |
6.25 secret
Manage per-repo secrets injected at deploy time. Two modes: env (REDIACC_SECRET_<KEY> via compose ${VAR} interpolation) and file (host tmpfs at /var/run/rediacc/secrets/<networkId>/<KEY>, mounted via Docker compose `secrets:` block). Secrets never enter the encrypted LUKS image, so forks inherit none — externals see the fork as a different principal.
get
Read a single secret. Returns a redacted stub (`<redacted:secret>:<digest8>`) under agent context regardless of policy.
rdc repo secret get [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <repository> | Имя репозитория (например, mail, mail:staging). Без тега по умолчанию :latest. | Да | - |
--key <KEY> | Секретный ключ в формате UPPER_SNAKE_CASE (максимум 64 символа). Будет доступен как REDIACC_SECRET_<KEY> для режима env или /run/secrets/<key> в контейнерах для режима file. | Да | - |
list
Перечислить ключи и режимы секретов (никогда не значения, никогда не дайджесты).
rdc repo secret list [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <repository> | Имя репозитория (например, mail, mail:staging). Без тега по умолчанию :latest. | Да | - |
set
Установить или перезаписать секрет. Форки не наследуют; устанавливайте на форк явно. В контексте агента требуется совпадение дайджеста --current (стиль passwd).
rdc repo secret set [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <repository> | Имя репозитория (например, mail, mail:staging). Без тега по умолчанию :latest. | Да | - |
--key <KEY> | Секретный ключ в формате UPPER_SNAKE_CASE (максимум 64 символа). Будет доступен как REDIACC_SECRET_<KEY> для режима env или /run/secrets/<key> в контейнерах для режима file. | Да | - |
--value <value> | Секретное значение. Передайте `-` для чтения из stdin (избегает раскрытия в истории оболочки). | Да | - |
--mode <mode> | Режим доставки: 'env' (видим в среде контейнера, docker inspect) или 'file' (файл tmpfs, никогда не в env). По умолчанию: file. | Нет | file |
--current <value> | SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write. | Нет | - |
--rotate-secret | Подтвердить ротацию; пропустить предусловие --current (аудировано как ротация). Использовать при намеренной ротации без проверки предыдущего значения. | Нет | - |
unset
Удалить секрет. В контексте агента требуется совпадение дайджеста --current.
rdc repo secret unset [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <repository> | Имя репозитория (например, mail, mail:staging). Без тега по умолчанию :latest. | Да | - |
--key <KEY> | Секретный ключ в формате UPPER_SNAKE_CASE (максимум 64 символа). Будет доступен как REDIACC_SECRET_<KEY> для режима env или /run/secrets/<key> в контейнерах для режима file. | Да | - |
--current <value> | SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write. | Нет | - |
--rotate-secret | Подтвердить ротацию; пропустить предусловие --current (аудировано как ротация). Использовать при намеренной ротации без проверки предыдущего значения. | Нет | - |
7. Управление хранилищем
Управление провайдерами хранилища и просмотр удалённых файлов
7.1 list
Список поставщиков хранилища
rdc storage list [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--search <text> | Поиск в {{field}} | Нет | - |
--sort <field> | Сортировать по полю | Нет | - |
--desc | Сортировка по убыванию | Нет | - |
7.2 create
Создать нового провайдера хранилища
rdc storage create [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
7.3 rename
Переименовать провайдера хранилища
rdc storage rename [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--current-name <name> | Текущее имя ресурса | Да | - |
--new-name <name> | Новое имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
7.4 delete
Удалить провайдера хранилища
rdc storage delete [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-t, --team <name> | Имя команды | Нет | - |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
--dry-run | Показать действия без внесения изменений | Нет | - |
7.5 vault
Управление хранилищем хранилища (только облачный адаптер)
rdc storage vault7.6 browse
Обзор файлов в системе хранения
rdc storage browse [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
--path <subpath> | Путь к подкаталогу для просмотра | Нет | “ |
7.7 prune
Удалить осиротевшие резервные копии из хранилища, которых нет ни в одной конфигурации. Безопасно для нескольких конфигураций с защитой периодом отсрочки.
rdc storage prune [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Исполняющая машина: запускает вызовы rclone list/delete к хранилищу. Требуется, потому что клиенты не должны иметь rclone, установленный локально; учётные данные хранилища по-прежнему берутся из вашей локальной конфигурации. | Да | - |
--dry-run | Показать действия без внесения изменений | Нет | - |
--force | Пропустить подсказки подтверждения | Нет | - |
--force-delete-mounted | Переопределить проверку безопасности монтирования и удалить облачные резервные копии, даже если исходный GUID в данный момент смонтирован или имеет запущенный контейнер на исполняющей машине. Отличается от --force (который переопределяет только льготный период для архивных репо). | Нет | - |
--grace-days <days> | Период отсрочки в днях для недавно архивированных репозиториев (по умолчанию: 7) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
--skip-router-restart | Пропустить перезапуск сервера маршрутов после обновления бинарного файла | Нет | - |
7.8 pull
Загрузить резервную копию из облачного хранилища на машину
rdc storage pull8. Интеграция с VS Code
Открыть VS Code Remote SSH к машине или репозиторию
8.1 connect
Подключиться к машине или репозиторию в VS Code
rdc vscode connect [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Нет | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
-f, --folder <path> | Путь удаленной папки для открытия | Нет | - |
--url-only | Вывести URI VS Code вместо запуска | Нет | - |
-n, --new-window | Открыть в новом окне VS Code | Нет | - |
--skip-env-setup | Пропустить настройку удаленной среды | Нет | - |
--insiders | Использовать параметры VS Code Insiders | Нет | - |
8.2 list
Список настроенных SSH-соединений VS Code
rdc vscode list8.3 cleanup
Удалить конфигурации SSH VS Code
rdc vscode cleanup [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--all | Удалить все конфигурации rediacc SSH | Нет | - |
-c, --connection <name> | Удалить определенное соединение | Нет | - |
8.4 check
Проверить установку и конфигурацию VS Code
rdc vscode check [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--insiders | Использовать параметры VS Code Insiders | Нет | - |
9. Доступ к SSH-терминалу
SSH терминал доступ к машинам и репозиториям
9.1 connect
Подключиться к машине или репозиторию через SSH
rdc term connect [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Нет | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
-c, --command <cmd> | Выполнить команду вместо интерактивной оболочки | Нет | - |
--container <id> | Подключиться к определенному контейнеру Docker | Нет | - |
--container-action <action> | Действие контейнера: terminal, logs, stats, exec | Нет | - |
--log-lines <lines> | Количество строк логов для показа (по умолчанию: 50) | Нет | - |
--follow | Следить за выводом логов | Нет | - |
--external | Открыть в отдельном окне терминала | Нет | - |
--reset-home | Сбросить оверлей домашнего каталога для нового начала | Нет | - |
10. Обработчик протокола
Регистрация и обработка URL протокола {{scheme}}://
10.1 register
Зарегистрировать обработчик протокола в системе
rdc protocol register [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--system | Зарегистрировать в масштабе системы (требуются привилегии администратора) | Нет | - |
--force | Принудительно переживистрировать даже если уже зарегистрирован | Нет | - |
10.2 unregister
Отменить регистрацию обработчика протокола из системы
rdc protocol unregister [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--system | Отменить регистрацию системной регистрации (требуются привилегии администратора) | Нет | - |
10.3 status
Показать статус регистрации обработчика протокола
rdc protocol status10.4 open
Открыть {{scheme}}:// URL и выполнить действие
rdc protocol open <url>10.5 build
Построить {{scheme}}:// URL из компонентов
rdc protocol build [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--token <token> | Токен аутентификации | Да | - |
-t, --team <name> | Имя команды | Да | - |
-m, --machine <name> | Имя машины | Да | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
-a, --action <action> | Действие ({{actions}}) | Нет | desktop |
-p, --params <key=value...> | Дополнительные параметры | Нет | - |
10.6 parse
Разобрать {{scheme}}:// URL и показать компоненты
rdc protocol parse <url>11. Быстрые команды (ярлыки)
11.1 run
Запустить функцию (ярлык для: queue create)
rdc run11.2 trace
Отслеживать задачу (сокращение для: queue trace)
rdc trace11.3 cancel
Отменить задачу (сокращение для: queue cancel)
rdc cancel11.4 retry
Повторить неудавшуюся задачу (сокращение для: queue retry)
rdc retry12. Управление подписками
Управление лицензиями машин и подпиской
12.1 login
Аутентификация с помощью API-токена из веб-портала
rdc subscription login [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --token <token> | API-токен (rdt_...) | Нет | - |
--server <url> | URL сервера аккаунта | Нет | - |
12.2 logout
Удалить сохранённый токен подписки
rdc subscription logout12.3 status
Показать статус подписки и лицензии
rdc subscription status12.4 activation
Управление активацией машин
status
Показать статус активации для одной машины
rdc subscription activation status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
12.5 repo
Управление лицензиями репозиториев
status
Показать установленные лицензии репозиториев на машине
rdc subscription repo status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
12.6 refresh
Обновить лицензию машины
activation
Обновить активацию машины на удалённом сервере
rdc subscription refresh activation [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
repos
Пакетное обновление лицензий репозиториев на удалённой машине
rdc subscription refresh repos [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-m, --machine <name> | Имя машины | Да | - |
repo
Обновить лицензию для конкретного репозитория
rdc subscription refresh repo [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--name <name> | Имя ресурса | Да | - |
-m, --machine <name> | Имя машины | Да | - |
13. Обновления CLI
Проверить и применить обновления CLI
rdc update [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--force | Принудительное обновление, даже если уже актуально | Нет | - |
--check-only | Только проверить обновления без загрузки | Нет | - |
--rollback | Откатить до предыдущей версии | Нет | - |
--status | Показать статус автообновления и диагностику | Нет | - |
--channel <channel> | Установить канал обновлений (stable или edge) | Нет | - |
14. Диагностика системы
Диагностика среды CLI и интеграции renet
rdc doctor15. Экспериментальные операции с VM
Экспериментальные операции с VM (создание, управление, удаление)
15.1 up
Развернуть кластер VM локально
rdc ops up [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--force | Принудительно перезапустить все VM | Нет | - |
--parallel | Создавать VM параллельно | Нет | - |
--basic | Минимальный кластер (мост + 1 рабочий узел) | Нет | - |
--lite | Пропустить подготовку VM (только статус) | Нет | - |
--skip-orchestration | Пропустить оркестрацию кластера | Нет | - |
--backend <backend> | Бэкенд виртуализации (kvm|qemu, автоопределение) | Нет | - |
--os <name> | Операционная система VM (напр., ubuntu-24.04, debian-12) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
15.2 down
Уничтожить кластер VM
rdc ops down [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--backend <backend> | Бэкенд виртуализации (kvm|qemu, автоопределение) | Нет | - |
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
15.3 status
Показать состояние кластера VM
rdc ops status [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--backend <backend> | Бэкенд виртуализации (kvm|qemu, автоопределение) | Нет | - |
15.4 ssh
Подключиться к VM по SSH
rdc ops ssh [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--vm-id <id> | ID виртуальной машины | Да | - |
-c, --command <cmd> | Выполнить команду вместо интерактивной оболочки | Нет | - |
--backend <backend> | Бэкенд виртуализации (kvm|qemu, автоопределение) | Нет | - |
--user <user> | Имя пользователя SSH для подключения к VM | Нет | - |
15.5 setup
Установить предварительные требования для виртуализации
rdc ops setup [options]| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--debug | Включить отладочный вывод (локальный режим) | Нет | - |
15.6 check
Проверить предварительные требования для виртуализации
rdc ops checkРаспространённые сообщения об ошибках
Когда что-то идёт не так, CLI предоставляет понятные сообщения об ошибках:
| Ошибка | Значение |
|---|---|
| Требуется аутентификация. Выполните: rdc auth login | Сначала необходимо войти в систему |
| Нет активной конфигурации. Создайте с помощью: rdc config init --name <name> | Активная конфигурация отсутствует — создайте с помощью `rdc config init` |
| Доступ запрещен | У вашей учётной записи нет необходимых прав |
| Требуется имя машины. Используйте --machine <name> | Укажите машину с помощью `--machine` или задайте значение по умолчанию в контексте |
| Требуется имя команды. Используйте --team или установите контекст. | Укажите команду с помощью `--team` или задайте значение по умолчанию в контексте |
| Требуется имя региона. Используйте --region или установите контекст. | Укажите регион с помощью `--region` или задайте значение по умолчанию в контексте |
Форматы вывода
Все команды list/get поддерживают несколько форматов вывода через `--output`:
rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table # defaultЭто упрощает интеграцию CLI Rediacc в скрипты, CI/CD-конвейеры и рабочие процессы автоматизации.