Saltar al contenido principal Saltar a navegación Saltar al pie de página

Hoja de referencia de RDC CLI

Referencia rápida de rdc: configuraciones, repositorios, máquinas, sincronización y contenedores. Conjunto completo de opciones: agregar --help a cualquier comando.

Hoja de referencia de RDC CLI

No se enumeran todos los comandos de rdc aquí, solo los que aparecen en cada despliegue. Para ver el conjunto completo de opciones, ejecuta cualquier comando de rdc con --help. Los casos especiales y las opciones raramente utilizadas se encuentran en la referencia completa.

Ciclo de vida del repositorio

ComandoDescripción
rdc repo create <repo> -m <machine>Crear un nuevo repositorio en una máquina
rdc repo up <repo>@<machine>Desplegar o actualizar un repositorio
rdc repo down <repo>@<machine>Detener un repositorio
rdc repo delete <repo>@<machine>Eliminar un repositorio
rdc repo fork <repo>@<machine> --tag <tag>Bifurcar un repositorio (casi instantáneo, BTRFS reflink)
rdc repo promote <repo>:<tag>Promover un fork validado a producción con el nombre del repositorio original
rdc repo listListar todos los repositorios con nombre y GUID
rdc repo resize <repo> --size <size>Cambiar el tamaño del volumen de un repositorio detenido
rdc repo expand <repo> --size <size>Ampliar el volumen de un repositorio en ejecución sin detenerlo

Secretos por repositorio

Credenciales de solo escritura en tiempo de despliegue. get devuelve solo el resumen. El valor nunca se devuelve. Consulta Repositorios § Secretos para la guía completa.

ComandoDescripción
rdc repo secret set <repo> --key <KEY> --value <val> [--mode env|file] --current ""Crear un nuevo secreto (--current "" para la primera escritura)
rdc repo secret set <repo> --key <KEY> --value <val> --current <prev>Sobrescribir un secreto existente (precondición de estilo contraseña)
rdc repo secret set <repo> --key <KEY> --value <val> --rotate-secretSobrescribir sin verificar el valor anterior (auditado como rotación)
rdc repo secret list <repo>Listar nombres de secretos y modos de entrega (nunca valores, nunca resúmenes)
rdc repo secret get <repo> --key <KEY>Mostrar resumen del secreto y modo (nunca valor en texto plano)
rdc repo secret unset <repo> --key <KEY> --current <prev>Eliminar un secreto
rdc repo secret unset <repo> --key <KEY> --rotate-secretEliminar sin verificar el valor anterior

Los forks no heredan secretos. Establécelos en el fork explícitamente con rdc repo secret set <repo>:<tag>.

Copia de seguridad y restauración

ComandoDescripción
rdc repo push ... --bwlimit <limit>Limitar el ancho de banda de rsync al subir (p. ej. 10M)
rdc repo pull ... --bwlimit <limit>Limitar el ancho de banda de rsync al bajar
rdc repo push ... --checkpointGuardar punto de control de contenedores antes de subir
rdc backup manifests <repo-ref>Listar los snapshots que contiene el almacenamiento fragmentado
rdc backup browse <repo-ref>Listar los archivos que contiene un repositorio (local, solo lectura)
rdc backup snapshot <repo>Subir un snapshot al almacenamiento fragmentado: inventario completo primero, celdas cambiadas después
rdc backup snapshot <repo> --dry-runPlanificar el snapshot sin subir; informa qué se movería
rdc backup verify <repo>Verificar el ancla de respaldo de un repositorio contra el almacenamiento fragmentado
rdc backup usageMostrar los bytes almacenados en el almacenamiento fragmentado frente a tu cuota
rdc backup manifests <repo>Listar los manifiestos de snapshot registrados en el servidor
rdc storage browse <storage>Explorar el contenido del almacenamiento

Migración de repositorios

ComandoDescripción
rdc repo migrate <repo>@<machine> --to <machine>Mover un repositorio entre máquinas
rdc repo migrate ... --provisionAprovisionar el destino antes de transferir
rdc repo migrate ... --checkpointGuardar punto de control antes de migrar
rdc repo migrate ... --skip-dnsOmitir la actualización de DNS tras la migración
rdc repo migrate ... --bwlimit <limit>Limitar el ancho de banda de transferencia

Estrategias de copia de seguridad

ComandoDescripción
rdc backup strategy set <name> --destination <storage> --cron <expr> --mode <hot|cold> --enableCrear o actualizar una estrategia de copia de seguridad con nombre
rdc backup strategy listListar todas las estrategias definidas
rdc backup strategy show <name>Mostrar los detalles de una estrategia
rdc backup strategy remove <name>Eliminar una estrategia
rdc backup schedule -m <machine>Desplegar estrategias de copia de seguridad configuradas en una máquina

