Saltar al contenido principal Saltar a navegación Saltar al pie de página
Tiempo limitado: Programa Design Partner — plan BUSINESS de por vida

Aplicación CLI

Guía completa para usar la interfaz de línea de comandos de Rediacc para la gestión de la plataforma

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://www.rediacc.com | sh

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

Opciones Globales

Todos los comandos admiten estos flags globales:

OpciónDescripción
--outputFormato de salida (table|json|yaml|csv). Anular el valor por defecto con REDIACC_DEFAULT_OUTPUT.
--configUsar una configuración específica para este comando
--langAnulación de idioma ({{languages}})
--forceOmitir 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 capabilities

1.2 schema

Mostrar esquema detallado de un comando específico

rdc agent schema [options]
OpciónDescripciónObligatorioPredeterminado
--command <path>Ejecutar un comando en lugar de shell interactivo-

1.3 exec

Ejecutar un comando con entrada JSON desde stdin

rdc agent exec [options]
OpciónDescripciónObligatorioPredeterminado
--command <path>Ejecutar un comando en lugar de shell interactivo-

1.4 generate-reference

Generar referencia de comandos en Markdown para habilidades de Claude

rdc agent generate-reference

2. 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 prune

Elimina lastre del archivo de configuración local en ~/.config/rediacc/<config>.json. Se limpian tres categorías, todas puramente locales (sin llamadas SSH/renet): (1) entradas de caché de certificados ACME cuyo ancla GUID/repo/máquina ya no está en la configuración activa; (2) repositorios archivados cuyo período de gracia ha expirado (por defecto 7 días, ver defaults.pruneGraceDays); (3) referencias cruzadas colgantes (machine→strategy, strategy→repo). Los recursos en uso, credenciales, tokens de almacenamiento y known-hosts nunca se tocan. El comportamiento por defecto es aplicar cambios; usa --dry-run para previsualizar solo.

rdc config prune [options]
OpciónDescripciónObligatorioPredeterminado
--dry-runPrevisualiza lo que se eliminaría sin modificar el archivo de configuración. Refleja la semántica por defecto desactivada de los demás comandos prune.No-
--certs-onlyRestringe al bucket de caché de certificados ACME. Omite la purga de archivos y la limpieza de referencias cruzadas. Mutuamente excluyente con --archives-only y --refs-only.No-
--archives-onlyRestringe a la purga de archivos expirados. Omite caché de certificados y limpieza de referencias cruzadas. Excluyente con --certs-only y --refs-only.No-
--refs-onlyRestringe a referencias cruzadas colgantes (machine→strategy, strategy→repo excluye/incluye). Omite caché de certificados y archivos. Excluyente con --certs-only y --archives-only.No-
--purge-archivedDescarta TODOS los repositorios archivados independientemente de la edad, no solo los que han pasado el período de gracia. Equivalente a ejecutar 'rdc config repository purge-archived'. Usa solo cuando estés seguro de que no necesitas ninguna de las credenciales almacenadas para restauración.No-
--grace-days <days>Anula la ventana de gracia del archivo (en días) para esta invocación. Recurre a defaults.pruneGraceDays en la configuración, luego a 7 si ninguno está establecido.No-

2.2 init

Crear un nuevo archivo de configuración con nombre

En modo local puede agregar máquinas directamente:

