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 --help
Opciones Globales
Todos los comandos admiten estos flags globales:
| Opción | Descripción |
|---|---|
--output | Formato de salida (table|json|yaml|csv) |
--context | Usar contexto específico para este comando |
--lang | Anulación de idioma ({{languages}}) |
--force | Omitir indicadores de confirmación |
1. Autenticación
Comandos de autenticación
1.1 login
Autenticarse con Rediacc
rdc auth login [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-e, --email <email> | Dirección de correo electrónico | No | - |
-p, --password <password> | Contraseña (para inicio de sesión no interactivo) | No | - |
-m, --master-password <password> | Contraseña maestra para el cifrado de bóveda | No | - |
-n, --name <name> | Nombre de sesión | No | - |
--endpoint <url> | URL de punto final de API | No | - |
--save-as <context> | Guardar credenciales en un contexto con nombre | No | - |
1.2 logout
Borrar credenciales almacenadas
rdc auth logout
1.3 status
Verificar estado de autenticación actual
rdc auth status
1.4 register
Registrar una nueva organización y cuenta de usuario
Después del registro, revise su correo electrónico para obtener el código de activación.
rdc auth register [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--organization <name> | Nombre de organización | Sí | - |
-e, --email <email> | Dirección de correo electrónico | Sí | - |
-p, --password <password> | Contraseña (para inicio de sesión no interactivo) | Sí | - |
-m, --master-password <password> | Contraseña maestra para el cifrado de bóveda | No | - |
--endpoint <url> | URL de punto final de API | No | - |
--plan <plan> | Plan de suscripción (COMMUNITY, PROFESSIONAL, BUSINESS, ENTERPRISE) | No | COMMUNITY |
1.5 activate
Activar cuenta con código de verificación
rdc auth activate [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-e, --email <email> | Dirección de correo electrónico | Sí | - |
-p, --password <password> | Contraseña (para inicio de sesión no interactivo) | Sí | - |
--code <code> | Código de activación del correo electrónico | Sí | - |
--endpoint <url> | URL de punto final de API | No | - |
1.6 tfa
Gestión de autenticación de dos factores
disable
Desactivar autenticación de dos factores
rdc auth tfa disable [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--code <code> | Código 2FA actual para verificación | No | - |
-y, --yes | Omitir indicador de confirmación | No | - |
enable
Habilitar autenticación de dos factores
rdc auth tfa enable
status
Verificar estado de 2FA
rdc auth tfa status
1.7 token
Gestión de tokens
fork
Crear un token bifurcado para otra aplicación
rdc auth token fork [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-n, --name <name> | Nombre de token | No | CLI Fork |
-e, --expires <hours> | Expiración en horas (1-720) | No | 24 |
list
Listar tokens/sesiones activos
rdc auth token list
revoke
Revocar un token específico
rdc auth token revoke <requestId>
Consejo: Su token de autenticación se almacena localmente en su contexto. Use `--save-as` para almacenar credenciales bajo un contexto con nombre para múltiples entornos.
2. Gestión de Contexto
Gestionar contextos de CLI
Los contextos almacenan detalles de conexión (URL de API, credenciales, equipo/región/máquina predeterminados) para que pueda cambiar entre entornos rápidamente.
2.1 list
Listar todos los contextos
rdc context list
2.2 show
Mostrar detalles del contexto actual
rdc context show
2.3 use
Cambiar a un contexto diferente
rdc context use
2.4 create
Crear un nuevo contexto
rdc context create <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-u, --api-url <url> | URL de API | No | - |
2.5 delete
Eliminar un contexto
rdc context delete <name>
2.6 rename
Renombrar un contexto
rdc context rename <oldName> <newName>
2.7 current
Mostrar nombre del contexto actual
rdc context current
2.8 set
Establecer un valor por defecto (equipo, región, puente, máquina)
rdc context set <key> <value>
Consejo: Establecer valores predeterminados significa que no necesita pasar `--team`, `--region` o `--machine` con cada comando.
2.9 unset
Eliminar un valor por defecto de contexto
rdc context unset
2.10 clear
Borrar valores por defecto (todos o clave específica)
rdc context clear [key]
2.11 set-language
Establecer idioma preferido
rdc context set-language
2.12 create-local
Crear un nuevo contexto local para operación sin middleware
En modo local puede agregar máquinas directamente:
rdc context create-local <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--ssh-key <path> | Ruta a clave privada SSH (p. ej., ~/.ssh/id_rsa) | Sí | - |
--renet-path <path> | Ruta al binario renet (predeterminado: renet en PATH) | No | - |
2.13 add-machine
Agregar una máquina al contexto local actual
rdc context add-machine <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 |
2.14 remove-machine
Eliminar una máquina del contexto local actual
rdc context remove-machine <name>
2.15 machines
Listar máquinas en el contexto local actual
rdc context machines
2.16 set-ssh
Actualizar configuración SSH para el contexto local actual
rdc context set-ssh [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--private-key <path> | Ruta a clave privada SSH | Sí | - |
--public-key <path> | Ruta a clave pública SSH | No | - |
2.17 create-s3
Crear un nuevo contexto S3/R2 para estado remoto con ejecución local
rdc context create-s3 <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--endpoint <url> | URL del endpoint S3 | Sí | - |
--bucket <name> | Nombre del bucket S3 | Sí | - |
--access-key-id <key> | ID de clave de acceso S3 | Sí | - |
--ssh-key <path> | Ruta a clave privada SSH | Sí | - |
--secret-access-key <key> | Clave de acceso secreta S3 (se solicita si no se proporciona) | No | - |
--region <region> | Región S3 | No | auto |
--prefix <prefix> | Prefijo de clave/espacio de nombres en el bucket | No | - |
--renet-path <path> | Ruta al binario renet | No | - |
--master-password <password> | Contraseña maestra para cifrado (opcional, dejar vacío para omitir) | No | - |
2.18 set-renet
Establecer la ruta al binario renet para modo local
rdc context set-renet <path>
3. Gestión de Organización
Comandos de gestión de organización
3.1 list
Listar organizaciones
rdc organization list
3.2 info
Obtener información de organización
rdc organization info
3.3 dashboard
Obtener datos del panel de organización
rdc organization dashboard
3.4 vault
Gestión de bóveda de organización
get
Obtener datos de bóveda de organización
rdc organization vault get
list
Listar todos los tipos de bóveda
rdc organization vault list
update
Actualizar datos de bóveda de organización
rdc organization vault update [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--vault <json> | Contenido de bóveda como cadena JSON | No | - |
--vault-version <n> | Versión de bóveda actual para bloqueo optimista | No | - |
3.5 export
Exportar datos de organización
rdc organization export [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--path <path> | Ruta para guardar archivo de salida | No | - |
3.6 import
Importar datos de organización
rdc organization import <path> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--mode <mode> | Modo de importación (merge o replace) | No | merge |
3.7 maintenance
Habilitar o deshabilitar modo de mantenimiento (bloquea inicios de sesión que no sean de administrador)
rdc organization maintenance <action>
Advertencia: Cuando el modo de mantenimiento está habilitado, los usuarios no administradores no pueden iniciar sesión.
4. Gestión de Usuarios
Comandos de gestión de usuario
4.1 list
Listar todos los usuarios
rdc user list
4.2 create
Crear un nuevo usuario
rdc user create <email> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-p, --password <password> | Contraseña para el nuevo usuario | No | - |
4.3 activate
Activar una cuenta de usuario
rdc user activate <email> <activationCode>
4.4 deactivate
Desactivar una cuenta de usuario
rdc user deactivate <email> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-f, --force | Omitir indicadores de confirmación | No | - |
4.5 reactivate
Reactivar una cuenta de usuario desactivada
rdc user reactivate <email>
4.6 update-email
Cambiar dirección de correo electrónico de usuario
rdc user update-email <currentEmail> <newEmail>
4.7 update-password
Cambiar su contraseña
rdc user update-password [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--password <password> | Nueva contraseña (modo no interactivo) | No | - |
--confirm <confirm> | Confirmar contraseña (modo no interactivo) | No | - |
4.8 update-language
Establecer idioma preferido del usuario actual
rdc user update-language <language>
4.9 exists
Verificar si existe un usuario
rdc user exists <email>
4.10 vault
Gestión de bóveda de usuario
get
Obtener datos de bóveda de usuario actual
rdc user vault get
update
Actualizar datos de bóveda de usuario actual
rdc user vault update [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--vault <json> | Contenido de bóveda como cadena JSON | No | - |
--vault-version <n> | Versión de bóveda actual para bloqueo optimista | No | - |
4.11 permission
Gestión de permisos de usuario
assign
Asignar un grupo de permisos a un usuario
rdc user permission assign <userEmail> <groupName>
5. Gestión de Equipos
Gestión de equipo
5.1 list
Listar equipos
rdc team list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--search <text> | Buscar en {{field}} | No | - |
--sort <field> | Ordenar por campo | No | - |
--desc | Orden descendente | No | - |
5.2 create
Crear un equipo
rdc team create <name>
5.3 member
Gestión de membresía de equipo
list
Listar miembros del equipo
rdc team member list <teamName>
add
Agregar un usuario a un equipo
rdc team member add <teamName> <userEmail>
remove
Eliminar un usuario de un equipo
rdc team member remove <teamName> <userEmail>
6. Gestión de Permisos
Comandos de gestión de permisos
6.1 list
Listar permisos
rdc permission list
6.2 group
Gestión de grupo de permisos
list
Listar todos los grupos de permisos
rdc permission group list
create
Crear un nuevo grupo de permisos
rdc permission group create <name>
delete
Eliminar un grupo de permisos
rdc permission group delete <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-f, --force | Omitir indicadores de confirmación | No | - |
show
Mostrar detalles del grupo de permisos
rdc permission group show <name>
6.3 add
Agregar un permiso a un grupo
rdc permission add <groupName> <permission>
6.4 remove
Eliminar un permiso de un grupo
rdc permission remove <groupName> <permission>
7. Gestión de Regiones
Gestión de región
7.1 list
Listar regiones
rdc region list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--search <text> | Buscar en {{field}} | No | - |
--sort <field> | Ordenar por campo | No | - |
--desc | Orden descendente | No | - |
8. Gestión de Bridge
Gestión de puentes
8.1 list
Listar puentes
rdc bridge list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-r, --region <name> | Nombre de región | No | - |
--search <text> | Buscar en {{field}} | No | - |
--sort <field> | Ordenar por campo | No | - |
--desc | Orden descendente | No | - |
8.2 reset-auth
Restablecer token de autorización de puente
rdc bridge reset-auth <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-r, --region <name> | Nombre de región | No | - |
9. Gestión de Máquinas
Gestión de máquinas
9.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 | - |
9.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 | - |
9.3 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 | - |
9.4 update
Actualizar configuración de máquina
rdc machine update
9.5 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 | - |
9.6 containers
Listar contenedores Docker 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 | - |
9.7 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 | - |
9.8 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 | - |
9.9 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 | - |
9.10 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.
10. Gestión de Repositorios
Comandos de gestión de repositorio
10.1 list
Listar repositorios
rdc repository list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
10.2 create
Crear un nuevo repositorio
rdc repository create <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--tag <tag> | Etiqueta de repositorio | No | latest |
--parent <name> | Repositorio padre (para ramas) | No | - |
--parent-tag <tag> | Etiqueta de repositorio padre | No | - |
10.3 rename
Renombrar un repositorio
rdc repository rename <oldName> <newName> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--tag <tag> | Etiqueta de repositorio | No | latest |
10.4 delete
Eliminar un repositorio
rdc repository delete <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--tag <tag> | Etiqueta de repositorio | No | latest |
-f, --force | Omitir indicadores de confirmación | No | - |
10.5 promote
Promover una rama a estado maestro
rdc repository promote <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--tag <tag> | Etiqueta de repositorio | No | latest |
-f, --force | Omitir indicadores de confirmación | No | - |
Nota: Promover un fork lo separa de su repositorio padre (grand), haciéndolo independiente.
10.6 vault
Gestión de bóveda de repositorio
get
Obtener datos de bóveda de repositorio
rdc repository vault get <repositoryName> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--tag <tag> | Etiqueta de repositorio | No | latest |
update
Actualizar datos de bóveda de repositorio
rdc repository vault update <repositoryName> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--tag <tag> | Etiqueta de repositorio | No | latest |
--vault <json> | Contenido de bóveda como cadena JSON | No | - |
--vault-version <n> | Versión de bóveda actual para bloqueo optimista | No | - |
11. Gestión de Almacenamiento
Gestión de almacenamiento
11.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 | - |
12. Operaciones de Cola
Gestión de cola
El sistema de colas es el corazón de la ejecución de tareas de Rediacc. Cada operación (despliegue, respaldo, ejecución de scripts) pasa por la cola.
12.1 list
Listar elementos de cola
rdc queue list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-t, --team <name> | Nombre de equipo | No | - |
--status <status> | Filtrar por estado | No | - |
--priority-min <n> | Prioridad mínima (1-5) | No | - |
--priority-max <n> | Prioridad máxima (1-5) | No | - |
--search <text> | Buscar en ID de tarea, equipo, máquina, puente | No | - |
--sort <field> | Ordenar por campo | No | - |
--desc | Orden descendente | No | - |
--limit <n> | Número máximo de resultados | No | 50 |
12.2 create
Crear un elemento de cola
rdc queue create [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-f, --function <name> | Nombre de función a ejecutar | Sí | - |
-t, --team <name> | Nombre de equipo | No | - |
-m, --machine <name> | Nombre de máquina | No | - |
-b, --bridge <name> | Nombre de puente | No | - |
-p, --priority <1-5> | Prioridad (1=más alta) | No | 3 |
--param <key=value> | Parámetros de función | No | - |
--vault <json> | JSON de bóveda sin procesar (para scripts/CI) | No | - |
12.3 cancel
Cancelar un elemento de cola
rdc queue cancel <taskId>
12.4 retry
Reintentar un elemento de cola fallido
rdc queue retry <taskId>
12.5 trace
Rastrear ejecución de elemento de cola
rdc queue trace <taskId> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-w, --watch | Observar actualizaciones | No | - |
--interval <ms> | Intervalo de sondeo en milisegundos | No | 2000 |
Consejo: Use `--watch` para seguir la tarea en tiempo real hasta que se complete.
12.6 delete
Eliminar un elemento de cola
rdc queue delete <taskId> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-f, --force | Omitir indicadores de confirmación | No | - |
13. Sincronización de Archivos
Sincronización de archivos con repositorios usando rsync
13.1 upload
Cargar archivos a un repositorio
rdc sync upload [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 | - |
-l, --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 qué se transferiría sin sincronizar realmente | No | - |
13.2 download
Descargar archivos de un repositorio
rdc sync download [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 | - |
-l, --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 qué se transferiría sin sincronizar realmente | No | - |
13.3 status
Verificar estado de sincronización y comparar archivos locales/remotos
rdc sync status [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 | - |
-l, --local <path> | Ruta de directorio local (predeterminado: directorio actual) | No | - |
--remote <path> | Ruta de subdirectorio remoto dentro del repositorio | No | - |
14. Integración con VS Code
Integración de VS Code Remote SSH
14.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 | - |
14.2 list
Listar conexiones SSH de VS Code configuradas
rdc vscode list
14.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 | - |
14.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 | - |
15. Acceso Terminal SSH
Acceso a terminal SSH a máquinas y repositorios
15.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 | - |
16. Gestión de Almacenamiento Ceph
Gestión de almacenamiento distribuido Ceph
16.1 cluster
Gestión de clústeres Ceph
list
Listar clústeres Ceph
rdc ceph cluster list
create
Crear un nuevo clúster Ceph
rdc ceph cluster create <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--vault <content> | Contenido de bóveda como cadena JSON | No | - |
delete
Eliminar un clúster Ceph
rdc ceph cluster delete <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
-f, --force | Omitir indicadores de confirmación | No | - |
machines
Listar máquinas en un clúster Ceph
rdc ceph cluster machines <name>
vault
Gestión de bóveda del clúster Ceph
get:
Obtener datos de la bóveda del clúster
rdc ceph cluster vault get <name>
update:
Actualizar datos de la bóveda del clúster
rdc ceph cluster vault update <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--vault <content> | Contenido de bóveda como cadena JSON | Sí | - |
16.2 pool
Gestión de pools Ceph
list
Listar pools Ceph
rdc ceph pool list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--team <name> | Nombre de equipo | No | - |
--cluster <name> | Nombre de clúster Ceph | No | - |
create
Crear un nuevo pool Ceph
rdc ceph pool create <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--cluster <name> | Nombre de clúster Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
--vault <content> | Contenido de bóveda como cadena JSON | No | - |
delete
Eliminar un pool Ceph
rdc ceph pool delete <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--team <name> | Nombre de equipo | Sí | - |
-f, --force | Omitir indicadores de confirmación | No | - |
vault
Gestión de bóveda del pool Ceph
get:
Obtener datos de la bóveda del pool
rdc ceph pool vault get <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--team <name> | Nombre de equipo | Sí | - |
update:
Actualizar datos de la bóveda del pool
rdc ceph pool vault update <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--team <name> | Nombre de equipo | Sí | - |
--vault <content> | Contenido de bóveda como cadena JSON | Sí | - |
16.3 image
Gestión de imágenes RBD de Ceph
list
Listar imágenes RBD
rdc ceph image list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--pool <name> | Nombre de pool Ceph | No | - |
--team <name> | Nombre de equipo | No | - |
create
Crear una nueva imagen RBD
rdc ceph image create <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
--machine <name> | Nombre de máquina | Sí | - |
--vault <content> | Contenido de bóveda como cadena JSON | No | - |
delete
Eliminar una imagen RBD
rdc ceph image delete <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
-f, --force | Omitir indicadores de confirmación | No | - |
16.4 snapshot
Gestión de snapshots RBD de Ceph
list
Listar snapshots RBD
rdc ceph snapshot list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--image <name> | Nombre de imagen RBD | No | - |
--pool <name> | Nombre de pool Ceph | No | - |
--team <name> | Nombre de equipo | No | - |
create
Crear un nuevo snapshot RBD
rdc ceph snapshot create <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--image <name> | Nombre de imagen RBD | Sí | - |
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
--vault <content> | Contenido de bóveda como cadena JSON | No | - |
delete
Eliminar un snapshot RBD
rdc ceph snapshot delete <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--image <name> | Nombre de imagen RBD | Sí | - |
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
-f, --force | Omitir indicadores de confirmación | No | - |
16.5 clone
Gestión de clones RBD de Ceph
list
Listar clones RBD
rdc ceph clone list [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--snapshot <name> | Nombre de snapshot RBD | No | - |
--image <name> | Nombre de imagen RBD | No | - |
--pool <name> | Nombre de pool Ceph | No | - |
--team <name> | Nombre de equipo | No | - |
create
Crear un nuevo clon RBD desde snapshot
rdc ceph clone create <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--snapshot <name> | Nombre de snapshot RBD | Sí | - |
--image <name> | Nombre de imagen RBD | Sí | - |
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
--vault <content> | Contenido de bóveda como cadena JSON | No | - |
delete
Eliminar un clon RBD
rdc ceph clone delete <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--snapshot <name> | Nombre de snapshot RBD | Sí | - |
--image <name> | Nombre de imagen RBD | Sí | - |
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
-f, --force | Omitir indicadores de confirmación | No | - |
machines
Listar máquinas asignadas a un clon
rdc ceph clone machines <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--snapshot <name> | Nombre de snapshot RBD | Sí | - |
--image <name> | Nombre de imagen RBD | Sí | - |
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
assign
Asignar máquinas a un clon
rdc ceph clone assign <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--snapshot <name> | Nombre de snapshot RBD | Sí | - |
--image <name> | Nombre de imagen RBD | Sí | - |
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
--machines <names> | Nombres de máquinas (separados por coma) | Sí | - |
unassign
Eliminar máquinas de un clon
rdc ceph clone unassign <name> [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--snapshot <name> | Nombre de snapshot RBD | Sí | - |
--image <name> | Nombre de imagen RBD | Sí | - |
--pool <name> | Nombre de pool Ceph | Sí | - |
--team <name> | Nombre de equipo | Sí | - |
--machines <names> | Nombres de máquinas (separados por coma) | Sí | - |
17. Auditoría y Cumplimiento
Comandos de registro de auditoría
17.1 list
Listar entradas de registro de auditoría
rdc audit list
17.2 log
Ver registros de auditoría
rdc audit log [options]
| Opción | Descripción | Obligatorio | Predeterminado |
|---|---|---|---|
--limit <n> | Número máximo de resultados | No | 100 |
17.3 trace
Rastrear historial de auditoría para una entidad
rdc audit trace <entityType> <entityId>
17.4 history
Ver historial de entidad
rdc audit history <entityType> <entityId>
18. Manejador de Protocolo
Gestionar registro de manejador de protocolo {{scheme}}:// y manejo de URL
18.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 | - |
18.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 | - |
18.3 status
Mostrar estado de registro del manejador de protocolo
rdc protocol status
18.4 open
Abrir una URL {{scheme}}:// y ejecutar la acción
rdc protocol open <url>
18.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 | - |
18.6 parse
Analizar una URL {{scheme}}:// y mostrar componentes
rdc protocol parse <url>
19. Comandos Rápidos (Atajos)
19.1 run
Ejecutar una función (atajo para: queue create)
rdc run
19.2 trace
Rastrear una tarea (atajo para: queue trace)
rdc trace
19.3 cancel
Cancelar una tarea (atajo para: queue cancel)
rdc cancel
19.4 retry
Reintentar una tarea fallida (atajo para: queue retry)
rdc retry
20. 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 | - |
21. Diagnóstico del sistema
Diagnosticar el entorno CLI y la integración de renet
rdc doctor
Mensajes de Error Comunes
Cuando algo sale mal, la CLI proporciona mensajes de error claros:
| Error | Significado |
|---|---|
| Se requiere autenticación. Ejecute: rdc login | Necesita iniciar sesión primero |
| Sin contexto activo. Primero cree o seleccione un contexto. | No hay contexto seleccionado — cree o cambie a uno |
| Permiso denegado | Su cuenta no tiene los permisos requeridos |
| Nombre de máquina requerido. Use --machine o establezca contexto. | 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.