Folha de Consulta do CLI RDC
Nem todos os comandos rdc estão listados aqui, apenas os que surgem em todas as implementações. Para ver o conjunto completo de opções, execute qualquer comando rdc com --help. Casos extremos e opções raramente utilizadas estão na referência completa.
Ciclo de Vida do Repositório
| Comando | Descrição |
|---|---|
rdc repo create <repo> -m <machine> | Criar um novo repositório numa máquina |
rdc repo up <repo>@<machine> | Implementar ou atualizar um repositório |
rdc repo down <repo>@<machine> | Parar um repositório |
rdc repo delete <repo>@<machine> | Eliminar um repositório |
rdc repo fork <repo>@<machine> --tag <tag> | Fazer fork de um repositório (quase instantâneo, reflink BTRFS) |
rdc repo promote <repo>:<tag> | Promover um fork validado a produção com o nome do repositório original |
rdc repo list | Listar todos os repositórios com nome e GUID |
rdc repo resize <repo> --size <size> | Redimensionar o volume de um repositório parado |
rdc repo expand <repo> --size <size> | Expandir no próprio local o volume de um repositório em execução |
Segredos por Repositório
Credenciais de implantação apenas de escrita. get devolve apenas o digest. O valor nunca é devolvido. Consulte Repositórios § Segredos para o guia completo.
| Comando | Descrição |
|---|---|
rdc repo secret set <repo> --key <KEY> --value <val> [--mode env|file] --current "" | Criar um novo segredo (--current "" para a primeira escrita) |
rdc repo secret set <repo> --key <KEY> --value <val> --current <prev> | Substituir um segredo existente (precondição estilo passwd) |
rdc repo secret set <repo> --key <KEY> --value <val> --rotate-secret | Substituir sem verificar o valor anterior (registado como rotação) |
rdc repo secret list <repo> | Listar nomes de segredos e modos de entrega (nunca valores, nunca digests) |
rdc repo secret get <repo> --key <KEY> | Mostrar digest e modo do segredo (sem valor em texto simples, jamais) |
rdc repo secret unset <repo> --key <KEY> --current <prev> | Eliminar um segredo |
rdc repo secret unset <repo> --key <KEY> --rotate-secret | Eliminar sem verificar o valor anterior |
Os forks não herdam segredos. Defina-os no fork explicitamente com
rdc repo secret set <repo>:<tag>.
Backup e Restauro
| Comando | Descrição |
|---|---|
rdc repo push ... --bwlimit <limit> | Limitar a largura de banda rsync durante o envio (p. ex. 10M) |
rdc repo pull ... --bwlimit <limit> | Limitar a largura de banda rsync durante a receção |
rdc repo push ... --checkpoint | Criar checkpoint dos contentores antes de enviar |
rdc backup manifests <repo-ref> | Listar os snapshots guardados no armazenamento fragmentado |
rdc backup browse <repo-ref> | Listar os ficheiros contidos num repositório (local, só leitura) |
rdc backup snapshot <repo> | Enviar um snapshot para armazenamento fragmentado: inventário completo primeiro, células alteradas depois |
rdc backup snapshot <repo> --dry-run | Planear o snapshot sem enviar; relata o que se moveria |
rdc backup verify <repo> | Verificar a âncora de backup de um repositório face ao armazenamento fragmentado |
rdc backup usage | Mostrar os bytes armazenados no armazenamento fragmentado face à sua quota |
rdc backup restore <repo> --as <name> --at <snapshot-id> -m <machine> --up | Restaurar um snapshot do armazenamento em chunks com um novo nome |
rdc backup retention <repo> | Mostrar a política de retenção que o servidor impõe a uma linhagem de repositório |
rdc backup retention preview <repo> | Mostrar o que a próxima passagem apagaria e o espaço que liberta |
rdc backup retention set <repo> --keep-daily 7 [--stream <id>] | Declarar a retenção de uma linhagem ou de um fluxo de backup |
rdc backup retention clear <repo> [--stream <id>] | Remover a política; todos os snapshots são mantidos |
rdc backup snapshots delete <repo> <snapshot-id> | Apagar um snapshot; os seus dados exclusivos são libertados pelo GC seguinte |
Migração de Repositório
| Comando | Descrição |
|---|---|
rdc repo migrate <repo>@<machine> --to <machine> | Mover um repositório entre máquinas |
rdc repo migrate ... --provision | Provisionar no destino antes de transferir |
rdc repo migrate ... --checkpoint | Criar checkpoint antes de migrar |
rdc repo migrate ... --skip-dns | Ignorar atualização de DNS após migração |
rdc repo migrate ... --bwlimit <limit> | Limitar a largura de banda de transferência |
Estratégias de Backup
| Comando | Descrição |
|---|---|
rdc backup strategy set <name> --destination <name> --cron <expr> --mode <hot|cold> --enable | Criar ou atualizar uma estratégia de backup nomeada |
rdc backup strategy list | Listar todas as estratégias de backup definidas |
rdc backup strategy show <name> | Mostrar detalhes de uma estratégia |
rdc backup strategy remove <name> | Remover uma estratégia |
rdc backup schedule -m <machine> | Implementar estratégias de backup configuradas numa máquina |
Operações de Backup
| Comando | Descrição |
|---|---|
rdc backup schedule -m <machine> | Implementar estratégias associadas como temporizadores systemd |
rdc backup schedule -m <machine> --dry-run | Pré-visualizar unidades de temporizador sem implementar (tokens mascarados) |
rdc backup run -m <machine> | Executar todas as estratégias associadas imediatamente |
rdc backup run <name> -m <machine> | Executar uma estratégia específica imediatamente |
rdc backup status -m <machine> | Mostrar estado do temporizador e resultados de tarefas recentes |
rdc backup status <name> -m <machine> | Mostrar estado de uma estratégia específica |
rdc backup cancel -m <machine> | Cancelar backups em execução |
rdc backup cancel <name> -m <machine> | Cancelar um backup específico em execução |
Gestão de Máquinas
| Comando | Descrição |
|---|---|
rdc machine status <machine> | Estado completo da máquina (sistema, contentores, serviços, repositórios, rede) |
rdc machine status <machine> --system | Apenas informação do sistema |
rdc machine status <machine> --containers | Apenas lista de contentores |
rdc machine status <machine> --repositories | Apenas lista de repositórios |
rdc machine status <machine> --services | Apenas lista de serviços |
rdc machine status <machine> --network | Apenas informação de rede |
rdc machine status <machine> --block-devices | Apenas informação de dispositivos de bloco |
rdc machine list | Listar todas as máquinas na config |
rdc machine setup <machine> | Executar o provisionamento inicial da máquina |
rdc machine health <machine> | Verificar o estado de uma máquina |
rdc machine scan-keys <machine> | Atualizar as chaves de host SSH após uma reconstrução |
rdc machine prune <machine> | Remover recursos não utilizados da máquina |
rdc machine deprovision <machine> | Desprovicionar completamente uma máquina |
Terminal e Sincronização
| Comando | Descrição |
|---|---|
rdc term connect <machine> | Abrir terminal SSH para a máquina |
rdc term connect <repo>@<machine> | Abrir terminal SSH para o repositório (define DOCKER_HOST) |
rdc term connect <machine> -c "<command>" | Executar um comando na máquina |
rdc repo sync upload <repo>@<machine> --local <paths...> | Carregar um ou mais ficheiros/diretórios locais para o repositório |
rdc repo sync upload <repo>@<machine> --local <file> --remote-file <path> | Carregar um único ficheiro local para um caminho remoto explícito |
rdc repo sync download <repo>@<machine> --local <dir> | Transferir o diretório do repositório localmente |
rdc repo sync download <repo>@<machine> --remote-file <path> --local <dir> | Transferir um único ficheiro remoto para um diretório local |
rdc vscode connect <repo>@<machine> | Abrir sessão VS Code Remote SSH |
rdc vscode list | Listar as configurações SSH criadas por vscode connect |
rdc vscode cleanup --all | Remover todas as configurações SSH escritas por vscode connect |
rdc repo tunnel <repo> -c <container> --port <port> | Encaminhar a porta de um contentor via SSH |
Configuração
| Comando | Descrição |
|---|---|
rdc config init <name> | Criar um ficheiro de config nomeado |
rdc config list | Listar todas as configs nesta máquina |
rdc config set machine <alias> | Apontar um alias para outra máquina |
rdc machine add <machine> --ip <host> --user <user> | Adicionar uma máquina à config |
rdc backup strategy set ... | Definir uma estratégia de backup nomeada |
rdc --config <name> <command> | Usar um ficheiro de config nomeado |
Depuração e Saída de Emergência
| Comando | Descrição |
|---|---|
rdc repo logs <repo>@<machine> -c <container> --lines 200 --follow | Transmitir os registos de um contentor (preferido) |
rdc repo exec <repo>@<machine> -c <container> -- <command> | Executar um comando num contentor (preferido) |
rdc repo exec <repo>@<machine> -c <container> -i -- bash | Abrir uma shell interativa num contentor |
rdc term connect <repo>@<machine> -c "docker ps" | Listar contentores num repositório |
rdc term connect <repo>@<machine> -c "docker logs <name>" | Obter registos do contentor |
rdc term connect <repo>@<machine> -c "docker exec <name> <cmd>" | Executar comando num contentor |
rdc term connect <repo>@<machine> -c "docker restart <name>" | Reiniciar um contentor |