rdc config init [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
--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 maestraNo-
-u, --api-url <url>URL de APINo-
--server <url>URL del servidor de cuentaNo-

2.3 list

Listar todos los archivos de configuración

rdc config list

2.4 show

Mostrar detalles de la configuración actual

rdc config show [options]
OpciónDescripciónObligatorioPredeterminado
--revealMostrar texto plano para valores sensibles (solo interactivo)No-

2.5 delete

Eliminar un archivo de configuración

rdc config delete [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-

2.6 set

Establecer un valor predeterminado (equipo, región, puente)

rdc config set [options]
OpciónDescripciónObligatorioPredeterminado
--key <key>Clave de configuración-
--value <value>Valor de configuración-

Consejo: Establecer valores predeterminados significa que no necesita pasar `--team`, `--region` o `--bridge` con cada comando.

2.7 clear

Borrar valores predeterminados (todos o uno específico)

rdc config clear [options]
OpciónDescripciónObligatorioPredeterminado
--key <key>Clave de configuraciónNo-

2.8 recover

Restaurar configuración desde archivo de respaldo (.bak)

rdc config recover [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
-y, --yesOmitir indicador de confirmaciónNo-

2.9 set-ssh

Actualizar configuración SSH para la configuración actual

rdc config set-ssh

2.10 set-renet

Establecer la ruta al binario renet para modo local

rdc config set-renet

2.11 ssh

Gestionar la configuración de clave SSH

set

Establecer clave SSH para la configuración actual

rdc config ssh set [options]
OpciónDescripciónObligatorioPredeterminado
--key <path>Ruta al archivo de clave SSH privada-
--embedIncrustar el contenido de la clave en la configuración en lugar de almacenar la rutaNo-

show

Mostrar la configuración actual de clave SSH

rdc config ssh show

remove

Eliminar clave SSH de la configuración actual

rdc config ssh remove

2.12 remote

Gestionar conexión de almacenamiento remoto de configuración

enable

Vincular esta configuración al almacenamiento cifrado remoto

rdc config remote enable [options]
OpciónDescripciónObligatorioPredeterminado
--headlessUsar flujo de código de dispositivo (para servidores sin interfaz)No-
--api-url <url>URL del servidor de cuentaNo-

disable

Desconectar del almacenamiento remoto y guardar configuración localmente

rdc config remote disable

status

Mostrar estado de conexión remota

rdc config remote status

refresh

Forzar recarga de configuración desde almacenamiento remoto

rdc config remote refresh

2.13 machine

Gestionar máquinas en la configuración actual

add

Agregar una máquina a la configuración actual

rdc config machine add [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--ip <address>Dirección IP de máquina o nombre de host-
--user <username>Nombre de usuario SSH-
--port <port>Puerto SSHNo22
--datastore <path>Ruta de almacén de datos en máquinaNo/mnt/rediacc

remove

Eliminar una máquina de la configuración actual

rdc config machine remove [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-

list

Listar máquinas en la configuración actual

rdc config machine list

scan-keys

Escanear claves de host SSH para máquinas en la configuración actual

rdc config machine scan-keys [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquinaNo-

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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--datastore <path>Ruta del almacén de datos en la máquina remotaNo/mnt/rediacc
--datastore-size <size>Tamaño del almacén de datos (ej.: 95%, 100G)No95%
--debugHabilitar 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ónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--pool <name>Nombre del pool de Ceph (ej., rbd)-
--image <name>Nombre de imagen RBD (ej., datastore-prod1)-
--cluster <name>Nombre de clúster CephNoceph

2.14 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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--guid <guid>GUID del repositorio (UUID de nombres de archivos de respaldo)-
--tag <tag>Etiqueta de repositorioNolatest
--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 omiteNo-

remove

Eliminar mapeo de repositorio de la configuración actual

rdc config repository remove [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-

list

Listar mapeos de GUID de repositorios en la configuración actual

rdc config repository list

list-archived

Listar credenciales de repositorios archivados

rdc config repository list-archived

restore-archived

Restaurar credencial de repositorio archivado

rdc config repository restore-archived [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--new-name <name>Nuevo nombre del recursoNo-

purge-archived

Eliminar permanentemente todas las credenciales archivadas

rdc config repository purge-archived

2.15 provider

Gestionar proveedores de nube para aprovisionamiento automático de máquinas

add

Añadir un proveedor de nube

rdc config provider add [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--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-
--region <region>Región predeterminada para nuevas máquinasNo-
--type <type>Tipo/tamaño de instancia predeterminadoNo-
--image <image>Imagen de SO predeterminadaNo-
--ssh-user <user>Usuario SSH para nuevas VMs (por defecto: root)No-
--resource <type>Personalizado: tipo de recurso OpenTofu para VMsNo-
--label-attr <attr>Personalizado: nombre del atributo para la etiqueta de la VMNo-
--region-attr <attr>Personalizado: nombre del atributo para la regiónNo-
--size-attr <attr>Personalizado: nombre del atributo para el tipo de instanciaNo-
--image-attr <attr>Personalizado: nombre del atributo para la imagen del SONo-
--ipv4-output <attr>Personalizado: atributo de salida para la dirección IPv4No-
--ipv6-output <attr>Personalizado: atributo de salida para la dirección IPv6No-
--ssh-key-attr <attr>Personalizado: nombre del atributo para claves SSHNo-
--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 SSHNo-

remove

Eliminar configuración de proveedor de nube

rdc config provider remove [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-

list

Listar proveedores de nube configurados

rdc config provider list

2.16 storage

Gestionar backends de almacenamiento en la configuración actual

import

Importar almacenamientos desde un archivo de configuración rclone

rdc config storage import [options]
OpciónDescripciónObligatorioPredeterminado
--file <path>Ruta al archivo-
--name <name>Importar solo esta sección nombradaNo-

remove

Eliminar un almacenamiento de la configuración actual

rdc config storage remove [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-

list

Listar almacenamientos en la configuración actual

rdc config storage list

2.17 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 [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--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 [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-

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 [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--debugHabilitar salida de depuración (modo local)No-

2.18 cert-cache

Gestionar certificados TLS en caché

pull

Descargar y almacenar en caché certificados TLS desde una máquina

rdc config cert-cache pull [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--no-pruneOmitir limpieza de certificados de ID de red obsoletosNo-
--debugHabilitar salida de depuración (modo local)No-

push

Subir certificados TLS en caché a una máquina

rdc config cert-cache push [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--debugHabilitar salida de depuración (modo local)No-

status

Mostrar inventario de certificados en caché

rdc config cert-cache status

clear

Eliminar la caché de certificados

rdc config cert-cache clear

2.19 field

Operaciones de campos de configuración direccionados por puntero (get/set/unset/rotate/list). Punteros JSON (RFC 6901) como /credentials/cfDnsApiToken.

get

Lee un único valor de configuración por puntero JSON. Los campos sensibles se redactan salvo con --reveal (solo humanos).

rdc config field get [options]
OpciónDescripciónObligatorioPredeterminado
--pointer <pointer>Puntero JSON al campo (p. ej. /credentials/cfDnsApiToken)-
--revealMostrar texto en claro de valores sensibles (solo TTY interactivo; auditado)No-
--digestImprimir el resumen SHA-256 en lugar del valor (seguro para compartir con agentes)No-

set

Escribir un valor de configuración en un puntero JSON. Los caminos sensibles requieren --current (puerta de conocimiento).

rdc config field set [options]
OpciónDescripciónObligatorioPredeterminado
--pointer <pointer>Puntero JSON al campo (p. ej. /credentials/cfDnsApiToken)-
--new <value>Valor nuevo (se interpreta como JSON si empieza con {, [, ", true, false, null o un número)-
--current <value>Valor actual en claro — obligatorio para mutar caminos sensibles (prueba de conocimiento)No-

unset

Eliminar un valor de configuración en un puntero JSON. Los caminos sensibles requieren --current.

rdc config field unset [options]
OpciónDescripciónObligatorioPredeterminado
--pointer <pointer>Puntero JSON al campo (p. ej. /credentials/cfDnsApiToken)-
--current <value>Valor actual en claro — obligatorio para eliminar caminos sensiblesNo-

rotate

Rotar un valor sensible sin --current. Solo TTY interactivo; auditado con énfasis.

rdc config field rotate [options]
OpciónDescripciónObligatorioPredeterminado
--pointer <pointer>Puntero JSON al campo sensible (p. ej. /credentials/cfDnsApiToken)-
--new <value>Valor nuevo-

list

Listar cada plantilla de puntero registrada con su tipo y política de commit/encriptación.

rdc config field list [options]
OpciónDescripciónObligatorioPredeterminado
--sensitiveMostrar solo plantillas sensibles (no públicas)No-

2.20 edit

Abre la configuración activa en $EDITOR como proyección JSONC redactada. Solo humanos; los agentes son rechazados.

rdc config edit [options]
OpciónDescripciónObligatorioPredeterminado
--revealMostrar texto en claro de valores sensibles (solo TTY interactivo; auditado)No-
--dumpImprimir la configuración actual como JSONC en stdout en lugar de abrir el editor (solo lectura; seguro para agentes cuando está redactado)No-
--apply <file>Aplicar un archivo JSONC editado (omite el lanzamiento de $EDITOR)No-
--current-secrets <file>Archivo JSON que mapea puntero→texto antiguo en claro para la puerta de conocimiento en --applyNo-
--editor <cmd>Orden de editor (sigue la precedencia de git: --editor > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR)No-

2.21 audit

Inspeccionar el registro de auditoría de configuración (JSONL encadenado por hash en ~/.config/rediacc/audit.log.jsonl)

log

Imprimir entradas de auditoría recientes como JSON

rdc config audit log [options]
OpciónDescripciónObligatorioPredeterminado
--since <spec>Mostrar solo entradas posteriores a (ej.: '24h', '7d', timestamp ISO)No-
--path <glob>Filtrar por patrón de puntero JSON (ej.: /credentials/*)No-
--actor <kind>Filtrar por tipo de actor (human|agent)No-

tail

Transmitir nuevas entradas a medida que se escriben (Ctrl+C para detener)

rdc config audit tail

verify

Verificar la integridad de la cadena SHA-256 de todas las entradas de auditoría

rdc config audit verify

2.22 backup-strategy

Gestionar estrategias de respaldo con nombre (modos caliente/frío, destinos, programación)

set

Crear o actualizar una estrategia de respaldo

rdc config backup-strategy set [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre de la estrategia (requerido)-
--destination <name>Nombre del destino dentro de la estrategiaNo-
--storage <name>Nombre de la configuración de almacenamiento (credenciales rclone)No-
--cron <expression>Programación cron (ej. "0 * * * *" para cada hora)No-
--mode <mode>Modo de respaldo: "hot" (sin tiempo de inactividad) o "cold" (detener, instantánea, reiniciar)No-
--bwlimit <limit>Límite de ancho de banda de rclone (ej. "6M", "10M:off", "08:00,3M;22:00,10M")No-
--include <repos>Respaldar solo estos repos (nombres separados por comas)No-
--exclude <repos>Excluir estos repos del respaldo (nombres separados por comas)No-
--folder <path>Subcarpeta en el bucket de almacenamiento para este destino (p. ej. hot, cold)No-
--enableHabilitar la estrategia o destinoNo-
--disableDeshabilitar la estrategia o destinoNo-

remove

Eliminar una estrategia de respaldo o destino

rdc config backup-strategy remove [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre de la estrategia (requerido)-
--destination <name>Eliminar solo este destino (conserva los demás destinos)No-

list

Listar todas las estrategias de respaldo

rdc config backup-strategy list

show

Mostrar detalles de la estrategia de respaldo

rdc config backup-strategy show [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre de la estrategia (muestra todas si se omite)No-

3. 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ónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de la máquina (donde se aloja el almacén de datos Ceph)-
--size <size>Tamaño del almacén de datos (ej., 5G, 50G, 100G)-
--backend <type>Tipo de backend: local (predeterminado) o cephNolocal
--pool <name>Nombre del pool Ceph (predeterminado: de la configuración de la máquina, o rbd)Norbd
--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)Noceph
--forceForzar inicialización aunque el almacén de datos ya exista (ADVERTENCIA: reformatea el almacenamiento)No-
--debugHabilitar 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ónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de la máquina (donde se aloja el almacén de datos Ceph)-
--to <name>Sufijo del clon (crea un clon llamado <image>-fork-<name>). El fork permanece en la máquina de origen-
--cow-size <size>Tamaño del archivo de respaldo COW (predeterminado: auto, crece según demanda)No-
--debugHabilitar salida de depuración (modo local)No-

3.3 unfork

Limpiar un fork: desmontar COW, eliminar clon, eliminar snapshot

rdc datastore unfork [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de la máquina (donde se aloja el almacén de datos Ceph)-
--source <image>Imagen RBD original que fue bifurcada (de config set-ceph --image, ej. ds-prod)-
--snapshot <name>Snapshot a eliminar (el valor "Snapshot:" de la salida de fork, ej. fork-<timestamp>)-
--dest <image>Imagen de clon a eliminar (el valor "Clone:" de la salida de fork, ej. ds-prod-fork-<machine>)-
--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-
--forceContinuar la limpieza aunque fallen pasos individuales (ej., desmontaje, eliminación de snapshot)No-
--debugHabilitar 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ónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de la máquina (donde se aloja el almacén de datos Ceph)-
--debugHabilitar 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ónDescripciónObligatorioPredeterminado
-t, --team <name>Nombre de equipoNo-
--search <text>Buscar en {{field}}No-
--sort <field>Ordenar por campoNo-
--descOrden descendenteNo-

4.2 create

Crear una nueva máquina

rdc machine create [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-
-b, --bridge <name>Nombre de puenteNo-
--vault <json>Datos de bóveda de máquina como cadena JSONNo-

4.3 rename

Renombrar una máquina

rdc machine rename [options]
OpciónDescripciónObligatorioPredeterminado
--current-name <name>Nombre actual del recurso-
--new-name <name>Nuevo nombre del recurso-
-t, --team <name>Nombre de equipoNo-

4.4 delete

Eliminar una máquina

rdc machine delete [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-
-f, --forceOmitir indicadores de confirmaciónNo-
--dry-runMostrar lo que se haría sin realizar cambiosNo-

4.5 vault

Gestión del almacén de la máquina (solo adaptador cloud)

rdc machine vault

4.6 vault-status

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

rdc machine vault-status [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-

4.7 update

Actualizar configuración de máquina

rdc machine update

4.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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-

4.9 containers

Listar contenedores en ejecución en una máquina

rdc machine containers [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-
--health-checkModo de verificación de salud - sale con código 2 si hay algún no saludableNo-

4.10 services

Listar servicios systemd en una máquina

rdc machine services [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-
--stability-checkModo de verificación de estabilidad - sale con código 2 si hay algún fallido/reiniciandoNo-

4.11 query

Mostrar estado completo de la máquina (sistema, repos, contenedores, servicios)

rdc machine query [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--debugHabilitar salida de depuración (modo local)No-
--systemIncluir solo información del sistemaNo-
--repositoriesIncluir solo repositoriosNo-
--containersIncluir solo contenedoresNo-
--servicesIncluir solo serviciosNo-
--networkIncluir solo interfaces de redNo-
--block-devicesIncluir solo dispositivos de bloqueNo-
--licensesIncluir estados de licencias de repositoriosNo-
--storage-healthMostrar fragmentación BTRFS y ahorro reflink por repositorioNo-
--sync-certsTambién descargar la caché de certificados ACME de la máquina tras consultarNo-
--strictSalir con código distinto de cero (código 2) si algún contenedor ha superado el umbral de desviación de saludNo-

4.12 vault-status

Mostrar estado de bóveda analizada para una máquina

rdc machine vault-status [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-

4.13 repos

Listar repositorios implementados en una máquina

rdc machine repos [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-
--search <text>Filtrar repositorios por nombreNo-

4.14 test-connection

Probar conexión SSH a una máquina y capturar clave de host

rdc machine test-connection [options]
OpciónDescripciónObligatorioPredeterminado
--ip <address>Dirección IP de máquina o nombre de host-
--user <name>Nombre de usuario SSH-
-t, --team <name>Nombre de equipoNo-
-b, --bridge <name>Nombre de puenteNo-
--port <number>Puerto SSHNo22
--password <pwd>Contraseña SSH para autenticación inicialNo-
--datastore <path>Ruta de almacén de datos en máquinaNo/mnt/rediacc
-m, --machine <name>Nombre de máquina (para actualizar bóveda después de prueba)No-
--saveGuardar known_hosts en bóveda de máquina después de prueba exitosaNo-

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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--provider <name>Nombre del proveedor de nube (de config provider add)-
--region <region>Anular región predeterminadaNo-
--type <type>Anular tipo de instancia predeterminadoNo-
--image <image>Anular imagen de SO predeterminadaNo-
--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 --infraNo-
--no-infraOmitir configuración de infraestructura (proxy + DNS)No-
--debugHabilitar 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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--forceOmitir indicador de confirmaciónNo-
--debugHabilitar salida de depuración (modo local)No-

4.17 backup

Gestión de respaldos de máquina

list

Listar estrategias de respaldo vinculadas a todas las máquinas

rdc machine backup list

schedule

Desplegar programación de respaldos en una máquina remota (temporizadores systemd)

rdc machine backup schedule [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--dry-runPrevisualizar unidades generadas sin desplegarNo-
--forceContinuar aunque haya una copia de seguridad en ejecución (la nueva unidad se aplica en el siguiente tick del temporizador; la ejecución en curso conserva su unidad anterior)No-
--reset-failedBorrar el estado de fallo en los servicios modificados tras un despliegue exitoso (desactivado por defecto, preserva la señal de fallo)No-
--debugHabilitar salida de depuración (modo local)No-

now

Ejecutar un respaldo inmediatamente en una máquina remota

rdc machine backup now [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--strategy <name>Nombre de estrategia (ejecuta todas si se omite)No-
--debugHabilitar salida de depuración (modo local)No-

status

Mostrar estado de respaldo y estado del temporizador en una máquina remota

rdc machine backup status [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--strategy <name>Mostrar detalles de una estrategia específicaNo-
--debugHabilitar salida de depuración (modo local)No-

cancel

Cancelar un respaldo en ejecución en una máquina remota

rdc machine backup cancel [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-
--strategy <name>Nombre de estrategia (cancela todas si se omite)No-
--debugHabilitar 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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--dry-runMostrar lo que se eliminaría sin realizar cambiosNo-
--orphaned-reposTambién eliminar imágenes de repositorios que no están en ninguna configuraciónNo-
--prune-unknownElimina solo repos que el espejo renet .interim/state no puede clasificar (no en configuración local Y sin espejo marcado como fork). Estrictamente más estrecho que --orphaned-repos: los forks sin configuración se preservan cuando el espejo los identifica. Huérfanos heredados pre-espejo y grands obsoletos cuya entrada de configuración fue eliminada caen ambos en esta categoría.No-
--force-delete-mountedAnula la verificación de seguridad de montaje y elimina repos incluso si están actualmente montados o tienen contenedores Docker en ejecución. Distinto de --force (que solo anula el período de gracia del archivo). Aplica tanto a --orphaned-repos como a --prune-unknown.No-
--forceOmitir indicadores de confirmaciónNo-
--grace-days <days>Período de gracia en días para repositorios archivados recientemente (predeterminado: 7)No-
--debugHabilitar 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ónDescripciónObligatorioPredeterminado
--config <name>Nombre de configuración a usar para todos los comandosNo-
--timeout <ms>Tiempo de espera predeterminado de comando en milisegundosNo120000
--allow-grandPermitir operaciones destructivas en repositorios grand (no fork). Predeterminado: modo solo forkNo-

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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
-m, --machine <name>Nombre de la máquina de destino-
--checkpointRestaurar desde checkpoint después de montarNo-
--no-dockerOmitir el inicio del demonio Docker después del montajeNo-
--parallelIniciar repositorios de forma concurrenteNo-
--concurrency <n>Máximo de repositorios concurrentes (predeterminado: 3)No3
-y, --yesOmitir confirmación para operaciones por lotesNo-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.2 unmount

Desmontar un repositorio

rdc repo unmount [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
-m, --machine <name>Nombre de la máquina de destino-
--checkpointCrear checkpoint antes de desmontarNo-
--parallelIniciar repositorios de forma concurrenteNo-
--concurrency <n>Máximo de repositorios concurrentes (predeterminado: 3)No3
-y, --yesOmitir confirmación para operaciones por lotesNo-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.3 up

Desplegar o actualizar un repositorio (montar, iniciar servicios)

rdc repo up [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
-m, --machine <name>Nombre de la máquina de destino-
--skip-checkpointOmitir restauración de checkpoint CRIU aunque existan datos de checkpoint (forzar inicio limpio)No-
--tlsSolicitar certificado TLS dedicado para este repositorio (los forks usan el certificado compartido de la máquina por defecto)No-
--include-forksTambién montar/iniciar repositorios bifurcadosNo-
--mount-onlySolo montar, no iniciar serviciosNo-
--parallelIniciar repositorios de forma concurrenteNo-
--concurrency <n>Máximo de repositorios concurrentes (predeterminado: 3)No3
-y, --yesOmitir confirmación para operaciones por lotesNo-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-
--dry-runMostrar lo que se haría sin realizar cambiosNo-

6.4 up-all

Desplegar todos los repositorios en una máquina

rdc repo up-all

6.5 down

Detener servicios del repositorio

rdc repo down [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
-m, --machine <name>Nombre de la máquina de destino-
--unmountDesmontar repositorio después de detenerNo-
--checkpointCrear checkpoint CRIU antes de detener (guardar estado de memoria de procesos para restaurar luego via 'repo up')No-
-y, --yesOmitir confirmación para operaciones por lotesNo-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-
--dry-runMostrar lo que se haría sin realizar cambiosNo-

6.6 status

Obtener estado del repositorio

rdc repo status [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.7 list

Listar repositorios en una máquina

rdc repo list [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de la máquina de destino-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.8 create

Crear un nuevo repositorio cifrado

rdc repo create [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--size <size>Tamaño del repositorio (ej. 10G, 100G, 1T)-
--no-dockerOmitir el inicio del demonio Docker después de la creaciónNo-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--archive-configMover entrada de configuración a deletedRepositories para recuperación posteriorNo-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-
--dry-runMostrar lo que se haría sin realizar cambiosNo-

6.10 fork

Crear un fork CoW (Copy-on-Write) de un repositorio

rdc repo fork [options]
OpciónDescripciónObligatorioPredeterminado
--parent <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--tag <name>Etiqueta para el fork (crea nombre:etiqueta)-
--checkpointCrear checkpoint CRIU en el origen antes de fork (capturar estado de memoria de procesos para restaurar en el fork)No-
--upMontar e iniciar servicios después de fork (fork + mount + up en un solo comando)No-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--forceOmitir advertencias de modificaciónNo-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.12 resize

Redimensionar un repositorio sin conexión (soporta expandir y reducir)

rdc repo resize [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--size <size>Nuevo tamaño del repositorio (ej. 10G, 100G, 1T)-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.13 expand

Expandir un repositorio montado en línea (sin tiempo de inactividad)

rdc repo expand [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--size <size>Nuevo tamaño del repositorio (ej. 10G, 100G, 1T)-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.14 validate

Validar la integridad del repositorio

rdc repo validate [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.15 autostart

Gestionar el inicio automático de repositorios al arrancar

enable

Habilitar inicio automático para un repositorio

rdc repo autostart enable [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
-m, --machine <name>Nombre de la máquina de destino-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

disable

Deshabilitar inicio automático para un repositorio

rdc repo autostart disable [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
-m, --machine <name>Nombre de la máquina de destino-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

list

Listar repositorios con inicio automático habilitado

rdc repo autostart list [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de la máquina de destino-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.16 ownership

Cambiar propiedad del directorio del repositorio

rdc repo ownership [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
--uid <uid>UID del propietario (predeterminado: 7111)No-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.17 template

Aplicar una plantilla a un repositorio

list

Listar todas las plantillas de despliegue integradas en la 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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de la máquina de destino-
-r, --repository <name>Nombre de repositorio (conecta a entorno de repositorio)-
--file <path>Ruta al archivo de plantilla JSONNo-
--grand <name>Nombre del repositorio Grand (se resuelve automáticamente a GUID)No-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
--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 existeNo-
--checkpointCrear checkpoint CRIU antes del respaldo (captura el estado de memoria del proceso para migración en vivo)No-
--forceForzar sobrescritura del respaldo existenteNo-
--upDespués del envío, montar y desplegar el repositorio en la máquina de destinoNo-
--tag <tag>Etiqueta de despliegue para versionamientoNo-
-m, --machine <name>Nombre de máquina-
-w, --watchObservar cambiosNo-
--parallelIniciar repositorios de forma concurrenteNo-
--concurrency <n>Máximo de repositorios concurrentes (predeterminado: 3)No3
-y, --yesOmitir confirmación para operaciones por lotesNo-
--bwlimit <limit>Límite de ancho de banda para transferencia rsync (ej: "6M", "10M")No-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recursoNo-
--from <remote>Nombre de la máquina o almacenamiento de origen (detectado automáticamente desde la configuración)No-
--from-machine <machine>No-
--forceForzar sobrescritura del repositorio existenteNo-
--upDespués de pull, montar y desplegar el repositorio en esta máquinaNo-
-m, --machine <name>Nombre de máquina-
-w, --watchObservar cambiosNo-
--parallelIniciar repositorios de forma concurrenteNo-
--concurrency <n>Máximo de repositorios concurrentes (predeterminado: 3)No3
-y, --yesOmitir confirmación para operaciones por lotesNo-
--bwlimit <limit>Límite de ancho de banda para transferencia rsync (ej: "6M", "10M")No-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.20 migrate

Migración en vivo de un repositorio de una máquina a otra con tiempo de inactividad mínimo. rsync en dos fases: transferencia masiva en ejecución, luego parada breve para sincronización delta. Soporta checkpoint CRIU para migración de memoria de procesos y aprovisionamiento automático de máquinas destino

rdc repo migrate [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--from <machine>Nombre de la máquina origen-
--to <machine>Nombre de la máquina de destino-
--provision <provider>Aprovisionamiento automático del destino vía proveedor cloud (ej: hetzner, linode)No-
--bwlimit <limit>Límite de ancho de banda para transferencia rsync (ej: 10M)No-
--checkpointMigración en vivo CRIU: capturar y restaurar estado de memoria de procesosNo-
--skip-dnsOmitir cambio de registros DNS después de la migraciónNo-
--debugHabilitar salida de depuración (modo local)No-

6.21 backup

Gestionar respaldos de repositorios

list

Listar respaldos disponibles en un remoto (máquina o almacenamiento)

rdc repo backup list [options]
OpciónDescripciónObligatorioPredeterminado
--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-
--path <subdir>Subdirectorio dentro de la raíz de almacenamiento. Cuando se omite, se listan y combinan hot/ y cold/.No-
-w, --watchObservar cambiosNo-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

6.22 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 push

pull

Descargar repositorios del almacenamiento en la nube (omitir nombre para descargar todos)

rdc repo sync pull

upload

Subir archivos a un repositorio

rdc repo sync upload [options]
OpciónDescripciónObligatorioPredeterminado
-t, --team <name>Nombre de equipoNo-
-m, --machine <name>Nombre de máquina-
-r, --repository <name>Nombre de repositorio (conecta a entorno de repositorio)No-
--local <paths...>Una o más rutas locales de archivo o directorio (predeterminado: directorio actual)No-
--remote <path>Ruta de subdirectorio remoto dentro del repositorioNo-
--remote-file <path>Ruta única de archivo remoto (relativa a la raíz del repositorio) como destino de subida. Mutuamente excluyente con --remote.No-
--mirrorModo espejo - eliminar archivos remotos no presentes localmenteNo-
--verifyVerificar archivos usando sumas de control después de sincronizaciónNo-
--confirmPrevisualizar cambios y solicitar confirmación antes de sincronizarNo-
--exclude <patterns...>Patrones a excluir de sincronizaciónNo-
--dry-runMostrar lo que se haría sin realizar cambiosNo-

download

Descargar archivos de un repositorio

rdc repo sync download [options]
OpciónDescripciónObligatorioPredeterminado
-t, --team <name>Nombre de equipoNo-
-m, --machine <name>Nombre de máquina-
-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 repositorioNo-
--remote-file <path>Ruta del archivo remoto en el repositorio (alternativa a --remote para transferencias de un solo archivo)No-
--mirrorModo espejo - eliminar archivos locales no presentes en remotoNo-
--verifyVerificar archivos usando sumas de control después de sincronizaciónNo-
--confirmPrevisualizar cambios y solicitar confirmación antes de sincronizarNo-
--exclude <patterns...>Patrones a excluir de sincronizaciónNo-
--dry-runMostrar lo que se haría sin realizar cambiosNo-

status

Verificar el estado de sincronización y comparar archivos locales/remotos

rdc repo sync status [options]
OpciónDescripciónObligatorioPredeterminado
-t, --team <name>Nombre de equipoNo-
-m, --machine <name>Nombre de máquina-
-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 repositorioNo-
--remote-file <path>Ruta del archivo remoto en el repositorio (alternativa a --remote para transferencias de un solo archivo)No-

6.23 snapshot

Gestionar instantáneas BTRFS en máquinas remotas

create

Crear una instantánea BTRFS de un repositorio

rdc repo snapshot create

list

Listar instantáneas en una máquina remota

rdc repo snapshot list

delete

Eliminar una instantánea de una máquina remota

rdc repo snapshot delete

6.24 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 [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquinaNo-
-r, --repository <name>Nombre de repositorio (conecta a entorno de repositorio)No-
-c, --container <name>Nombre del contenedor (detectado automáticamente si solo hay uno en ejecución)No-
--port <port>Puerto del contenedor remoto a reenviarNo-
--local <port>Puerto local (por defecto igual al puerto remoto)No-

6.25 secret

Manage per-repo secrets injected at deploy time. Two modes: env (REDIACC_SECRET_<KEY> via compose ${VAR} interpolation) and file (host tmpfs at /var/run/rediacc/secrets/<networkId>/<KEY>, mounted via Docker compose `secrets:` block). Secrets never enter the encrypted LUKS image, so forks inherit none — externals see the fork as a different principal.

get

Read a single secret. Returns a redacted stub (`<redacted:secret>:<digest8>`) under agent context regardless of policy.

rdc repo secret get [options]
OpciónDescripciónObligatorioPredeterminado
--name <repository>Nombre del repositorio (p. ej. mail, mail:staging). Sin etiqueta, por defecto :latest.-
--key <KEY>Clave secreta en UPPER_SNAKE_CASE (máx. 64 caracteres). Se expondrá como REDIACC_SECRET_<KEY> para el modo env o /run/secrets/<key> en contenedores para el modo file.-

list

Lista claves y modos de secreto (nunca valores, nunca digests).

rdc repo secret list [options]
OpciónDescripciónObligatorioPredeterminado
--name <repository>Nombre del repositorio (p. ej. mail, mail:staging). Sin etiqueta, por defecto :latest.-

set

Establecer o sobrescribir un secreto. Los forks no heredan; establece en el fork explícitamente. Bajo contexto de agente, requiere coincidencia de digest --current (estilo passwd).

rdc repo secret set [options]
OpciónDescripciónObligatorioPredeterminado
--name <repository>Nombre del repositorio (p. ej. mail, mail:staging). Sin etiqueta, por defecto :latest.-
--key <KEY>Clave secreta en UPPER_SNAKE_CASE (máx. 64 caracteres). Se expondrá como REDIACC_SECRET_<KEY> para el modo env o /run/secrets/<key> en contenedores para el modo file.-
--value <value>Valor del secreto. Pasa `-` para leer desde stdin (evita exposición en historial de shell).-
--mode <mode>Modo de entrega: 'env' (visible en entorno del contenedor, docker inspect) o 'file' (archivo tmpfs, nunca en env). Por defecto: file.Nofile
--current <value>SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write.No-
--rotate-secretReconocer rotación; omitir precondición --current (auditado como rotación). Usar al rotar intencionalmente sin verificar el valor anterior.No-

unset

Elimina un secreto. Bajo contexto de agente, requiere coincidencia de digest --current.

rdc repo secret unset [options]
OpciónDescripciónObligatorioPredeterminado
--name <repository>Nombre del repositorio (p. ej. mail, mail:staging). Sin etiqueta, por defecto :latest.-
--key <KEY>Clave secreta en UPPER_SNAKE_CASE (máx. 64 caracteres). Se expondrá como REDIACC_SECRET_<KEY> para el modo env o /run/secrets/<key> en contenedores para el modo file.-
--current <value>SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write.No-
--rotate-secretReconocer rotación; omitir precondición --current (auditado como rotación). Usar al rotar intencionalmente sin verificar el valor anterior.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ónDescripciónObligatorioPredeterminado
-t, --team <name>Nombre de equipoNo-
--search <text>Buscar en {{field}}No-
--sort <field>Ordenar por campoNo-
--descOrden descendenteNo-

7.2 create

Crear un nuevo proveedor de almacenamiento

rdc storage create [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-

7.3 rename

Renombrar un proveedor de almacenamiento

rdc storage rename [options]
OpciónDescripciónObligatorioPredeterminado
--current-name <name>Nombre actual del recurso-
--new-name <name>Nuevo nombre del recurso-
-t, --team <name>Nombre de equipoNo-

7.4 delete

Eliminar un proveedor de almacenamiento

rdc storage delete [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-t, --team <name>Nombre de equipoNo-
-f, --forceOmitir indicadores de confirmaciónNo-
--dry-runMostrar lo que se haría sin realizar cambiosNo-

7.5 vault

Gestión del almacén de almacenamiento (solo adaptador cloud)

rdc storage vault

7.6 browse

Explorar archivos en un sistema de almacenamiento

rdc storage browse [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
--path <subpath>Ruta del subdirectorio a listarNo

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 [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Máquina ejecutora: ejecuta las llamadas list/delete de rclone contra el almacenamiento. Requerida porque los clientes no se espera que tengan rclone instalado localmente; las credenciales de almacenamiento siguen viniendo de tu configuración local.-
--dry-runMostrar lo que se haría sin realizar cambiosNo-
--forceOmitir indicadores de confirmaciónNo-
--force-delete-mountedAnula la verificación de seguridad de montaje y elimina copias de seguridad en la nube incluso si el GUID origen está actualmente montado o tiene un contenedor en ejecución en la máquina ejecutora. Distinto de --force (que solo anula el período de gracia para repos archivados).No-
--grace-days <days>Período de gracia en días para repositorios archivados recientemente (predeterminado: 7)No-
--debugHabilitar salida de depuración (modo local)No-
--skip-router-restartOmitir reinicio del servidor de rutas tras actualización del binarioNo-

7.8 pull

Descargar un backup del almacenamiento en la nube a una máquina

rdc storage pull

8. 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ónDescripciónObligatorioPredeterminado
-t, --team <name>Nombre de equipoNo-
-m, --machine <name>Nombre de máquinaNo-
-r, --repository <name>Nombre de repositorio (conecta a entorno de repositorio)No-
-f, --folder <path>Ruta de carpeta remota a abrirNo-
--url-onlyImprimir URI de VS Code en lugar de lanzarNo-
-n, --new-windowAbrir en nueva ventana de VS CodeNo-
--skip-env-setupOmitir configuración de entorno remotoNo-
--insidersUsar configuración de VS Code InsidersNo-

8.2 list

Listar conexiones SSH de VS Code configuradas

rdc vscode list

8.3 cleanup

Eliminar configuraciones SSH de VS Code

rdc vscode cleanup [options]
OpciónDescripciónObligatorioPredeterminado
--allEliminar todas las configuraciones SSH de rediaccNo-
-c, --connection <name>Eliminar conexión específicaNo-

8.4 check

Verificar instalación y configuración de VS Code

rdc vscode check [options]
OpciónDescripciónObligatorioPredeterminado
--insidersUsar configuración de VS Code InsidersNo-

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ónDescripciónObligatorioPredeterminado
-t, --team <name>Nombre de equipoNo-
-m, --machine <name>Nombre de máquinaNo-
-r, --repository <name>Nombre de repositorio (conecta a entorno de repositorio)No-
-c, --command <cmd>Ejecutar un comando en lugar de shell interactivoNo-
--container <id>Conectarse a un contenedor Docker específicoNo-
--container-action <action>Acción de contenedor: terminal, logs, stats, execNo-
--log-lines <lines>Número de líneas de log a mostrar (predeterminado: 50)No-
--followSeguir salida de logsNo-
--externalForzar lanzamiento en ventana de terminal externaNo-
--reset-homeRestablecer la capa de inicio por repositorio para empezar de nuevoNo-

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ónDescripciónObligatorioPredeterminado
--systemRegistrar en todo el sistema (requiere privilegios de administrador)No-
--forceForzar re-registro incluso si ya está registradoNo-

10.2 unregister

Desregistrar el manejador de protocolo del sistema

rdc protocol unregister [options]
OpciónDescripciónObligatorioPredeterminado
--systemDesregistrar registro en todo el sistema (requiere privilegios de administrador)No-

10.3 status

Mostrar estado de registro del manejador de protocolo

rdc protocol status

10.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ónDescripciónObligatorioPredeterminado
--token <token>Token de autenticación-
-t, --team <name>Nombre de equipo-
-m, --machine <name>Nombre de máquina-
-r, --repository <name>Nombre de repositorio (conecta a entorno de repositorio)No-
-a, --action <action>Acción ({{actions}})Nodesktop
-p, --params <key=value...>Parámetros adicionalesNo-

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 run

11.2 trace

Rastrear una tarea (atajo para: queue trace)

rdc trace

11.3 cancel

Cancelar una tarea (atajo para: queue cancel)

rdc cancel

11.4 retry

Reintentar una tarea fallida (atajo para: queue retry)

rdc retry

12. 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ónDescripciónObligatorioPredeterminado
-t, --token <token>Token API (rdt_...)No-
--server <url>URL del servidor de cuentaNo-

12.2 logout

Eliminar el token de suscripción almacenado

rdc subscription logout

12.3 status

Mostrar estado de suscripción y licencia

rdc subscription status

12.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ónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-

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ónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-

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ónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-

repos

Actualizar licencias de repositorios por lotes en una máquina remota

rdc subscription refresh repos [options]
OpciónDescripciónObligatorioPredeterminado
-m, --machine <name>Nombre de máquina-

repo

Actualizar la licencia del repositorio para un repositorio específico

rdc subscription refresh repo [options]
OpciónDescripciónObligatorioPredeterminado
--name <name>Nombre del recurso-
-m, --machine <name>Nombre de máquina-

13. Actualizaciones de CLI

Verificar y aplicar actualizaciones del CLI

rdc update [options]
OpciónDescripciónObligatorioPredeterminado
--forceForzar actualización aunque esté al díaNo-
--check-onlySolo verificar actualizaciones sin descargarNo-
--rollbackRevertir a la versión anteriorNo-
--statusMostrar estado y diagnósticos de actualización automáticaNo-
--channel <channel>Establecer canal de lanzamiento (stable o edge)No-

14. Diagnóstico del sistema

Diagnosticar el entorno CLI y la integración de renet

rdc doctor

15. 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ónDescripciónObligatorioPredeterminado
--forceForzar reinicio de todas las VMNo-
--parallelCrear VM en paraleloNo-
--basicClúster mínimo (puente + 1 trabajador)No-
--liteOmitir aprovisionamiento de VM (solo estado)No-
--skip-orchestrationOmitir orquestación del clústerNo-
--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-
--debugHabilitar salida de depuración (modo local)No-

15.2 down

Destruir clúster de VM

rdc ops down [options]
OpciónDescripciónObligatorioPredeterminado
--backend <backend>Backend de virtualización (kvm|qemu, detección automática)No-
--debugHabilitar salida de depuración (modo local)No-

15.3 status

Mostrar estado del clúster de VM

rdc ops status [options]
OpciónDescripciónObligatorioPredeterminado
--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 [options]
OpciónDescripciónObligatorioPredeterminado
--vm-id <id>ID de máquina virtual-
-c, --command <cmd>Ejecutar un comando en lugar de shell interactivoNo-
--backend <backend>Backend de virtualización (kvm|qemu, detección automática)No-
--user <user>Nombre de usuario SSH para conexión a VMNo-

15.5 setup

Instalar prerequisitos de virtualización

rdc ops setup [options]
OpciónDescripciónObligatorioPredeterminado
--debugHabilitar salida de depuración (modo local)No-

15.6 check

Verificar prerequisitos de virtualización

rdc ops check

Mensajes de Error Comunes

Cuando algo sale mal, la CLI proporciona mensajes de error claros:

ErroresSignificado
Se requiere autenticación. Ejecute: rdc auth loginNecesita iniciar sesión primero
Sin configuración activa. Cree una con: rdc config init --name <name>No hay configuración activa — cree una con `rdc config init`
Permiso denegadoSu 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   # default

Esto facilita la integración de la CLI de Rediacc en scripts, pipelines CI/CD y flujos de trabajo de automatización.