Operaciones de copia de seguridad

ComandoDescripción
rdc backup schedule -m <machine>Desplegar las estrategias vinculadas como temporizadores de systemd
rdc backup schedule -m <machine> --dry-runPrevisualizar las unidades de temporizador sin desplegar (tokens enmascarados)
rdc backup run -m <machine>Ejecutar inmediatamente todas las estrategias vinculadas
rdc backup run <name> -m <machine>Ejecutar inmediatamente una estrategia específica
rdc backup status -m <machine>Mostrar el estado del temporizador y los resultados de los trabajos recientes
rdc backup status <name> -m <machine>Mostrar el estado de una estrategia específica
rdc backup cancel -m <machine>Cancelar las copias de seguridad en ejecución
rdc backup cancel <name> -m <machine>Cancelar una copia de seguridad en ejecución específica

Gestión de máquinas

ComandoDescripción
rdc machine status <machine>Estado completo de la máquina (sistema, contenedores, servicios, repos, red)
rdc machine status <machine> --systemSolo información del sistema
rdc machine status <machine> --containersSolo lista de contenedores
rdc machine status <machine> --repositoriesSolo lista de repositorios
rdc machine status <machine> --servicesSolo lista de servicios
rdc machine status <machine> --networkSolo información de red
rdc machine status <machine> --block-devicesSolo información de dispositivos de bloque
rdc machine listListar todas las máquinas en la configuración
rdc machine setup <machine>Ejecutar el aprovisionamiento inicial de la máquina
rdc machine health <machine>Comprobar el estado de una máquina
rdc machine scan-keys <machine>Actualizar las claves de host SSH tras una reconstrucción
rdc machine prune <machine>Eliminar recursos no utilizados de la máquina
rdc machine deprovision <machine>Desaprovisionar completamente una máquina

Terminal y sincronización

ComandoDescripción
rdc term connect <machine>Abrir terminal SSH a la máquina
rdc term connect <repo>@<machine>Abrir terminal SSH al repositorio (establece DOCKER_HOST)
rdc term connect <machine> -c "<command>"Ejecutar un comando en la máquina
rdc repo sync upload <repo>@<machine> --local <paths...>Subir uno o más archivos o directorios locales al repositorio
rdc repo sync upload <repo>@<machine> --local <file> --remote-file <path>Subir un único archivo local a una ruta remota específica
rdc repo sync download <repo>@<machine> --local <dir>Descargar un directorio del repositorio localmente
rdc repo sync download <repo>@<machine> --remote-file <path> --local <dir>Descargar un archivo remoto a un directorio local
rdc vscode connect <repo>@<machine>Abrir sesión VS Code Remote SSH
rdc vscode listListar las configuraciones SSH creadas por vscode connect
rdc vscode cleanup --allEliminar todas las configuraciones SSH escritas por vscode connect
rdc repo tunnel <repo> -c <container> --port <port>Reenviar un puerto de contenedor por SSH

Configuración

ComandoDescripción
rdc config init <name>Crear un archivo de configuración con nombre
rdc config listListar todas las configuraciones de esta máquina
rdc config set machine <alias>Apuntar un alias a otra máquina
rdc machine add <machine> --ip <host> --user <user>Agregar una máquina a la configuración
rdc storage import rclone.confImportar proveedores de almacenamiento desde la configuración de rclone
rdc storage listListar los proveedores de almacenamiento configurados
rdc backup strategy set ...Definir una estrategia de copia de seguridad con nombre
rdc --config <name> <command>Usar un archivo de configuración con nombre

Depuración y acceso directo

ComandoDescripción
rdc repo logs <repo>@<machine> -c <container> --lines 200 --followTransmitir los logs de un contenedor (preferido)
rdc repo exec <repo>@<machine> -c <container> -- <command>Ejecutar un comando en un contenedor (preferido)
rdc repo exec <repo>@<machine> -c <container> -i -- bashAbrir una shell interactiva en un contenedor
rdc term connect <repo>@<machine> -c "docker ps"Listar contenedores en un repositorio
rdc term connect <repo>@<machine> -c "docker logs <name>"Obtener los logs de un contenedor
rdc term connect <repo>@<machine> -c "docker exec <name> <cmd>"Ejecutar un comando en un contenedor
rdc term connect <repo>@<machine> -c "docker restart <name>"Reiniciar un contenedor