Referencia de la CLI de Rediacc
Descripción general
La **CLI de Rediacc** (`rdc`) es una interfaz de línea de comandos para gestionar todos los aspectos de la plataforma Rediacc — autenticación, infraestructura, repositorios, colas, almacenamiento y más.
Instalación
Descargue el último binario para su plataforma desde la [página de versiones de Rediacc](https://www.rediacc.com) o instale a través de su gestor de paquetes:
# macOS / Linux
curl -fsSL https://get.rediacc.com | sh
# Or use the packaged binary directly
./rdc --helpOpciones Globales
Todos los comandos admiten estos flags globales:
| Opción | Descripción |
|---|---|
--output | Formato de salida (table|json|yaml|csv) |
--config | Usar una configuración específica para este comando |
--lang | Anulación de idioma ({{languages}}) |
--force | Omitir indicadores de confirmación |
1. Utilidades del agente
Utilidades para asistentes de codificación con IA
1.1 capabilities
Listar todos los comandos disponibles con argumentos y opciones
rdc agent capabilities1.2 schema
Mostrar esquema detallado de un comando específico
rdc agent schema <command>1.3 exec
Ejecutar un comando con entrada JSON desde stdin
rdc agent exec <command>1.4 generate-reference
Generar referencia de comandos en Markdown para habilidades de Claude
rdc agent generate-reference2. Gestión de Configuración
Gestionar archivos de configuración, máquinas y conexiones SSH
Los archivos de configuración almacenan detalles de conexión (URL de API, credenciales, equipo/región/puente predeterminados) para que pueda cambiar entre entornos rápidamente.
2.1 init
Crear un nuevo archivo de configuración con nombre
En modo local puede agregar máquinas directamente:
rdc config init [name] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--ssh-key <path> | Ruta a clave privada SSH (p. ej., ~/.ssh/id_rsa) | No | - |
--renet-path <path> | Ruta al binario renet (predeterminado: renet en PATH) | No | - |
--master-password <password> | Cifrar recursos con una contraseña maestra | No | - |
-u, --api-url <url> | URL de API | No | - |
2.2 list
Listar todos los archivos de configuración
rdc config list2.3 show
Mostrar detalles de la configuración actual
rdc config show2.4 delete
Eliminar un archivo de configuración
rdc config delete <name>2.5 set
Establecer un valor predeterminado (equipo, región, puente)
rdc config set <key> <value>Consejo: Establecer valores predeterminados significa que no necesita pasar `--team`, `--region` o `--bridge` con cada comando.
2.6 clear
Borrar valores predeterminados (todos o uno específico)
rdc config clear [key]2.7 recover
Restaurar configuración desde archivo de respaldo (.bak)
rdc config recover [name] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-y, --yes | Omitir indicador de confirmación | No | - |
2.8 set-ssh
Actualizar configuración SSH para la configuración actual
rdc config set-ssh2.9 set-renet
Establecer la ruta al binario renet para modo local
rdc config set-renet2.10 ssh
Gestionar la configuración de clave SSH
set
Establecer clave SSH para la configuración actual
rdc config ssh set [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--key <path> | Ruta al archivo de clave SSH privada | Sí | - |
--embed | Incrustar el contenido de la clave en la configuración en lugar de almacenar la ruta | No | - |
show
Mostrar la configuración actual de clave SSH
rdc config ssh showremove
Eliminar clave SSH de la configuración actual
rdc config ssh remove2.11 machine
Gestionar máquinas en la configuración actual
add
Agregar una máquina a la configuración actual
rdc config machine add <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--ip <address> | Dirección IP de máquina o nombre de host | Sí | - |
--user <username> | Nombre de usuario SSH | Sí | - |
--port <port> | Puerto SSH | No | 22 |
--datastore <path> | Ruta de almacén de datos en máquina | No | /mnt/rediacc |
remove
Eliminar una máquina de la configuración actual
rdc config machine remove <name>list
Listar máquinas en la configuración actual
rdc config machine listscan-keys
Escanear claves de host SSH para máquinas en la configuración actual
rdc config machine scan-keys [machine]setup
Aprovisionar una máquina remota para repositorios (instala renet, configura Docker, almacén BTRFS). Idempotente. Requerido después de config machine add y antes de repo create
rdc config machine setup <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--datastore <path> | Ruta del almacén de datos en la máquina remota | No | /mnt/rediacc |
--datastore-size <size> | Tamaño del almacén de datos (ej.: 95%, 100G) | No | 95% |
--debug | Habilitar salida de depuración (modo local) | No | - |
set-ceph
Establecer configuración de Ceph RBD para una máquina
rdc config machine set-ceph [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de máquina | Sí | - |
--pool <name> | Nombre del pool de Ceph (ej., rbd) | Sí | - |
--image <name> | Nombre de imagen RBD (ej., datastore-prod1) | Sí | - |
--cluster <name> | Nombre de clúster Ceph | No | ceph |
2.12 repository
Gestionar mapeos de repositorios en la configuración actual
add
Añadir mapeo de GUID de repositorio a la configuración actual
rdc config repository add <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--guid <guid> | GUID del repositorio (UUID de nombres de archivos de respaldo) | Sí | - |
--tag <tag> | Etiqueta de repositorio | No | latest |
--credential <credential> | Credencial del repositorio (frase de cifrado) | No | - |
--network-id <id> | ID de red para aislamiento Docker (2816, 2880, ...). Se asigna automáticamente si se omite | No | - |
remove
Eliminar mapeo de repositorio de la configuración actual
rdc config repository remove <name>list
Listar mapeos de GUID de repositorios en la configuración actual
rdc config repository listlist-archived
Listar credenciales de repositorios archivados
rdc config repository list-archivedrestore-archived
Restaurar credencial de repositorio archivado
rdc config repository restore-archived <guid> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--name <name> | Restaurar con un nombre diferente | No | - |
purge-archived
Eliminar permanentemente todas las credenciales archivadas
rdc config repository purge-archived2.13 provider
Gestionar proveedores de nube para aprovisionamiento automático de máquinas
add
Añadir un proveedor de nube
rdc config provider add <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--provider <source> | Fuente de proveedor conocido (ej., linode/linode, hetznercloud/hcloud) | No | - |
--source <source> | Fuente personalizada de proveedor OpenTofu (ej., vultr/vultr) | No | - |
--token <token> | Token de API para el proveedor de nube | Sí | - |
--region <region> | Región predeterminada para nuevas máquinas | No | - |
--type <type> | Tipo/tamaño de instancia predeterminado | No | - |
--image <image> | Imagen de SO predeterminada | No | - |
--ssh-user <user> | Usuario SSH para nuevas VMs (por defecto: root) | No | - |
--resource <type> | Personalizado: tipo de recurso OpenTofu para VMs | No | - |
--label-attr <attr> | Personalizado: nombre del atributo para la etiqueta de la VM | No | - |
--region-attr <attr> | Personalizado: nombre del atributo para la región | No | - |
--size-attr <attr> | Personalizado: nombre del atributo para el tipo de instancia | No | - |
--image-attr <attr> | Personalizado: nombre del atributo para la imagen del SO | No | - |
--ipv4-output <attr> | Personalizado: atributo de salida para la dirección IPv4 | No | - |
--ipv6-output <attr> | Personalizado: atributo de salida para la dirección IPv6 | No | - |
--ssh-key-attr <attr> | Personalizado: nombre del atributo para claves SSH | No | - |
--ssh-key-format <format> | Personalizado: formato de clave SSH (inline_list o resource_id) | No | - |
--ssh-key-resource <type> | Personalizado: tipo de recurso OpenTofu para claves SSH | No | - |
remove
Eliminar configuración de proveedor de nube
rdc config provider remove <name>list
Listar proveedores de nube configurados
rdc config provider list2.14 storage
Gestionar backends de almacenamiento en la configuración actual
import
Importar almacenamientos desde un archivo de configuración rclone
rdc config storage import <file> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--name <name> | Importar solo esta sección nombrada | No | - |
remove
Eliminar un almacenamiento de la configuración actual
rdc config storage remove <name>list
Listar almacenamientos en la configuración actual
rdc config storage list2.15 infra
Gestionar configuración de infraestructura (proxy, DNS, certificados)
set
Establecer configuración de infraestructura para una máquina (específico de máquina: IPs, dominio, puertos; compartido: email de certificado, token DNS de Cloudflare)
rdc config infra set <machine> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--public-ipv4 <ip> | Dirección IPv4 pública (por máquina) | No | - |
--public-ipv6 <ip> | Dirección IPv6 pública (por máquina) | No | - |
--base-domain <domain> | Dominio base para aplicaciones (por máquina) | No | - |
--cert-email <email> | Correo para notificaciones de certificados TLS (compartido entre máquinas) | No | - |
--cf-dns-token <token> | Token de Cloudflare DNS API para desafío ACME DNS-01 (compartido entre máquinas) | No | - |
--tcp-ports <ports> | Puertos TCP a reenviar (separados por comas, ej., 25,143,465) | No | - |
--udp-ports <ports> | Puertos UDP a reenviar (separados por comas, ej., 53) | No | - |
show
Mostrar configuración de infraestructura para una máquina
rdc config infra show <machine>push
Enviar configuración de infraestructura a la máquina (proxy Traefik, enrutador, Cloudflare DNS). Ejecuta primero 'config infra set <machine>'
rdc config infra push <machine> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--debug | Habilitar salida de depuración (modo local) | No | - |
2.16 cert-cache
Gestionar certificados TLS en caché
pull
Descargar y almacenar en caché certificados TLS desde una máquina
rdc config cert-cache pull <machine> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--no-prune | Omitir limpieza de certificados de ID de red obsoletos | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
push
Subir certificados TLS en caché a una máquina
rdc config cert-cache push <machine> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--debug | Habilitar salida de depuración (modo local) | No | - |
status
Mostrar inventario de certificados en caché
rdc config cert-cache statusclear
Eliminar la caché de certificados
rdc config cert-cache clear2.17 backup-strategy
Gestionar estrategia de respaldo multi-destino
set
Configurar ajustes de programación de respaldos
rdc config backup-strategy set [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--destination <storage> | Nombre del destino de almacenamiento predeterminado | No | - |
--cron <expression> | Expresión cron para la programación de respaldos (ej. "0 2 * * *") | No | - |
--enable | Habilitar respaldos programados | No | - |
--disable | Deshabilitar respaldos programados | No | - |
show
Mostrar la configuración actual de programación de respaldos
rdc config backup-strategy show3. Gestión de almacenamiento de datos
Gestionar el ciclo de vida del almacén de datos Ceph RBD (init, fork, unfork, status)
3.1 init
Inicializar almacén de datos en una máquina (local o Ceph RBD)
rdc datastore init [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina (donde se aloja el almacén de datos Ceph) | Sí | - |
--size <size> | Tamaño del almacén de datos (ej., 5G, 50G, 100G) | Sí | - |
--backend <type> | Tipo de backend: local (predeterminado) o ceph | No | local |
--pool <name> | Nombre del pool Ceph (predeterminado: de la configuración de la máquina, o rbd) | No | rbd |
--image <name> | Nombre de imagen Ceph RBD (predeterminado: de la configuración de la máquina vía set-ceph) | No | - |
--cluster <name> | Nombre del clúster Ceph (predeterminado: ceph) | No | ceph |
--force | Forzar inicialización aunque el almacén de datos ya exista (ADVERTENCIA: reformatea el almacenamiento) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
3.2 fork
Crear una copia COW local de un almacén de datos Ceph mediante snapshot + clone RBD (< 2s). Guarde los nombres de snapshot/clone de la salida para unfork. Solo un fork por nombre de destino; ejecute unfork antes de volver a hacer fork
rdc datastore fork [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina (donde se aloja el almacén de datos Ceph) | Sí | - |
--to <name> | Sufijo del clon (crea un clon llamado <image>-fork-<name>). El fork permanece en la máquina de origen | Sí | - |
--cow-size <size> | Tamaño del archivo de respaldo COW (predeterminado: auto, crece según demanda) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
3.3 unfork
Limpiar un fork: desmontar COW, eliminar clon, eliminar snapshot
rdc datastore unfork [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina (donde se aloja el almacén de datos Ceph) | Sí | - |
--source <image> | Imagen RBD original que fue bifurcada (de config set-ceph --image, ej. ds-prod) | Sí | - |
--snapshot <name> | Snapshot a eliminar (el valor "Snapshot:" de la salida de fork, ej. fork-<timestamp>) | Sí | - |
--dest <image> | Imagen de clon a eliminar (el valor "Clone:" de la salida de fork, ej. ds-prod-fork-<machine>) | Sí | - |
--pool <name> | Nombre del pool Ceph (predeterminado: de la configuración de la máquina) | No | - |
--mount-point <path> | Punto de montaje del fork a desmontar (predeterminado: /mnt/rediacc) | No | - |
--force | Continuar la limpieza aunque fallen pasos individuales (ej., desmontaje, eliminación de snapshot) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
3.4 status
Mostrar backend, tamaño, uso, estado de montaje y cow_mode (si está bifurcado) del almacén de datos
rdc datastore status [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina (donde se aloja el almacén de datos Ceph) | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
4. Gestión de Máquinas
Gestionar máquinas remotas (estado, contenedores, servicios, salud)
4.1 list
Listar máquinas
rdc machine list [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--search <text> | Buscar en {{field}} | No | - |
--sort <field> | Ordenar por campo | No | - |
--desc | Orden descendente | No | - |
4.2 create
Crear una nueva máquina
rdc machine create <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
-b, --bridge <name> | Nombre de puente | No | - |
--vault <json> | Datos de bóveda de máquina como cadena JSON | No | - |
4.3 rename
Renombrar una máquina
rdc machine rename <oldName> <newName> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
4.4 delete
Eliminar una máquina
rdc machine delete <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
-f, --force | Omitir indicadores de confirmación | No | - |
--dry-run | Mostrar lo que se haría sin realizar cambios | No | - |
4.5 vault
Gestión del almacén de la máquina (solo adaptador cloud)
rdc machine vault4.6 vault-status
{{t:cli.commands.machine.vault-status.description}}
rdc machine vault-status <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
4.7 update
Actualizar configuración de máquina
rdc machine update4.8 health
Verificar salud de la máquina para pipelines CI/CD
El comando health muestra métricas del sistema, estado de contenedores, estabilidad de servicios e información de almacenamiento — útil para verificaciones de pipelines CI/CD.
rdc machine health <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
4.9 containers
Listar contenedores en ejecución en una máquina
rdc machine containers <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--health-check | Modo de verificación de salud - sale con código 2 si hay algún no saludable | No | - |
4.10 services
Listar servicios systemd en una máquina
rdc machine services <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--stability-check | Modo de verificación de estabilidad - sale con código 2 si hay algún fallido/reiniciando | No | - |
4.11 query
Mostrar estado completo de la máquina (sistema, repos, contenedores, servicios)
rdc machine query <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--debug | Habilitar salida de depuración (modo local) | No | - |
--system | Incluir solo información del sistema | No | - |
--repositories | Incluir solo repositorios | No | - |
--containers | Incluir solo contenedores | No | - |
--services | Incluir solo servicios | No | - |
--network | Incluir solo interfaces de red | No | - |
--block-devices | Incluir solo dispositivos de bloque | No | - |
4.12 vault-status
Mostrar estado de bóveda analizada para una máquina
rdc machine vault-status <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
4.13 repos
Listar repositorios implementados en una máquina
rdc machine repos <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--search <text> | Filtrar repositorios por nombre | No | - |
4.14 test-connection
Probar conexión SSH a una máquina y capturar clave de host
rdc machine test-connection [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--ip <address> | Dirección IP de máquina o nombre de host | Sí | - |
--user <name> | Nombre de usuario SSH | Sí | - |
-t, --team <name> | Nombre de equipo | No | - |
-b, --bridge <name> | Nombre de puente | No | - |
--port <number> | Puerto SSH | No | 22 |
--password <pwd> | Contraseña SSH para autenticación inicial | No | - |
--datastore <path> | Ruta de almacén de datos en máquina | No | /mnt/rediacc |
-m, --machine <name> | Nombre de máquina (para actualizar bóveda después de prueba) | No | - |
--save | Guardar known_hosts en bóveda de máquina después de prueba exitosa | No | - |
Consejo: Use `--save-known-hosts` para persistir automáticamente la clave del host en el vault de la máquina después de una prueba exitosa.
4.15 provision
Aprovisionar una nueva máquina en un proveedor de nube usando OpenTofu
rdc machine provision <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--provider <name> | Nombre del proveedor de nube (de config provider add) | Sí | - |
--region <region> | Anular región predeterminada | No | - |
--type <type> | Anular tipo de instancia predeterminado | No | - |
--image <image> | Anular imagen de SO predeterminada | No | - |
--ssh-user <user> | Nombre de usuario SSH para la nueva VM (predeterminado: root) | No | - |
--base-domain <domain> | Dominio base para infraestructura (ej. example.com). Implica --infra | No | - |
--no-infra | Omitir configuración de infraestructura (proxy + DNS) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
4.16 deprovision
Destruir una máquina aprovisionada en la nube y eliminar de la configuración
rdc machine deprovision <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--force | Omitir indicador de confirmación | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
4.17 backup
Gestión de respaldos de máquina
schedule
Enviar programación de respaldo a una máquina remota (temporizador systemd)
rdc machine backup schedule <machine> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--debug | Habilitar salida de depuración (modo local) | No | - |
4.18 prune
Eliminar recursos huérfanos del almacén de datos e instantáneas obsoletas de una máquina
rdc machine prune <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--dry-run | Mostrar lo que se eliminaría sin realizar cambios | No | - |
--orphaned-repos | También eliminar imágenes de repositorios que no están en ninguna configuración | No | - |
--force | Omitir indicadores de confirmación | No | - |
--grace-days <days> | Período de gracia en días para repositorios archivados recientemente (predeterminado: 7) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
5. Servidor MCP
Servidor de Model Context Protocol para agentes de IA
5.1 serve
Iniciar servidor MCP (transporte stdio)
rdc mcp serve [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--config <name> | Nombre de configuración a usar para todos los comandos | No | - |
--timeout <ms> | Tiempo de espera predeterminado de comando en milisegundos | No | 120000 |
--allow-grand | Permitir operaciones destructivas en repositorios grand (no fork). Predeterminado: modo solo fork | No | - |
6. Ciclo de vida de repositorios
Desplegar y gestionar repositorios cifrados en máquinas
6.1 mount
Montar un repositorio (abrir contenedor LUKS)
rdc repo mount [name] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--checkpoint | Restaurar desde checkpoint después de montar | No | - |
--no-docker | Omitir el inicio del demonio Docker después del montaje | No | - |
--parallel | Iniciar repositorios de forma concurrente | No | - |
--concurrency <n> | Máximo de repositorios concurrentes (predeterminado: 3) | No | 3 |
-y, --yes | Omitir confirmación para operaciones por lotes | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.2 unmount
Desmontar un repositorio
rdc repo unmount [name] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--checkpoint | Crear checkpoint antes de desmontar | No | - |
--parallel | Iniciar repositorios de forma concurrente | No | - |
--concurrency <n> | Máximo de repositorios concurrentes (predeterminado: 3) | No | 3 |
-y, --yes | Omitir confirmación para operaciones por lotes | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.3 up
Desplegar o actualizar un repositorio (montar, iniciar servicios)
rdc repo up [name] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--mount | Montar repositorio primero | No | - |
--skip-checkpoint | Omitir restauración de checkpoint CRIU aunque existan datos de checkpoint (forzar inicio limpio) | No | - |
--tls | Solicitar certificado TLS dedicado para este repositorio (los forks usan el certificado compartido de la máquina por defecto) | No | - |
--include-forks | También montar/iniciar repositorios bifurcados | No | - |
--mount-only | Solo montar, no iniciar servicios | No | - |
--parallel | Iniciar repositorios de forma concurrente | No | - |
--concurrency <n> | Máximo de repositorios concurrentes (predeterminado: 3) | No | 3 |
-y, --yes | Omitir confirmación para operaciones por lotes | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
--dry-run | Mostrar lo que se haría sin realizar cambios | No | - |
6.4 up-all
Desplegar todos los repositorios en una máquina
rdc repo up-all6.5 down
Detener servicios del repositorio
rdc repo down [name] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--unmount | Desmontar repositorio después de detener | No | - |
--checkpoint | Crear checkpoint CRIU antes de detener (guardar estado de memoria de procesos para restaurar luego via 'repo up') | No | - |
-y, --yes | Omitir confirmación para operaciones por lotes | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
--dry-run | Mostrar lo que se haría sin realizar cambios | No | - |
6.6 status
Obtener estado del repositorio
rdc repo status <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.7 list
Listar repositorios en una máquina
rdc repo list [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.8 create
Crear un nuevo repositorio cifrado
rdc repo create <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--size <size> | Tamaño del repositorio (ej. 10G, 100G, 1T) | Sí | - |
--no-docker | Omitir el inicio del demonio Docker después de la creación | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.9 delete
Eliminar un repositorio (destruye contenedores, volúmenes e imagen cifrada). La entrada de configuración se conserva. Use --archive-config para mover credenciales a deletedRepositories para recuperación vía 'config restore-archived'
rdc repo delete <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--archive-config | Mover entrada de configuración a deletedRepositories para recuperación posterior | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
--dry-run | Mostrar lo que se haría sin realizar cambios | No | - |
6.10 fork
Crear un fork CoW (Copy-on-Write) de un repositorio
rdc repo fork <parent> [tag] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--tag <name> | Etiqueta para el fork (crea nombre:etiqueta) | No | - |
--checkpoint | Crear checkpoint CRIU en el origen antes de fork (capturar estado de memoria de procesos para restaurar en el fork) | No | - |
--up | Montar e iniciar servicios después de fork (fork + mount + up en un solo comando) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.11 takeover
Reemplazar los datos del repositorio principal con los datos de un fork. El principal conserva su identidad (GUID, networkId, dominios, inicio automático, cadena de respaldos) pero obtiene los datos actualizados del fork. Los datos de producción anteriores se conservan como fork de respaldo. Uso: probar la actualización en el fork → verificar → tomar el control en producción.
rdc repo takeover <fork> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--force | Omitir advertencias de modificación | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.12 resize
Redimensionar un repositorio sin conexión (soporta expandir y reducir)
rdc repo resize <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--size <size> | Nuevo tamaño del repositorio (ej. 10G, 100G, 1T) | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.13 expand
Expandir un repositorio montado en línea (sin tiempo de inactividad)
rdc repo expand <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--size <size> | Nuevo tamaño del repositorio (ej. 10G, 100G, 1T) | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.14 validate
Validar la integridad del repositorio
rdc repo validate <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.15 autostart
Gestionar el inicio automático de repositorios al arrancar
enable
Habilitar inicio automático para un repositorio
rdc repo autostart enable [name] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
disable
Deshabilitar inicio automático para un repositorio
rdc repo autostart disable [name] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
list
Listar repositorios con inicio automático habilitado
rdc repo autostart list [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.16 ownership
Cambiar propiedad del directorio del repositorio
rdc repo ownership <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
--uid <uid> | UID del propietario (predeterminado: 7111) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.17 template
Aplicar una plantilla a un repositorio
list
Listar todas las plantillas de despliegue integradas en la 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 <template> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de la máquina de destino | Sí | - |
-r, --repository <name> | Nombre de repositorio (conecta a entorno de repositorio) | Sí | - |
--file <path> | Ruta al archivo de plantilla JSON | No | - |
--grand <name> | Nombre del repositorio Grand (se resuelve automáticamente a GUID) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.18 push
Enviar repositorio a un remoto (máquina o almacenamiento). Omitir el nombre para enviar todos los repos. El tipo de destino se detecta automáticamente desde la configuración. Para transferencia entre máquinas, la imagen cifrada del repo se copia con el MISMO GUID — esto es un respaldo/migración, no un fork. Para crear un fork independiente, use 'repo fork' primero, luego push. Use --up para desplegar después del push
rdc repo push [repo] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--to <remote> | Nombre de la máquina o almacenamiento de destino (detectado automáticamente desde la configuración) | No | - |
--to-machine <machine> | — | No | - |
--provision <provider> | Aprovisionar automáticamente la máquina destino a través del proveedor de nube si no existe | No | - |
--checkpoint | Crear checkpoint CRIU antes del respaldo (captura el estado de memoria del proceso para migración en vivo) | No | - |
--force | Forzar sobrescritura del respaldo existente | No | - |
--up | Después del envío, montar y desplegar el repositorio en la máquina de destino | No | - |
--tag <tag> | Etiqueta de despliegue para versionamiento | No | - |
-m, --machine <name> | Nombre de máquina | Sí | - |
-w, --watch | Observar cambios | No | - |
--parallel | Iniciar repositorios de forma concurrente | No | - |
--concurrency <n> | Máximo de repositorios concurrentes (predeterminado: 3) | No | 3 |
-y, --yes | Omitir confirmación para operaciones por lotes | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.19 pull
Obtener repositorio de un remoto (máquina o almacenamiento). Omitir el nombre para obtener todos los repos. El tipo de origen se detecta automáticamente desde la configuración. Use --up para desplegar después del pull
rdc repo pull [repo] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--from <remote> | Nombre de la máquina o almacenamiento de origen (detectado automáticamente desde la configuración) | No | - |
--from-machine <machine> | — | No | - |
--force | Forzar sobrescritura del repositorio existente | No | - |
--up | Después de pull, montar y desplegar el repositorio en esta máquina | No | - |
-m, --machine <name> | Nombre de máquina | Sí | - |
-w, --watch | Observar cambios | No | - |
--parallel | Iniciar repositorios de forma concurrente | No | - |
--concurrency <n> | Máximo de repositorios concurrentes (predeterminado: 3) | No | 3 |
-y, --yes | Omitir confirmación para operaciones por lotes | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.20 backup
Gestionar respaldos de repositorios
list
Listar respaldos disponibles en un remoto (máquina o almacenamiento)
rdc repo backup list [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--from <remote> | Nombre de la máquina o almacenamiento de origen (detectado automáticamente desde la configuración) | No | - |
--from-machine <machine> | — | No | - |
-m, --machine <name> | Nombre de máquina | Sí | - |
-w, --watch | Observar cambios | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
6.21 sync
Sincronizar repositorios y archivos (push/pull masivo, transferencia de archivos)
push
Subir repositorios al almacenamiento en la nube (omitir nombre para subir todos)
rdc repo sync pushpull
Descargar repositorios del almacenamiento en la nube (omitir nombre para descargar todos)
rdc repo sync pullupload
Subir archivos a un repositorio
rdc repo sync upload [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
-m, --machine <name> | Nombre de máquina | Sí | - |
-r, --repository <name> | Nombre de repositorio (conecta a entorno de repositorio) | No | - |
--local <path> | Ruta de directorio local (predeterminado: directorio actual) | No | - |
--remote <path> | Ruta de subdirectorio remoto dentro del repositorio | No | - |
--mirror | Modo espejo - eliminar archivos remotos no presentes localmente | No | - |
--verify | Verificar archivos usando sumas de control después de sincronización | No | - |
--confirm | Previsualizar cambios y solicitar confirmación antes de sincronizar | No | - |
--exclude <patterns...> | Patrones a excluir de sincronización | No | - |
--dry-run | Mostrar lo que se haría sin realizar cambios | No | - |
download
Descargar archivos de un repositorio
rdc repo sync download [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
-m, --machine <name> | Nombre de máquina | Sí | - |
-r, --repository <name> | Nombre de repositorio (conecta a entorno de repositorio) | No | - |
--local <path> | Ruta de directorio local (predeterminado: directorio actual) | No | - |
--remote <path> | Ruta de subdirectorio remoto dentro del repositorio | No | - |
--mirror | Modo espejo - eliminar archivos locales no presentes en remoto | No | - |
--verify | Verificar archivos usando sumas de control después de sincronización | No | - |
--confirm | Previsualizar cambios y solicitar confirmación antes de sincronizar | No | - |
--exclude <patterns...> | Patrones a excluir de sincronización | No | - |
--dry-run | Mostrar lo que se haría sin realizar cambios | No | - |
status
Verificar el estado de sincronización y comparar archivos locales/remotos
rdc repo sync status [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
-m, --machine <name> | Nombre de máquina | Sí | - |
-r, --repository <name> | Nombre de repositorio (conecta a entorno de repositorio) | No | - |
--local <path> | Ruta de directorio local (predeterminado: directorio actual) | No | - |
--remote <path> | Ruta de subdirectorio remoto dentro del repositorio | No | - |
6.22 snapshot
Gestionar instantáneas BTRFS en máquinas remotas
create
Crear una instantánea BTRFS de un repositorio
rdc repo snapshot createlist
Listar instantáneas en una máquina remota
rdc repo snapshot listdelete
Eliminar una instantánea de una máquina remota
rdc repo snapshot delete6.23 tunnel
Crear un túnel SSH de reenvío de puertos al puerto de un contenedor en una máquina remota. Detecta automáticamente el contenedor y el puerto cuando no hay ambigüedad. El túnel permanece abierto hasta que presione Ctrl+C
rdc repo tunnel [machine] [repository] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-c, --container <name> | Nombre del contenedor (detectado automáticamente si solo hay uno en ejecución) | No | - |
--port <port> | Puerto del contenedor remoto a reenviar | No | - |
--local <port> | Puerto local (por defecto igual al puerto remoto) | No | - |
7. Gestión de Almacenamiento
Gestionar proveedores de almacenamiento y explorar archivos remotos
7.1 list
Listar proveedores de almacenamiento
rdc storage list [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--search <text> | Buscar en {{field}} | No | - |
--sort <field> | Ordenar por campo | No | - |
--desc | Orden descendente | No | - |
7.2 create
Crear un nuevo proveedor de almacenamiento
rdc storage create <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
7.3 rename
Renombrar un proveedor de almacenamiento
rdc storage rename <oldName> <newName> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
7.4 delete
Eliminar un proveedor de almacenamiento
rdc storage delete <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
-f, --force | Omitir indicadores de confirmación | No | - |
--dry-run | Mostrar lo que se haría sin realizar cambios | No | - |
7.5 vault
Gestión del almacén de almacenamiento (solo adaptador cloud)
rdc storage vault7.6 browse
Explorar archivos en un sistema de almacenamiento
rdc storage browse <name> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--path <subpath> | Ruta del subdirectorio a listar | No | “ |
7.7 prune
Eliminar copias de seguridad huérfanas del almacenamiento que ya no están en ninguna configuración. Seguro con múltiples configuraciones con protección de período de gracia.
rdc storage prune <storageName> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de máquina | Sí | - |
--dry-run | Mostrar lo que se haría sin realizar cambios | No | - |
--force | Omitir indicadores de confirmación | No | - |
--grace-days <days> | Período de gracia en días para repositorios archivados recientemente (predeterminado: 7) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
--skip-router-restart | Omitir reinicio del servidor de rutas tras actualización del binario | No | - |
7.8 pull
Descargar un backup del almacenamiento en la nube a una máquina
rdc storage pull8. Integración con VS Code
Abrir VS Code Remote SSH en una máquina o repositorio
8.1 connect
Conectarse a una máquina o repositorio en VS Code
rdc vscode connect [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
-m, --machine <name> | Nombre de máquina | No | - |
-r, --repository <name> | Nombre de repositorio (conecta a entorno de repositorio) | No | - |
-f, --folder <path> | Ruta de carpeta remota a abrir | No | - |
--url-only | Imprimir URI de VS Code en lugar de lanzar | No | - |
-n, --new-window | Abrir en nueva ventana de VS Code | No | - |
--skip-env-setup | Omitir configuración de entorno remoto | No | - |
--insiders | Usar configuración de VS Code Insiders | No | - |
8.2 list
Listar conexiones SSH de VS Code configuradas
rdc vscode list8.3 cleanup
Eliminar configuraciones SSH de VS Code
rdc vscode cleanup [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--all | Eliminar todas las configuraciones SSH de rediacc | No | - |
-c, --connection <name> | Eliminar conexión específica | No | - |
8.4 check
Verificar instalación y configuración de VS Code
rdc vscode check [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--insiders | Usar configuración de VS Code Insiders | No | - |
9. Acceso Terminal SSH
Acceso a terminal SSH a máquinas y repositorios
9.1 connect
Conectarse a una máquina o repositorio vía SSH
rdc term connect [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
-m, --machine <name> | Nombre de máquina | No | - |
-r, --repository <name> | Nombre de repositorio (conecta a entorno de repositorio) | No | - |
-c, --command <cmd> | Ejecutar un comando en lugar de shell interactivo | No | - |
--container <id> | Conectarse a un contenedor Docker específico | No | - |
--container-action <action> | Acción de contenedor: terminal, logs, stats, exec | No | - |
--log-lines <lines> | Número de líneas de log a mostrar (predeterminado: 50) | No | - |
--follow | Seguir salida de logs | No | - |
--external | Forzar lanzamiento en ventana de terminal externa | No | - |
--reset-home | Restablecer la capa de inicio por repositorio para empezar de nuevo | No | - |
10. Manejador de Protocolo
Registrar y manejar URLs de protocolo {{scheme}}://
10.1 register
Registrar el manejador de protocolo en el sistema
rdc protocol register [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--system | Registrar en todo el sistema (requiere privilegios de administrador) | No | - |
--force | Forzar re-registro incluso si ya está registrado | No | - |
10.2 unregister
Desregistrar el manejador de protocolo del sistema
rdc protocol unregister [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--system | Desregistrar registro en todo el sistema (requiere privilegios de administrador) | No | - |
10.3 status
Mostrar estado de registro del manejador de protocolo
rdc protocol status10.4 open
Abrir una URL {{scheme}}:// y ejecutar la acción
rdc protocol open <url>10.5 build
Construir una URL {{scheme}}:// desde componentes
rdc protocol build [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--token <token> | Token de autenticación | Sí | - |
-t, --team <name> | Nombre de equipo | Sí | - |
-m, --machine <name> | Nombre de máquina | Sí | - |
-r, --repository <name> | Nombre de repositorio (conecta a entorno de repositorio) | No | - |
-a, --action <action> | Acción ({{actions}}) | No | desktop |
-p, --params <key=value...> | Parámetros adicionales | No | - |
10.6 parse
Analizar una URL {{scheme}}:// y mostrar componentes
rdc protocol parse <url>11. Comandos Rápidos (Atajos)
11.1 run
Ejecutar una función (atajo para: queue create)
rdc run11.2 trace
Rastrear una tarea (atajo para: queue trace)
rdc trace11.3 cancel
Cancelar una tarea (atajo para: queue cancel)
rdc cancel11.4 retry
Reintentar una tarea fallida (atajo para: queue retry)
rdc retry12. Gestión de Suscripciones
Gestionar licencias de máquina y suscripción
12.1 login
Autenticarse con un token API del portal web
rdc subscription login [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --token <token> | Token API (rdt_...) | No | - |
--server <url> | URL del servidor de cuenta | No | - |
12.2 logout
Eliminar el token de suscripción almacenado
rdc subscription logout12.3 status
Mostrar estado de suscripción y licencia
rdc subscription status12.4 activation
Gestión de activación de máquinas
status
Mostrar estado de activación de una máquina
rdc subscription activation status [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de máquina | Sí | - |
12.5 repo
Gestión de licencias de repositorios
status
Mostrar licencias de repositorios instaladas en una máquina
rdc subscription repo status [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de máquina | Sí | - |
12.6 refresh
Renovar la licencia de la máquina
activation
Actualizar activación de máquina en una máquina remota
rdc subscription refresh activation [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de máquina | Sí | - |
repos
Actualizar licencias de repositorios por lotes en una máquina remota
rdc subscription refresh repos [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de máquina | Sí | - |
repo
Actualizar la licencia del repositorio para un repositorio específico
rdc subscription refresh repo <repo> [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-m, --machine <name> | Nombre de máquina | Sí | - |
13. Actualizaciones de CLI
Verificar y aplicar actualizaciones del CLI
rdc update [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--force | Forzar actualización aunque esté al día | No | - |
--check-only | Solo verificar actualizaciones sin descargar | No | - |
--rollback | Revertir a la versión anterior | No | - |
--status | Mostrar estado y diagnósticos de actualización automática | No | - |
14. Diagnóstico del sistema
Diagnosticar el entorno CLI y la integración de renet
rdc doctor15. Operaciones experimentales de VM
Operaciones experimentales de VM (aprovisionar, gestionar, destruir)
15.1 up
Aprovisionar clúster de VM localmente
rdc ops up [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--force | Forzar reinicio de todas las VM | No | - |
--parallel | Crear VM en paralelo | No | - |
--basic | Clúster mínimo (puente + 1 trabajador) | No | - |
--lite | Omitir aprovisionamiento de VM (solo estado) | No | - |
--skip-orchestration | Omitir orquestación del clúster | No | - |
--backend <backend> | Backend de virtualización (kvm|qemu, detección automática) | No | - |
--os <name> | Sistema operativo de VM (ej., ubuntu-24.04, debian-12) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
15.2 down
Destruir clúster de VM
rdc ops down [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--backend <backend> | Backend de virtualización (kvm|qemu, detección automática) | No | - |
--debug | Habilitar salida de depuración (modo local) | No | - |
15.3 status
Mostrar estado del clúster de VM
rdc ops status [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--backend <backend> | Backend de virtualización (kvm|qemu, detección automática) | No | - |
15.4 ssh
Conectar por SSH a una VM
rdc ops ssh <vmId> [command...] [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--backend <backend> | Backend de virtualización (kvm|qemu, detección automática) | No | - |
--user <user> | Nombre de usuario SSH para conexión a VM | No | - |
15.5 setup
Instalar prerequisitos de virtualización
rdc ops setup [options]| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--debug | Habilitar salida de depuración (modo local) | No | - |
15.6 check
Verificar prerequisitos de virtualización
rdc ops checkMensajes de Error Comunes
Cuando algo sale mal, la CLI proporciona mensajes de error claros:
| Errores | Significado |
|---|---|
| Se requiere autenticación. Ejecute: rdc auth login | Necesita iniciar sesión primero |
| Sin configuración activa. Cree una con: rdc config init <name> | No hay configuración activa — cree una con `rdc config init` |
| Permiso denegado | Su cuenta no tiene los permisos requeridos |
| Nombre de máquina requerido. Use --machine <name> | Especifique una máquina con `--machine` o establezca un valor predeterminado de contexto |
| Nombre de equipo requerido. Use --team o establezca contexto. | Especifique un equipo con `--team` o establezca un valor predeterminado de contexto |
| Nombre de región requerido. Use --region o establezca contexto. | Especifique una región con `--region` o establezca un valor predeterminado de contexto |
Formatos de Salida
Todos los comandos de listado/obtención admiten múltiples formatos de salida a través de `--output`:
rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table # defaultEsto facilita la integración de la CLI de Rediacc en scripts, pipelines CI/CD y flujos de trabajo de automatización.