Перейти к основному содержанию Перейти к навигации Перейти к нижнему колонтитулу

CLI-приложение

Полное руководство по использованию интерфейса командной строки Rediacc для управления платформой

Справочник CLI Rediacc

Обзор

**Rediacc CLI** (`rdc`) — это интерфейс командной строки для управления всеми аспектами платформы Rediacc — аутентификацией, инфраструктурой, репозиториями, очередями, хранилищем и многим другим.

Установка

Загрузите последний бинарный файл для вашей платформы со [страницы релизов Rediacc](https://www.rediacc.com) или установите через ваш менеджер пакетов:

# macOS / Linux
curl -fsSL https://get.rediacc.com | sh

# Or use the packaged binary directly
./rdc --help

Глобальные параметры

Каждая команда поддерживает эти глобальные флаги:

ФлагОписание
--outputФормат вывода (table|json|yaml|csv)
--configИспользовать конкретную конфигурацию для этой команды
--langПереопределение языка ({{languages}})
--forceПропустить подсказки подтверждения

1. Утилиты агента

Утилиты для AI-ассистентов программирования

1.1 capabilities

Список всех доступных команд с аргументами и опциями

rdc agent capabilities

1.2 schema

Показать подробную схему конкретной команды

rdc agent schema <command>

1.3 exec

Выполнить команду с JSON-вводом из stdin

rdc agent exec <command>

1.4 generate-reference

Сгенерировать справочник команд в формате Markdown для навыков Claude

rdc agent generate-reference

2. Управление конфигурацией

Управление файлами конфигурации, машинами и SSH-подключениями

Файлы конфигурации хранят данные подключения (URL API, учётные данные, команда/регион/мост по умолчанию), что позволяет быстро переключаться между средами.

2.1 init

Создать новый именованный файл конфигурации

В локальном режиме можно добавлять машины напрямую:

rdc config init [name] [options]
ФлагОписаниеОбязательноПо умолчанию
--ssh-key <path>Путь к SSH приватному ключу (например, ~/.ssh/id_rsa)Нет-
--renet-path <path>Путь к двоичному файлу renet (по умолчанию: renet в PATH)Нет-
--master-password <password>Зашифровать ресурсы с помощью мастер-пароляНет-
-u, --api-url <url>URL APIНет-

2.2 list

Список всех файлов конфигурации

rdc config list

2.3 show

Показать детали текущей конфигурации

rdc config show

2.4 delete

Удалить файл конфигурации

rdc config delete <name>

2.5 set

Задать значение по умолчанию (команда, регион, мост)

rdc config set <key> <value>

Совет: Задав значения по умолчанию, вам не потребуется передавать `--team`, `--region` или `--bridge` с каждой командой.

2.6 clear

Сбросить значения по умолчанию (все или конкретный ключ)

rdc config clear [key]

2.7 recover

Восстановить конфигурацию из файла резервной копии (.bak)

rdc config recover [name] [options]
ФлагОписаниеОбязательноПо умолчанию
-y, --yesПропустить подсказку подтвержденияНет-

2.8 set-ssh

Обновить конфигурацию SSH для текущей конфигурации

rdc config set-ssh

2.9 set-renet

Задать путь к бинарному файлу renet для локального режима

rdc config set-renet

2.10 ssh

Управление конфигурацией SSH-ключа

set

Задать SSH-ключ для текущей конфигурации

rdc config ssh set [options]
ФлагОписаниеОбязательноПо умолчанию
--key <path>Путь к файлу закрытого SSH-ключаДа-
--embedВстроить содержимое ключа в конфигурацию вместо сохранения путиНет-

show

Показать текущую конфигурацию SSH-ключа

rdc config ssh show

remove

Удалить SSH-ключ из текущей конфигурации

rdc config ssh remove

2.11 machine

Управление машинами в текущей конфигурации

add

Добавить машину в текущую конфигурацию

rdc config machine add <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--ip <address>IP-адрес или имя хоста машиныДа-
--user <username>Имя пользователя SSHДа-
--port <port>Порт SSHНет22
--datastore <path>Путь хранилища данных на машинеНет/mnt/rediacc

remove

Удалить машину из текущей конфигурации

rdc config machine remove <name>

list

Показать список машин в текущей конфигурации

rdc config machine list

scan-keys

Сканировать SSH-ключи хостов для машин в текущей конфигурации

rdc config machine scan-keys [machine]

setup

Подготовить удалённую машину для репозиториев (устанавливает renet, настраивает Docker, хранилище BTRFS). Идемпотентно. Требуется после config machine add и перед repo create

rdc config machine setup <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--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.12 repository

Управление привязками репозиториев в текущей конфигурации

add

Добавить привязку GUID репозитория в текущую конфигурацию

rdc config repository add <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--guid <guid>GUID репозитория (UUID из имён файлов резервных копий)Да-
--tag <tag>Тег репозиторияНетlatest
--credential <credential>Учётные данные репозитория (парольная фраза для шифрования)Нет-
--network-id <id>Сетевой идентификатор для изоляции Docker (2816, 2880, ...). Назначается автоматически, если не указанНет-

remove

Удалить привязку репозитория из текущей конфигурации

rdc config repository remove <name>

list

Показать список привязок GUID репозиториев в текущей конфигурации

rdc config repository list

list-archived

Показать список архивированных учётных данных репозиториев

rdc config repository list-archived

restore-archived

Восстановить архивированные учётные данные репозитория

rdc config repository restore-archived <guid> [options]
ФлагОписаниеОбязательноПо умолчанию
--name <name>Восстановить с другим именемНет-

purge-archived

Безвозвратно удалить все архивированные учётные данные

rdc config repository purge-archived

2.13 provider

Управление облачными провайдерами для автоматического создания машин

add

Добавить облачного провайдера

rdc config provider add <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--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 <name>

list

Показать список настроенных облачных провайдеров

rdc config provider list

2.14 storage

Управление бэкендами хранения в текущей конфигурации

import

Импортировать хранилища из конфигурационного файла rclone

rdc config storage import <file> [options]
ФлагОписаниеОбязательноПо умолчанию
--name <name>Импортировать только указанный разделНет-

remove

Удалить хранилище из текущей конфигурации

rdc config storage remove <name>

list

Показать список хранилищ в текущей конфигурации

rdc config storage list

2.15 infra

Управление конфигурацией инфраструктуры (прокси, DNS, сертификаты)

set

Настройка инфраструктуры машины (для машины: IP, домен, порты; общие: email сертификата, CF DNS-токен)

rdc config infra set <machine> [options]
ФлагОписаниеОбязательноПо умолчанию
--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 <machine>

push

Отправить конфигурацию инфраструктуры на машину (Traefik-прокси, маршрутизатор, Cloudflare DNS). Сначала выполните 'config infra set <machine>'

rdc config infra push <machine> [options]
ФлагОписаниеОбязательноПо умолчанию
--debugВключить отладочный вывод (локальный режим)Нет-

2.16 cert-cache

Управление кэшированными TLS-сертификатами

pull

Скачать и кэшировать TLS-сертификаты с машины

rdc config cert-cache pull <machine> [options]
ФлагОписаниеОбязательноПо умолчанию
--no-pruneПропустить очистку устаревших сертификатов сетевых IDНет-
--debugВключить отладочный вывод (локальный режим)Нет-

push

Загрузить кэшированные TLS-сертификаты на машину

rdc config cert-cache push <machine> [options]
ФлагОписаниеОбязательноПо умолчанию
--debugВключить отладочный вывод (локальный режим)Нет-

status

Показать инвентарь кэшированных сертификатов

rdc config cert-cache status

clear

Удалить кэш сертификатов

rdc config cert-cache clear

2.17 backup-strategy

Управление стратегией резервного копирования с несколькими назначениями

set

Настроить параметры расписания резервного копирования

rdc config backup-strategy set [options]
ФлагОписаниеОбязательноПо умолчанию
--destination <storage>Имя хранилища назначения по умолчаниюНет-
--cron <expression>Выражение cron для расписания резервного копирования (напр. "0 2 * * *")Нет-
--enableВключить резервное копирование по расписаниюНет-
--disableОтключить резервное копирование по расписаниюНет-

show

Показать текущие настройки расписания резервного копирования

rdc config backup-strategy show

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 <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-
-b, --bridge <name>Имя мостаНет-
--vault <json>Данные хранилища машины в виде строки JSONНет-

4.3 rename

Переименовать машину

rdc machine rename <oldName> <newName> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-

4.4 delete

Удалить машину

rdc machine delete <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-
-f, --forceПропустить подсказки подтвержденияНет-
--dry-runПоказать действия без внесения измененийНет-

4.5 vault

Управление хранилищем машины (только облачный адаптер)

rdc machine vault

4.6 vault-status

{{t:cli.commands.machine.vault-status.description}}

rdc machine vault-status <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-

4.7 update

Обновить конфигурацию машины

rdc machine update

4.8 health

Проверить состояние машины для CI/CD пайплайнов

Команда health выводит системные метрики, статус контейнеров, стабильность сервисов и информацию о хранилище — полезно для проверок CI/CD-конвейеров.

rdc machine health <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-

4.9 containers

Список запущенных контейнеров на машине

rdc machine containers <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-
--health-checkРежим проверки состояния - завершается с кодом 2 при наличии нездоровыхНет-

4.10 services

Список systemd-сервисов на машине

rdc machine services <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-
--stability-checkРежим проверки стабильности - завершается с кодом 2 при наличии сбойных/перезапускающихсяНет-

4.11 query

Показать полный статус машины (система, репозитории, контейнеры, сервисы)

rdc machine query <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--debugВключить отладочный вывод (локальный режим)Нет-
--systemВключить только информацию о системеНет-
--repositoriesВключить только репозиторииНет-
--containersВключить только контейнерыНет-
--servicesВключить только сервисыНет-
--networkВключить только сетевые интерфейсыНет-
--block-devicesВключить только блочные устройстваНет-

4.12 vault-status

Показать статус разобранного хранилища для машины

rdc machine vault-status <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-

4.13 repos

Список развернутых репозиториев на машине

rdc machine repos <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-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 <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--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 <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--forceПропустить подсказку подтвержденияНет-
--debugВключить отладочный вывод (локальный режим)Нет-

4.17 backup

Управление резервным копированием машины

schedule

Отправить расписание резервного копирования на удалённую машину (таймер systemd)

rdc machine backup schedule <machine> [options]
ФлагОписаниеОбязательноПо умолчанию
--debugВключить отладочный вывод (локальный режим)Нет-

4.18 prune

Удалить осиротевшие ресурсы хранилища данных и устаревшие снапшоты с машины

rdc machine prune <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--dry-runПоказать, что будет удалено, без внесения измененийНет-
--orphaned-reposТакже удалить образы репозиториев, отсутствующие во всех конфигурацияхНет-
--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 [name] [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--checkpointВосстановить из контрольной точки после монтированияНет-
--no-dockerНе запускать Docker-демон после монтированияНет-
--parallelЗапускать репозитории параллельноНет-
--concurrency <n>Максимум параллельных репозиториев (по умолчанию: 3)Нет3
-y, --yesПропустить подтверждение для пакетных операцийНет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.2 unmount

Размонтировать репозиторий

rdc repo unmount [name] [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--checkpointСоздать контрольную точку перед размонтированиемНет-
--parallelЗапускать репозитории параллельноНет-
--concurrency <n>Максимум параллельных репозиториев (по умолчанию: 3)Нет3
-y, --yesПропустить подтверждение для пакетных операцийНет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.3 up

Развернуть или обновить репозиторий (монтирование, запуск сервисов)

rdc repo up [name] [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--mountСначала смонтировать репозиторийНет-
--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-all

6.5 down

Остановить сервисы репозитория

rdc repo down [name] [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--unmountРазмонтировать репозиторий после остановкиНет-
--checkpointСоздать checkpoint CRIU перед остановкой (сохранить состояние памяти процессов для последующего восстановления через 'repo up')Нет-
-y, --yesПропустить подтверждение для пакетных операцийНет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-
--dry-runПоказать действия без внесения измененийНет-

6.6 status

Получить статус репозитория

rdc repo status <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-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 <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-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 <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--archive-configПереместить запись конфигурации в deletedRepositories для последующего восстановленияНет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-
--dry-runПоказать действия без внесения измененийНет-

6.10 fork

Создать CoW-форк (копирование при записи) репозитория

rdc repo fork <parent> [tag] [options]
ФлагОписаниеОбязательноПо умолчанию
-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 <fork> [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--forceПропустить предупреждения об измененияхНет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.12 resize

Изменить размер репозитория офлайн (поддерживает увеличение и уменьшение)

rdc repo resize <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--size <size>Новый размер репозитория (напр. 10G, 100G, 1T)Да-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.13 expand

Расширить смонтированный репозиторий онлайн (без простоя)

rdc repo expand <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--size <size>Новый размер репозитория (напр. 10G, 100G, 1T)Да-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.14 validate

Проверить целостность репозитория

rdc repo validate <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.15 autostart

Управление автозапуском репозиториев при загрузке

enable

Включить автозапуск для репозитория

rdc repo autostart enable [name] [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

disable

Отключить автозапуск для репозитория

rdc repo autostart disable [name] [options]
ФлагОписаниеОбязательноПо умолчанию
-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 <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя целевой машиныДа-
--uid <uid>UID владельца (по умолчанию: 7111)Нет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.17 template

Применить шаблон к репозиторию

list

Список всех встроенных шаблонов развёртывания CLI

rdc repo template list

apply

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 <template> [options]
ФлагОписаниеОбязательноПо умолчанию
-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 [repo] [options]
ФлагОписаниеОбязательноПо умолчанию
--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Пропустить подтверждение для пакетных операцийНет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.19 pull

Получить репозиторий с удалённого ресурса (машины или хранилища). Опустите имя для получения всех репозиториев. Тип источника определяется автоматически из конфигурации. Используйте --up для развёртывания после pull

rdc repo pull [repo] [options]
ФлагОписаниеОбязательноПо умолчанию
--from <remote>Имя исходной машины или хранилища (определяется автоматически из конфигурации)Нет-
--from-machine <machine>Нет-
--forceПринудительно перезаписать существующий репозиторийНет-
--upПосле pull смонтировать и развернуть репозиторий на этой машинеНет-
-m, --machine <name>Имя машиныДа-
-w, --watchСледить за изменениямиНет-
--parallelЗапускать репозитории параллельноНет-
--concurrency <n>Максимум параллельных репозиториев (по умолчанию: 3)Нет3
-y, --yesПропустить подтверждение для пакетных операцийНет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.20 backup

Управление резервными копиями репозиториев

list

Показать доступные резервные копии на удалённом ресурсе (машине или хранилище)

rdc repo backup list [options]
ФлагОписаниеОбязательноПо умолчанию
--from <remote>Имя исходной машины или хранилища (определяется автоматически из конфигурации)Нет-
--from-machine <machine>Нет-
-m, --machine <name>Имя машиныДа-
-w, --watchСледить за изменениямиНет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

6.21 sync

Синхронизация репозиториев и файлов (массовый push/pull, передача файлов)

push

Отправить репозитории в облачное хранилище (без имени — все)

rdc repo sync push

pull

Получить репозитории из облачного хранилища (без имени — все)

rdc repo sync pull

upload

Загрузить файлы в репозиторий

rdc repo sync upload [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-
-m, --machine <name>Имя машиныДа-
-r, --repository <name>Имя репозитория (подключается к среде репозитория)Нет-
--local <path>Путь к локальной директории (по умолчанию: текущая директория)Нет-
--remote <path>Путь к удаленной поддиректории в репозиторииНет-
--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>Путь к удаленной поддиректории в репозиторииНет-
--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>Путь к удаленной поддиректории в репозиторииНет-

6.22 snapshot

Управление снимками BTRFS на удалённых машинах

create

Создать снимок BTRFS репозитория

rdc repo snapshot create

list

Список снимков на удалённой машине

rdc repo snapshot list

delete

Удалить снимок с удалённой машины

rdc repo snapshot delete

6.23 tunnel

Создать SSH-туннель с перенаправлением портов к порту контейнера на удалённой машине. Автоматически определяет контейнер и порт, если они однозначны. Туннель остаётся открытым до нажатия Ctrl+C

rdc repo tunnel [machine] [repository] [options]
ФлагОписаниеОбязательноПо умолчанию
-c, --container <name>Имя контейнера (определяется автоматически, если запущен только один)Нет-
--port <port>Порт удалённого контейнера для перенаправленияНет-
--local <port>Локальный порт (по умолчанию совпадает с удалённым)Нет-

7. Управление хранилищем

Управление провайдерами хранилища и просмотр удалённых файлов

7.1 list

Список поставщиков хранилища

rdc storage list [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-
--search <text>Поиск в {{field}}Нет-
--sort <field>Сортировать по полюНет-
--descСортировка по убываниюНет-

7.2 create

Создать нового провайдера хранилища

rdc storage create <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-

7.3 rename

Переименовать провайдера хранилища

rdc storage rename <oldName> <newName> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-

7.4 delete

Удалить провайдера хранилища

rdc storage delete <name> [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --team <name>Имя командыНет-
-f, --forceПропустить подсказки подтвержденияНет-
--dry-runПоказать действия без внесения измененийНет-

7.5 vault

Управление хранилищем хранилища (только облачный адаптер)

rdc storage vault

7.6 browse

Обзор файлов в системе хранения

rdc storage browse <name> [options]
ФлагОписаниеОбязательноПо умолчанию
--path <subpath>Путь к подкаталогу для просмотраНет

7.7 prune

Удалить осиротевшие резервные копии из хранилища, которых нет ни в одной конфигурации. Безопасно для нескольких конфигураций с защитой периодом отсрочки.

rdc storage prune <storageName> [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя машиныДа-
--dry-runПоказать действия без внесения измененийНет-
--forceПропустить подсказки подтвержденияНет-
--grace-days <days>Период отсрочки в днях для недавно архивированных репозиториев (по умолчанию: 7)Нет-
--debugВключить отладочный вывод (локальный режим)Нет-
--skip-router-restartПропустить перезапуск сервера маршрутов после обновления бинарного файлаНет-

7.8 pull

Загрузить резервную копию из облачного хранилища на машину

rdc storage pull

8. Интеграция с 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 list

8.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 status

10.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 run

11.2 trace

Отслеживать задачу (сокращение для: queue trace)

rdc trace

11.3 cancel

Отменить задачу (сокращение для: queue cancel)

rdc cancel

11.4 retry

Повторить неудавшуюся задачу (сокращение для: queue retry)

rdc retry

12. Управление подписками

Управление лицензиями машин и подпиской

12.1 login

Аутентификация с помощью API-токена из веб-портала

rdc subscription login [options]
ФлагОписаниеОбязательноПо умолчанию
-t, --token <token>API-токен (rdt_...)Нет-
--server <url>URL сервера аккаунтаНет-

12.2 logout

Удалить сохранённый токен подписки

rdc subscription logout

12.3 status

Показать статус подписки и лицензии

rdc subscription status

12.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 <repo> [options]
ФлагОписаниеОбязательноПо умолчанию
-m, --machine <name>Имя машиныДа-

13. Обновления CLI

Проверить и применить обновления CLI

rdc update [options]
ФлагОписаниеОбязательноПо умолчанию
--forceПринудительное обновление, даже если уже актуальноНет-
--check-onlyТолько проверить обновления без загрузкиНет-
--rollbackОткатить до предыдущей версииНет-
--statusПоказать статус автообновления и диагностикуНет-

14. Диагностика системы

Диагностика среды CLI и интеграции renet

rdc doctor

15. Экспериментальные операции с 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 <vmId> [command...] [options]
ФлагОписаниеОбязательноПо умолчанию
--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>Активная конфигурация отсутствует — создайте с помощью `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-конвейеры и рабочие процессы автоматизации.