O comando rsync no Linux
Percebe a finalidade, lê a sintaxe e explora os exemplos antes de adaptares o comando ao teu sistema.
O que faz e quando utilizar
Simulação. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
Como escrever o comando
rsync [opções] origem ... destino
Os elementos entre [ ] são opcionais e as reticências indicam que um argumento pode repetir-se. Estes sinais explicam a estrutura: não são texto para escrever literalmente. Na secção seguinte encontras exemplos completos.
O nome rsync identifica a ferramenta ou o interno da shell. As opções ajustam o comportamento; os restantes argumentos indicam os dados, nomes ou caminhos usados na operação.
Exemplos explicados
Começa pelos exemplos de consulta. Quando uma operação altera dados ou configurações, lê o aviso e confirma os argumentos antes de a executar.
1. Simulação
Simulação. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avhn /origem/ /destino/2. Cópia local
Cópia local. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avh /origem/ /destino/3. Por SSH
Por SSH. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avz -e ssh /origem/ utilizador@servidor:/destino/4. Excluir cache
Excluir cache. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avh --exclude="cache/" /origem/ /destino/5. Mostrar progresso
Mostrar progresso. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avh --info=progress2 /origem/ /destino/6. Preservar ACL e xattrs
Preservar ACL e xattrs. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -aAXHv /origem/ /destino/7. Ver alterações
Ver alterações. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avhn --itemize-changes /origem/ /destino/8. Sincronizar com eliminação (simulação)
Sincronizar com eliminação (simulação). A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avhn --delete /origem/ /destino/9. Limitar banda
Limitar banda. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avh --bwlimit=5000 /origem/ /destino/10. Checksum
Checksum. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.
rsync -avhc /origem/ /destino/11. Sincroniza uma árvore preservando atributos e apaga no destino entradas…
Sincroniza uma árvore preservando atributos e apaga no destino entradas ausentes da origem por causa de --delete.
--delete elimina dados no destino. Experimenta primeiro com --dry-run e confirma o sentido da sincronização.
rsync -rogpav --delete /home/ /tmp/copia-home/12. Sincroniza uma pasta local para outra máquina através de SSH, com…
Sincroniza uma pasta local para outra máquina através de SSH, com destino remoto explicitado na forma conta@servidor:caminho.
--delete elimina dados no destino. Experimenta primeiro com --dry-run e confirma o sentido da sincronização.
rsync -rogpav -e ssh --delete /home/ utilizador@servidor.example:/backup/home/13. Copia dados locais para um destino SSH com compressão e modo arquivo
Copia dados locais para um destino SSH com compressão e modo arquivo; a forma original estava incompleta.
--delete elimina dados no destino. Experimenta primeiro com --dry-run e confirma o sentido da sincronização.
rsync -az -e ssh --delete pasta/ utilizador@servidor.example:/backup/Como interpretar
Os nomes de ficheiros, pastas, contas e pacotes são exemplos: substitui-os por elementos que existam no teu ambiente. Não escrevas os símbolos < e > à volta de nomes, porque a shell pode interpretá-los como redireções.
14. Copia uma árvore remota para uma pasta local
Copia uma árvore remota para uma pasta local; a origem remota tem de estar antes do destino local.
--delete elimina dados no destino. Experimenta primeiro com --dry-run e confirma o sentido da sincronização.
rsync -az -e ssh --delete utilizador@servidor.example:/home/local/ pasta-local/Como interpretar
Os nomes de ficheiros, pastas, contas e pacotes são exemplos: substitui-os por elementos que existam no teu ambiente. Não escrevas os símbolos < e > à volta de nomes, porque a shell pode interpretá-los como redireções.
Erros frequentes e como os evitar
- Distingue as opções de consulta das opções que alteram dados. Confirma os argumentos do exemplo antes de aplicar a operação a dados reais.
- Nomes de contas, pacotes, dispositivos e caminhos são ilustrativos: têm de corresponder ao sistema onde vais trabalhar.
- A distribuição e a versão instalada podem ter opções diferentes. Uma opção com o mesmo nome noutro programa pode ter outro significado.
Uma forma de praticar
Escolhe um dos exemplos acima e identifica o programa, cada opção e os argumentos. Explica por palavras tuas qual deverá ser o resultado. Se faltar um ficheiro, pacote ou dispositivo, resolve primeiro esse requisito; não acrescentes privilégios apenas para tentar eliminar uma mensagem de erro.
Testa primeiro uma variante de consulta, usando ficheiros de ensaio quando fizer sentido. Compara o resultado com a explicação e só depois acrescenta outra opção, para perceberes o efeito de cada alteração.