Como configurar o Borg Prune e o Compact sem longas interrupções nas cópias de segurança

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Para evitar longos intervalos entre cópias de segurança do Borg, execute a limpeza de retenção após uma cópia de segurança bem-sucedida, mas agende a compactação do repositório com menos frequência e fora do período principal de cópias de segurança. O Borg 1.4 separa a eliminação de arquivos da recuperação física de espaço, pelo que não é necessário executar borg compact após cada borg prune.

Este guia destina-se ao modelo de comandos estável atual do Borg 1.4.x. O Borg 2 altera a semântica dos repositórios e dos arquivos em várias áreas, por isso verifique a versão instalada antes de copiar automatizações de outra versão principal.

Confirme a Versão do Borg e o Repositório

borg --version
borg info /mnt/backup/borg-repo
borg list /mnt/backup/borg-repo

A FAQ do Borg refere que o Borg utiliza um bloqueio para todo o repositório e que apenas um processo pode ter acesso de escrita de cada vez. Se uma compactação prolongada se sobrepuser à próxima cópia de segurança agendada, esta terá de aguardar pelo bloqueio ou falhará quando o tempo limite do bloqueio expirar.

Defina Primeiro a Retenção com uma Execução de Teste

borg prune é destrutivo para o histórico de arquivos. A documentação do prune do Borg recomenda vivamente que teste com --dry-run e --list.

borg prune   --dry-run   --list   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   /mnt/backup/borg-repo

Se um repositório contiver cópias de segurança de várias máquinas ou conjuntos de dados, o filtro de arquivos é essencial. Sem um filtro restritivo, o Borg 1.4 considera todos os arquivos do repositório como candidatos às mesmas regras de retenção.

Execute a Limpeza Apenas Depois de uma Cópia de Segurança Bem-sucedida

#!/bin/sh
set -eu
REPO=/mnt/backup/borg-repo
ARCHIVE='{hostname}-{now:%Y-%m-%d_%H-%M}'

borg create --stats "$REPO::$ARCHIVE" /srv/data

borg prune   --list   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   "$REPO"

Não faça a limpeza só porque o agendador foi acionado; faça-a porque uma nova cópia de segurança foi concluída com sucesso e a política de retenção já foi validada.

Compreenda por que razão a limpeza não liberta espaço imediatamente

Desde o Borg 1.2, a compactação está separada dos comandos normais de escrita no repositório. As notas do Borg sobre compactação separada explicam que a eliminação ou limpeza de arquivos não recupera imediatamente todo o espaço em disco do repositório.

borg create
    |
novo arquivo confirmado
    |
borg prune
    |
arquivos antigos removidos do conjunto de retenção
    |
borg compact
    |
espaço em segmentos não utilizados recuperado

Isto é útil para o agendamento, porque as cópias de segurança diárias não precisam de suportar o custo total de reescrever segmentos do repositório parcialmente utilizados.

Agende a Compactação com Menos Frequência do que a Limpeza

  • cópia de segurança: todas as noites;
  • limpeza: após cada cópia de segurança bem-sucedida ou algumas vezes por semana;
  • compactação: uma vez por semana, durante um período de pouca atividade;
  • verificação completa do repositório: numa agenda separada e menos frequente.
# Cópia de segurança diária + limpeza
0 1 * * * /usr/local/sbin/borg-backup

# Compactação semanal
0 4 * * 0 /usr/local/sbin/borg-compact

Se as cópias de segurança demorarem frequentemente várias horas, afaste mais a compactação ou use um temporizador com dependências explícitas.

Use o limiar predefinido do compact antes de forçar reescritas máximas

A atual documentação do compact define um limiar predefinido de 10%.

borg compact --progress /mnt/backup/borg-repo

Esse valor predefinido é um bom ponto de partida quando a prioridade é ter uma janela de manutenção curta. Evite usar automaticamente --threshold 0; este valor reescreve sempre que seja possível poupar espaço e pode ser consideravelmente mais lento num repositório grande.

Evite que as tarefas de manutenção coincidam com a cópia de segurança seguinte

Se uma tarefa puder legitimamente ter de esperar por outro processo do Borg, defina um tempo de espera limitado pelo bloqueio:

borg --lock-wait 1800 create   /mnt/backup/borg-repo::'{hostname}-{now}'   /srv/data

Não use um tempo de espera pelo bloqueio muito longo como substituto de um bom agendamento. Monitorize a hora efetiva de início e de fim da cópia de segurança.

Se vários clientes partilharem um repositório, escalone os respetivos agendamentos. As perguntas frequentes do Borg referem que vários repositórios podem reduzir a contenção pelo bloqueio quando a deduplicação entre clientes não é importante.

Use as estatísticas rápidas quando os relatórios tornam o prune mais lento

O Borg 1.4.5 adicionou --quick-stats aos comandos create, delete e prune, evitando estatísticas mais lentas de todo o repositório quando não são necessárias.

borg prune   --quick-stats   --keep-daily 7   --keep-weekly 4   --keep-monthly 6   --glob-archives '{hostname}-*'   /mnt/backup/borg-repo

Mantenha espaço livre disponível antes de precisar do compact

Não espere até o sistema de ficheiros do repositório ficar sem espaço livre. O Borg não consegue executar de forma fiável as operações normais de escrita no repositório num sistema de ficheiros completamente cheio.

df -h /mnt/backup
borg info /mnt/backup/borg-repo

Para um plano mais abrangente de cópias de segurança do NAS, o guia de cópias de segurança 3-2-1 do ZimaOS é um lembrete útil de que a retenção do repositório é apenas uma das camadas do planeamento de cópias de segurança.

Valide o agendamento antes de confiar nele

  • Cada cópia de segurança criou um novo arquivo?
  • O prune só foi executado após cópias de segurança bem-sucedidas?
  • O conjunto de retenção correspondeu ao plano de execução simulada?
  • O compact semanal terminou antes da cópia de segurança seguinte?
  • O espaço livre aumentou após o compact?
  • Alguma tarefa passou inesperadamente muito tempo à espera do bloqueio do Borg?

Se o compact coincidir repetidamente com a cópia de segurança seguinte, reduza a frequência de compactação, mantenha o limiar predefinido, agende o compact para uma janela mais tranquila ou divida cargas de trabalho sem relação entre repositórios separados.

Um padrão de manutenção do Borg com intervalos curtos

DIÁRIO
01:00  borg create
        |
        +-- sucesso --> borg prune
        |
        +-- falha --> manter os arquivos antigos, emitir um alerta

SEMANAL
04:00  borg compact

PERIÓDICO
        borg check
        testar o restauro de ficheiros selecionados

A regra central é simples: prune protege a política de retenção; compact recupera espaço de armazenamento; não têm de ser executados com a mesma frequência.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.