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
| Comando | Descripció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 list | Listar 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.
| Comando | Descripció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-secret | Sobrescribir 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-secret | Eliminar 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
| Comando | Descripció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 ... --checkpoint | Guardar 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-run | Planificar 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 usage | Mostrar los bytes almacenados en el almacenamiento fragmentado frente a tu cuota |
rdc backup restore <repo> --as <name> --at <snapshot-id> -m <machine> --up | Restaurar un snapshot del almacenamiento fragmentado con un nombre nuevo |
rdc backup retention <repo> | Mostrar la política de retención que el servidor aplica a un linaje de repositorio |
rdc backup retention preview <repo> | Mostrar qué borraría la próxima pasada y cuánto espacio liberaría |
rdc backup retention set <repo> --keep-daily 7 [--stream <id>] | Declarar la retención de un linaje o de un flujo de backup |
rdc backup retention clear <repo> [--stream <id>] | Eliminar la política; se conservan todos los snapshots |
rdc backup snapshots delete <repo> <snapshot-id> | Borrar un snapshot; el siguiente GC libera sus datos exclusivos |
Migración de repositorios
| Comando | Descripción |
|---|---|
rdc repo migrate <repo>@<machine> --to <machine> | Mover un repositorio entre máquinas |
rdc repo migrate ... --provision | Aprovisionar el destino antes de transferir |
rdc repo migrate ... --checkpoint | Guardar punto de control antes de migrar |
rdc repo migrate ... --skip-dns | Omitir 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
| Comando | Descripción |
|---|---|
rdc backup strategy set <name> --destination <name> --cron <expr> --mode <hot|cold> --enable | Crear o actualizar una estrategia de copia de seguridad con nombre |
rdc backup strategy list | Listar 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
| Comando | Descripción |
|---|---|
rdc backup schedule -m <machine> | Desplegar las estrategias vinculadas como temporizadores de systemd |
rdc backup schedule -m <machine> --dry-run | Previsualizar 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
| Comando | Descripción |
|---|---|
rdc machine status <machine> | Estado completo de la máquina (sistema, contenedores, servicios, repos, red) |
rdc machine status <machine> --system | Solo información del sistema |
rdc machine status <machine> --containers | Solo lista de contenedores |
rdc machine status <machine> --repositories | Solo lista de repositorios |
rdc machine status <machine> --services | Solo lista de servicios |
rdc machine status <machine> --network | Solo información de red |
rdc machine status <machine> --block-devices | Solo información de dispositivos de bloque |
rdc machine list | Listar 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
| Comando | Descripció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 list | Listar las configuraciones SSH creadas por vscode connect |
rdc vscode cleanup --all | Eliminar 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
| Comando | Descripción |
|---|---|
rdc config init <name> | Crear un archivo de configuración con nombre |
rdc config list | Listar 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 backup strategy set ... | Definir una estrategia de copia de seguridad con nombre |
rdc --config <name> <command> | Usar un archivo de configuración con nombre |
Comentarios
| Comando | Descripción |
|---|---|
rdc feedback report --last | Vista previa de un informe creado a partir del comando fallido más reciente; añade --yes para enviarlo |
rdc feedback report --command <n> | Informar sobre un comando registrado (1 es el más reciente) |
rdc feedback report --list-recent | Listar los comandos registrados y salir |
rdc feedback report --message <text> [--kind bug|feedback|docs] | Enviar una nota sin un comando fallido |
rdc feedback list [--status <list>] | Listar informes con id, huella, estado y fechas; un informe corregido muestra fixed-in-v<version> |
rdc feedback show <id> | Mostrar un informe por id o prefijo único |
Depuración y acceso directo
| Comando | Descripción |
|---|---|
rdc repo logs <repo>@<machine> -c <container> --lines 200 --follow | Transmitir 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 -- bash | Abrir 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 |