Справочник 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) |
--context | Использовать определенный контекст для этой команды |
--lang | Переопределение языка ({{languages}}) |
--force | Пропустить подсказки подтверждения |
1. Аутентификация
Команды аутентификации
1.1 login
Аутентифицировать с помощью Rediacc
rdc auth login [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-e, --email <email> | Адрес электронной почты | Нет | - |
-p, --password <password> | Пароль (для не интерактивного входа) | Нет | - |
-m, --master-password <password> | Мастер-пароль для шифрования хранилища | Нет | - |
-n, --name <name> | Имя сеанса | Нет | - |
--endpoint <url> | URL конечной точки API | Нет | - |
--save-as <context> | Сохранить учетные данные в именованный контекст | Нет | - |
1.2 logout
Очистить сохраненные учетные данные
rdc auth logout
1.3 status
Проверить статус текущей аутентификации
rdc auth status
1.4 register
Зарегистрировать новую организацию и учетную запись пользователя
После регистрации проверьте электронную почту на наличие кода активации.
rdc auth register [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--organization <name> | Имя организации | Да | - |
-e, --email <email> | Адрес электронной почты | Да | - |
-p, --password <password> | Пароль (для не интерактивного входа) | Да | - |
-m, --master-password <password> | Мастер-пароль для шифрования хранилища | Нет | - |
--endpoint <url> | URL конечной точки API | Нет | - |
--plan <plan> | План подписки (COMMUNITY, PROFESSIONAL, BUSINESS, ENTERPRISE) | Нет | COMMUNITY |
1.5 activate
Активировать учетную запись с кодом проверки
rdc auth activate [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-e, --email <email> | Адрес электронной почты | Да | - |
-p, --password <password> | Пароль (для не интерактивного входа) | Да | - |
--code <code> | Код активации из электронного письма | Да | - |
--endpoint <url> | URL конечной точки API | Нет | - |
1.6 tfa
Управление двухфакторной аутентификацией
disable
Отключить двухфакторную аутентификацию
rdc auth tfa disable [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--code <code> | Текущий код двухфакторной аутентификации для проверки | Нет | - |
-y, --yes | Пропустить подсказку подтверждения | Нет | - |
enable
Включить двухфакторную аутентификацию
rdc auth tfa enable
status
Проверить статус двухфакторной аутентификации
rdc auth tfa status
1.7 token
Управление токенами
fork
Создать разветвленный токен для другого приложения
rdc auth token fork [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-n, --name <name> | Имя токена | Нет | CLI Fork |
-e, --expires <hours> | Истечение в часах (1-720) | Нет | 24 |
list
Список активных токенов/сеансов
rdc auth token list
revoke
Отозвать определенный токен
rdc auth token revoke <requestId>
Совет: Ваш токен аутентификации хранится локально в вашем контексте. Используйте `--save-as` для сохранения учётных данных под именованным контекстом для нескольких сред.
2. Управление контекстами
Управление контекстами CLI
Контексты хранят данные подключения (URL API, учётные данные, команда/регион/машина по умолчанию), чтобы вы могли быстро переключаться между средами.
2.1 list
Список всех контекстов
rdc context list
2.2 show
Показать детали текущего контекста
rdc context show
2.3 use
Переключиться на другой контекст
rdc context use
2.4 create
Создать новый контекст
rdc context create <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-u, --api-url <url> | URL API | Нет | - |
2.5 delete
Удалить контекст
rdc context delete <name>
2.6 rename
Переименовать контекст
rdc context rename <oldName> <newName>
2.7 current
Показать имя текущего контекста
rdc context current
2.8 set
Установить значение по умолчанию (team, region, bridge, machine)
rdc context set <key> <value>
Совет: Установка значений по умолчанию означает, что вам не нужно передавать `--team`, `--region` или `--machine` с каждой командой.
2.9 unset
Удалить значение контекста по умолчанию
rdc context unset
2.10 clear
Очистить значения по умолчанию (все или определенный ключ)
rdc context clear [key]
2.11 set-language
Установить предпочитаемый язык
rdc context set-language
2.12 create-local
Создать новый локальный контекст для работы без middleware
В локальном режиме вы можете добавлять машины напрямую:
rdc context create-local <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--ssh-key <path> | Путь к SSH приватному ключу (например, ~/.ssh/id_rsa) | Да | - |
--renet-path <path> | Путь к двоичному файлу renet (по умолчанию: renet в PATH) | Нет | - |
2.13 add-machine
Добавить машину в текущий локальный контекст
rdc context add-machine <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--ip <address> | IP-адрес или имя хоста машины | Да | - |
--user <username> | Имя пользователя SSH | Да | - |
--port <port> | Порт SSH | Нет | 22 |
--datastore <path> | Путь хранилища данных на машине | Нет | /mnt/rediacc |
2.14 remove-machine
Удалить машину из текущего локального контекста
rdc context remove-machine <name>
2.15 machines
Список машин в текущем локальном контексте
rdc context machines
2.16 set-ssh
Обновить конфигурацию SSH для текущего локального контекста
rdc context set-ssh [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--private-key <path> | Путь к SSH приватному ключу | Да | - |
--public-key <path> | Путь к SSH открытому ключу | Нет | - |
2.17 create-s3
Создать новый контекст S3/R2 для удалённого состояния с локальным выполнением
rdc context create-s3 <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--endpoint <url> | URL конечной точки S3 | Да | - |
--bucket <name> | Имя корзины S3 | Да | - |
--access-key-id <key> | Идентификатор ключа доступа S3 | Да | - |
--ssh-key <path> | Путь к SSH приватному ключу | Да | - |
--secret-access-key <key> | Секретный ключ доступа S3 (запрашивается, если не указан) | Нет | - |
--region <region> | Регион S3 | Нет | auto |
--prefix <prefix> | Префикс ключа/пространство имён в корзине | Нет | - |
--renet-path <path> | Путь к исполняемому файлу renet | Нет | - |
--master-password <password> | Мастер-пароль для шифрования (необязательно, оставьте пустым для пропуска) | Нет | - |
2.18 set-renet
Установить путь к двоичному файлу renet для локального режима
rdc context set-renet <path>
3. Управление организацией
Команды управления организацией
3.1 list
Список организаций
rdc organization list
3.2 info
Получить информацию об организации
rdc organization info
3.3 dashboard
Получить данные панели управления организации
rdc organization dashboard
3.4 vault
Управление хранилищем организации
get
Получить данные хранилища организации
rdc organization vault get
list
Список всех типов хранилищ
rdc organization vault list
update
Обновить данные хранилища организации
rdc organization vault update [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--vault <json> | Содержимое хранилища в виде строки JSON | Нет | - |
--vault-version <n> | Текущая версия хранилища для оптимистичной блокировки | Нет | - |
3.5 export
Экспортировать данные организации
rdc organization export [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--path <path> | Путь для сохранения выходного файла | Нет | - |
3.6 import
Импортировать данные организации
rdc organization import <path> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--mode <mode> | Режим импорта (merge или replace) | Нет | merge |
3.7 maintenance
Включить или отключить режим обслуживания (блокирует входы не-администраторов)
rdc organization maintenance <action>
Предупреждение: Когда режим обслуживания включён, пользователи без прав администратора не могут войти в систему.
4. Управление пользователями
Команды управления пользователем
4.1 list
Список всех пользователей
rdc user list
4.2 create
Создать нового пользователя
rdc user create <email> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-p, --password <password> | Пароль для нового пользователя | Нет | - |
4.3 activate
Активировать учетную запись пользователя
rdc user activate <email> <activationCode>
4.4 deactivate
Деактивировать учетную запись пользователя
rdc user deactivate <email> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-f, --force | Пропустить подсказки подтверждения | Нет | - |
4.5 reactivate
Переактивировать деактивированную учетную запись пользователя
rdc user reactivate <email>
4.6 update-email
Изменить адрес электронной почты пользователя
rdc user update-email <currentEmail> <newEmail>
4.7 update-password
Изменить пароль
rdc user update-password [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--password <password> | Новый пароль (режим без интеракции) | Нет | - |
--confirm <confirm> | Подтвердите пароль (режим без интеракции) | Нет | - |
4.8 update-language
Установить предпочитаемый язык текущего пользователя
rdc user update-language <language>
4.9 exists
Проверить, существует ли пользователь
rdc user exists <email>
4.10 vault
Управление хранилищем пользователя
get
Получить данные хранилища текущего пользователя
rdc user vault get
update
Обновить данные хранилища текущего пользователя
rdc user vault update [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--vault <json> | Содержимое хранилища в виде строки JSON | Нет | - |
--vault-version <n> | Текущая версия хранилища для оптимистичной блокировки | Нет | - |
4.11 permission
Управление разрешениями пользователя
assign
Назначить группу разрешений пользователю
rdc user permission assign <userEmail> <groupName>
5. Управление командами
Управление командой
5.1 list
Список команд
rdc team list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--search <text> | Поиск в {{field}} | Нет | - |
--sort <field> | Сортировать по полю | Нет | - |
--desc | Сортировка по убыванию | Нет | - |
5.2 create
Создать команду
rdc team create <name>
5.3 member
Управление членством в команде
list
Список членов команды
rdc team member list <teamName>
add
Добавить пользователя в команду
rdc team member add <teamName> <userEmail>
remove
Удалить пользователя из команды
rdc team member remove <teamName> <userEmail>
6. Управление правами
Команды управления разрешениями
6.1 list
Список разрешений
rdc permission list
6.2 group
Управление группой разрешений
list
Список всех групп разрешений
rdc permission group list
create
Создать новую группу разрешений
rdc permission group create <name>
delete
Удалить группу разрешений
rdc permission group delete <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-f, --force | Пропустить подсказки подтверждения | Нет | - |
show
Показать детали группы разрешений
rdc permission group show <name>
6.3 add
Добавить разрешение в группу
rdc permission add <groupName> <permission>
6.4 remove
Удалить разрешение из группы
rdc permission remove <groupName> <permission>
7. Управление регионами
Управление регионом
7.1 list
Список регионов
rdc region list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--search <text> | Поиск в {{field}} | Нет | - |
--sort <field> | Сортировать по полю | Нет | - |
--desc | Сортировка по убыванию | Нет | - |
8. Управление мостами
Управление мостом
8.1 list
Список мостов
rdc bridge list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-r, --region <name> | Имя региона | Нет | - |
--search <text> | Поиск в {{field}} | Нет | - |
--sort <field> | Сортировать по полю | Нет | - |
--desc | Сортировка по убыванию | Нет | - |
8.2 reset-auth
Сбросить токен авторизации моста
rdc bridge reset-auth <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-r, --region <name> | Имя региона | Нет | - |
9. Управление машинами
Управление машиной
9.1 list
Список машин
rdc machine list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--search <text> | Поиск в {{field}} | Нет | - |
--sort <field> | Сортировать по полю | Нет | - |
--desc | Сортировка по убыванию | Нет | - |
9.2 create
Создать новую машину
rdc machine create <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-b, --bridge <name> | Имя моста | Нет | - |
--vault <json> | Данные хранилища машины в виде строки JSON | Нет | - |
9.3 delete
Удалить машину
rdc machine delete <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
9.4 update
Обновить конфигурацию машины
rdc machine update
9.5 health
Проверить состояние машины для CI/CD пайплайнов
Команда health выводит системные метрики, статус контейнеров, стабильность сервисов и информацию о хранилище — полезно для проверок CI/CD-конвейеров.
rdc machine health <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
9.6 containers
Список Docker-контейнеров на машине
rdc machine containers <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--health-check | Режим проверки состояния - завершается с кодом 2 при наличии нездоровых | Нет | - |
9.7 services
Список systemd-сервисов на машине
rdc machine services <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--stability-check | Режим проверки стабильности - завершается с кодом 2 при наличии сбойных/перезапускающихся | Нет | - |
9.8 vault-status
Показать статус разобранного хранилища для машины
rdc machine vault-status <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
9.9 repos
Список развернутых репозиториев на машине
rdc machine repos <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--search <text> | Фильтровать репозитории по имени | Нет | - |
9.10 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` для автоматического сохранения ключа хоста в хранилище машины после успешного теста.
10. Управление репозиториями
Команды управления репозиторием
10.1 list
Список репозиториев
rdc repository list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
10.2 create
Создать новый репозиторий
rdc repository create <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--tag <tag> | Тег репозитория | Нет | latest |
--parent <name> | Родительский репозиторий (для форков) | Нет | - |
--parent-tag <tag> | Тег родительского репозитория | Нет | - |
10.3 rename
Переименовать репозиторий
rdc repository rename <oldName> <newName> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--tag <tag> | Тег репозитория | Нет | latest |
10.4 delete
Удалить репозиторий
rdc repository delete <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--tag <tag> | Тег репозитория | Нет | latest |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
10.5 promote
Повысить уровень форка до главного статуса
rdc repository promote <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--tag <tag> | Тег репозитория | Нет | latest |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
Примечание: Продвижение форка отделяет его от родительского (grand) репозитория, делая его независимым.
10.6 vault
Управление хранилищем репозитория
get
Получить данные хранилища репозитория
rdc repository vault get <repositoryName> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--tag <tag> | Тег репозитория | Нет | latest |
update
Обновить данные хранилища репозитория
rdc repository vault update <repositoryName> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--tag <tag> | Тег репозитория | Нет | latest |
--vault <json> | Содержимое хранилища в виде строки JSON | Нет | - |
--vault-version <n> | Текущая версия хранилища для оптимистичной блокировки | Нет | - |
11. Управление хранилищем
Управление хранилищем
11.1 list
Список поставщиков хранилища
rdc storage list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--search <text> | Поиск в {{field}} | Нет | - |
--sort <field> | Сортировать по полю | Нет | - |
--desc | Сортировка по убыванию | Нет | - |
12. Операции с очередями
Управление очередью
Система очередей — это ядро выполнения задач Rediacc. Каждая операция (развёртывание, резервное копирование, выполнение скриптов) проходит через очередь.
12.1 list
Список элементов очереди
rdc queue list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
--status <status> | Фильтровать по статусу | Нет | - |
--priority-min <n> | Минимальный приоритет (1-5) | Нет | - |
--priority-max <n> | Максимальный приоритет (1-5) | Нет | - |
--search <text> | Поиск по ID задачи, команде, машине, мосту | Нет | - |
--sort <field> | Сортировать по полю | Нет | - |
--desc | Сортировка по убыванию | Нет | - |
--limit <n> | Максимальное количество результатов | Нет | 50 |
12.2 create
Создать элемент очереди
rdc queue create [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-f, --function <name> | Имя функции для выполнения | Да | - |
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Нет | - |
-b, --bridge <name> | Имя моста | Нет | - |
-p, --priority <1-5> | Приоритет (1=наивысший) | Нет | 3 |
--param <key=value> | Параметры функции | Нет | - |
--vault <json> | Необработанный JSON хранилища (для скриптов/CI) | Нет | - |
12.3 cancel
Отменить элемент очереди
rdc queue cancel <taskId>
12.4 retry
Повторить неудачный элемент очереди
rdc queue retry <taskId>
12.5 trace
Трассировка выполнения элемента очереди
rdc queue trace <taskId> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-w, --watch | Следить за обновлениями | Нет | - |
--interval <ms> | Интервал опроса в миллисекундах | Нет | 2000 |
Совет: Используйте `--watch` для отслеживания задачи в реальном времени до её завершения.
12.6 delete
Удалить элемент очереди
rdc queue delete <taskId> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-f, --force | Пропустить подсказки подтверждения | Нет | - |
13. Синхронизация файлов
Синхронизация файлов с репозиториями с помощью rsync
13.1 upload
Загрузить файлы в репозиторий
rdc sync upload [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Нет | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
-l, --local <path> | Путь к локальной директории (по умолчанию: текущая директория) | Нет | - |
--remote <path> | Путь к удаленной поддиректории в репозитории | Нет | - |
--mirror | Режим зеркала - удалить удаленные файлы, отсутствующие локально | Нет | - |
--verify | Проверить файлы с помощью контрольных сумм после синхронизации | Нет | - |
--confirm | Предпросмотр изменений и запрос подтверждения перед синхронизацией | Нет | - |
--exclude <patterns...> | Шаблоны для исключения из синхронизации | Нет | - |
--dry-run | Показать, что будет передано, без фактической синхронизации | Нет | - |
13.2 download
Загрузить файлы из репозитория
rdc sync download [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Нет | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
-l, --local <path> | Путь к локальной директории (по умолчанию: текущая директория) | Нет | - |
--remote <path> | Путь к удаленной поддиректории в репозитории | Нет | - |
--mirror | Режим зеркала - удалить локальные файлы, отсутствующие на удаленной машине | Нет | - |
--verify | Проверить файлы с помощью контрольных сумм после синхронизации | Нет | - |
--confirm | Предпросмотр изменений и запрос подтверждения перед синхронизацией | Нет | - |
--exclude <patterns...> | Шаблоны для исключения из синхронизации | Нет | - |
--dry-run | Показать, что будет передано, без фактической синхронизации | Нет | - |
13.3 status
Проверить статус синхронизации и сравнить локальные/удаленные файлы
rdc sync status [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-t, --team <name> | Имя команды | Нет | - |
-m, --machine <name> | Имя машины | Нет | - |
-r, --repository <name> | Имя репозитория (подключается к среде репозитория) | Нет | - |
-l, --local <path> | Путь к локальной директории (по умолчанию: текущая директория) | Нет | - |
--remote <path> | Путь к удаленной поддиректории в репозитории | Нет | - |
14. Интеграция с VS Code
VS Code Remote SSH интеграция
14.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 | Нет | - |
14.2 list
Список настроенных SSH-соединений VS Code
rdc vscode list
14.3 cleanup
Удалить конфигурации SSH VS Code
rdc vscode cleanup [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--all | Удалить все конфигурации rediacc SSH | Нет | - |
-c, --connection <name> | Удалить определенное соединение | Нет | - |
14.4 check
Проверить установку и конфигурацию VS Code
rdc vscode check [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--insiders | Использовать параметры VS Code Insiders | Нет | - |
15. Доступ к SSH-терминалу
SSH терминал доступ к машинам и репозиториям
15.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 | Открыть в отдельном окне терминала | Нет | - |
16. Управление хранилищем Ceph
Управление распределённым хранилищем Ceph
16.1 cluster
Управление кластерами Ceph
list
Показать список кластеров Ceph
rdc ceph cluster list
create
Создать новый кластер Ceph
rdc ceph cluster create <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--vault <content> | Содержимое хранилища в виде строки JSON | Нет | - |
delete
Удалить кластер Ceph
rdc ceph cluster delete <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
-f, --force | Пропустить подсказки подтверждения | Нет | - |
machines
Показать список машин в кластере Ceph
rdc ceph cluster machines <name>
vault
Управление хранилищем кластера Ceph
get:
Получить данные хранилища кластера
rdc ceph cluster vault get <name>
update:
Обновить данные хранилища кластера
rdc ceph cluster vault update <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--vault <content> | Содержимое хранилища в виде строки JSON | Да | - |
16.2 pool
Управление пулами Ceph
list
Показать список пулов Ceph
rdc ceph pool list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--team <name> | Имя команды | Нет | - |
--cluster <name> | Имя кластера Ceph | Нет | - |
create
Создать новый пул Ceph
rdc ceph pool create <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--cluster <name> | Имя кластера Ceph | Да | - |
--team <name> | Имя команды | Да | - |
--vault <content> | Содержимое хранилища в виде строки JSON | Нет | - |
delete
Удалить пул Ceph
rdc ceph pool delete <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--team <name> | Имя команды | Да | - |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
vault
Управление хранилищем пула Ceph
get:
Получить данные хранилища пула
rdc ceph pool vault get <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--team <name> | Имя команды | Да | - |
update:
Обновить данные хранилища пула
rdc ceph pool vault update <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--team <name> | Имя команды | Да | - |
--vault <content> | Содержимое хранилища в виде строки JSON | Да | - |
16.3 image
Управление образами RBD Ceph
list
Показать список образов RBD
rdc ceph image list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--pool <name> | Имя пула Ceph | Нет | - |
--team <name> | Имя команды | Нет | - |
create
Создать новый образ RBD
rdc ceph image create <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
--machine <name> | Имя машины | Да | - |
--vault <content> | Содержимое хранилища в виде строки JSON | Нет | - |
delete
Удалить образ RBD
rdc ceph image delete <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
16.4 snapshot
Управление снимками RBD Ceph
list
Показать список снимков RBD
rdc ceph snapshot list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--image <name> | Имя RBD образа | Нет | - |
--pool <name> | Имя пула Ceph | Нет | - |
--team <name> | Имя команды | Нет | - |
create
Создать новый снимок RBD
rdc ceph snapshot create <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--image <name> | Имя RBD образа | Да | - |
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
--vault <content> | Содержимое хранилища в виде строки JSON | Нет | - |
delete
Удалить снимок RBD
rdc ceph snapshot delete <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--image <name> | Имя RBD образа | Да | - |
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
16.5 clone
Управление клонами RBD Ceph
list
Показать список клонов RBD
rdc ceph clone list [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--snapshot <name> | Имя RBD снимка | Нет | - |
--image <name> | Имя RBD образа | Нет | - |
--pool <name> | Имя пула Ceph | Нет | - |
--team <name> | Имя команды | Нет | - |
create
Создать новый клон RBD из снимка
rdc ceph clone create <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--snapshot <name> | Имя RBD снимка | Да | - |
--image <name> | Имя RBD образа | Да | - |
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
--vault <content> | Содержимое хранилища в виде строки JSON | Нет | - |
delete
Удалить клон RBD
rdc ceph clone delete <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--snapshot <name> | Имя RBD снимка | Да | - |
--image <name> | Имя RBD образа | Да | - |
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
-f, --force | Пропустить подсказки подтверждения | Нет | - |
machines
Показать список машин, назначенных клону
rdc ceph clone machines <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--snapshot <name> | Имя RBD снимка | Да | - |
--image <name> | Имя RBD образа | Да | - |
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
assign
Назначить машины клону
rdc ceph clone assign <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--snapshot <name> | Имя RBD снимка | Да | - |
--image <name> | Имя RBD образа | Да | - |
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
--machines <names> | Имена машин (через запятую) | Да | - |
unassign
Удалить машины из клона
rdc ceph clone unassign <name> [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--snapshot <name> | Имя RBD снимка | Да | - |
--image <name> | Имя RBD образа | Да | - |
--pool <name> | Имя пула Ceph | Да | - |
--team <name> | Имя команды | Да | - |
--machines <names> | Имена машин (через запятую) | Да | - |
17. Аудит и соответствие
Команды журнала аудита
17.1 list
Список записей журнала аудита
rdc audit list
17.2 log
Просмотр журналов аудита
rdc audit log [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--limit <n> | Максимальное количество результатов | Нет | 100 |
17.3 trace
Отследить историю аудита объекта
rdc audit trace <entityType> <entityId>
17.4 history
Просмотреть историю объекта
rdc audit history <entityType> <entityId>
18. Обработчик протокола
Управление регистрацией обработчика протокола {{scheme}}:// и обработкой URL
18.1 register
Зарегистрировать обработчик протокола в системе
rdc protocol register [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--system | Зарегистрировать в масштабе системы (требуются привилегии администратора) | Нет | - |
--force | Принудительно переживистрировать даже если уже зарегистрирован | Нет | - |
18.2 unregister
Отменить регистрацию обработчика протокола из системы
rdc protocol unregister [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--system | Отменить регистрацию системной регистрации (требуются привилегии администратора) | Нет | - |
18.3 status
Показать статус регистрации обработчика протокола
rdc protocol status
18.4 open
Открыть {{scheme}}:// URL и выполнить действие
rdc protocol open <url>
18.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...> | Дополнительные параметры | Нет | - |
18.6 parse
Разобрать {{scheme}}:// URL и показать компоненты
rdc protocol parse <url>
19. Быстрые команды (ярлыки)
19.1 run
Запустить функцию (ярлык для: queue create)
rdc run
19.2 trace
Трассировка задачи (ярлык для: queue trace)
rdc trace
19.3 cancel
Отменить задачу (ярлык для: queue cancel)
rdc cancel
19.4 retry
Повторить неудачную задачу (ярлык для: queue retry)
rdc retry
20. Обновления CLI
Проверить и применить обновления CLI
rdc update [options]
| Флаг | Описание | Обязательно | По умолчанию |
|---|---|---|---|
--force | Принудительное обновление, даже если уже актуально | Нет | - |
--check-only | Только проверить обновления без загрузки | Нет | - |
21. Диагностика системы
Диагностика среды CLI и интеграции renet
rdc doctor
Распространённые сообщения об ошибках
Когда что-то идёт не так, CLI предоставляет понятные сообщения об ошибках:
| Ошибка | Значение |
|---|---|
| Требуется аутентификация. Выполните: rdc login | Сначала необходимо войти в систему |
| Нет активного контекста. Сначала создайте или выберите контекст. | Контекст не выбран — создайте или переключитесь на один из них |
| Доступ запрещен | У вашей учётной записи нет необходимых прав |
| Требуется имя машины. Используйте --machine или установите контекст. | Укажите машину с помощью `--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-конвейеры и рабочие процессы автоматизации.