Comment configurer Borg prune et compact sans longues interruptions de sauvegarde

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Pour éviter de longs intervalles entre les sauvegardes Borg, lancez le nettoyage de rétention après une sauvegarde réussie, mais planifiez le compactage du dépôt moins souvent et en dehors de la principale plage de sauvegarde. Borg 1.4 sépare la suppression des archives de la récupération physique de l’espace ; il n’est donc pas nécessaire d’exécuter borg compact après chaque borg prune.

Ce guide s’appuie sur le modèle de commandes stable actuel de Borg 1.4.x. Borg 2 modifie la sémantique des dépôts et des archives dans plusieurs domaines ; vérifiez donc la version installée avant de copier des automatisations issues d’une autre version majeure.

Vérifiez la version de Borg et le dépôt

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

La FAQ de Borg indique que Borg utilise un verrou à l’échelle du dépôt et qu’un seul processus peut avoir un accès en écriture à la fois. Si un compactage prolongé chevauche la prochaine sauvegarde planifiée, celle-ci attendra la libération du verrou ou échouera à l’expiration du délai d’attente du verrou.

Définissez d’abord la rétention avec une simulation

borg prune a un effet destructeur sur l’historique des archives. La documentation de prune de Borg recommande vivement de tester avec --dry-run et --list.

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

Si un dépôt contient des sauvegardes provenant de plusieurs machines ou jeux de données, le filtre d’archives est essentiel. Sans filtre restrictif, Borg 1.4 considère toutes les archives du dépôt comme candidates aux mêmes règles de rétention.

Lancer le nettoyage uniquement après une sauvegarde réussie

#!/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"

Ne lancez pas le nettoyage simplement parce qu’une tâche planifiée s’est déclenchée ; lancez-le parce qu’une nouvelle sauvegarde s’est terminée avec succès et que la politique de rétention a déjà été validée.

Comprendre pourquoi le nettoyage ne libère pas l’espace immédiatement

Depuis Borg 1.2, le compactage est séparé des commandes normales d’écriture dans le dépôt. Les notes distinctes sur le compactage de Borg expliquent que la suppression ou le nettoyage des archives ne permet pas de récupérer immédiatement tout l’espace disque du dépôt.

borg create
    |
nouvelle archive créée
    |
borg prune
    |
anciennes archives supprimées de l’ensemble de rétention
    |
borg compact
    |
espace des segments inutilisés récupéré

Cette organisation est utile pour la planification, car les sauvegardes quotidiennes n’ont pas à supporter tout le coût de la réécriture des segments du dépôt partiellement utilisés.

Compacter moins souvent que nettoyer

  • sauvegarde : chaque nuit ;
  • nettoyage : après chaque sauvegarde réussie ou quelques fois par semaine ;
  • compactage : une fois par semaine pendant une période calme ;
  • vérification complète du dépôt : selon un calendrier distinct et moins fréquent.
# Sauvegarde quotidienne + nettoyage
0 1 * * * /usr/local/sbin/borg-backup

# Compactage hebdomadaire
0 4 * * 0 /usr/local/sbin/borg-compact

Si les sauvegardes durent souvent plusieurs heures, éloignez davantage le compactage ou utilisez un minuteur avec des dépendances explicites.

Utilisez le seuil par défaut de compact avant de forcer des réécritures maximales

La documentation actuelle sur compact définit un seuil de 10 % par défaut.

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

Cette valeur par défaut constitue un bon point de départ si vous privilégiez une courte fenêtre de maintenance. Évitez d’utiliser automatiquement --threshold 0 : cette option réécrit le dépôt dès qu’il est possible de récupérer de l’espace et peut être nettement plus lente sur un grand dépôt.

Évitez que la maintenance ne chevauche la sauvegarde suivante

Si une tâche peut légitimement attendre la fin d’un autre processus Borg, définissez un délai d’attente limité pour le verrou :

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

N’utilisez pas un délai d’attente très long pour le verrou comme substitut à une bonne planification. Surveillez les heures réelles de début et de fin des sauvegardes.

Si plusieurs clients partagent un dépôt, échelonnez leurs calendriers. La FAQ de Borg indique que plusieurs dépôts peuvent réduire les conflits de verrouillage lorsque la déduplication entre clients n’est pas importante.

Utilisez les statistiques rapides lorsque les rapports ralentissent prune

Borg 1.4.5 a ajouté --quick-stats aux commandes create, delete et prune, afin d’éviter les statistiques plus lentes à l’échelle de tout le dépôt lorsqu’elles ne sont pas nécessaires.

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

Gardez de l’espace libre avant d’en avoir besoin pour compact

N’attendez pas que le système de fichiers du dépôt soit à court d’espace libre. Borg ne peut pas effectuer de manière fiable les opérations habituelles d’écriture dans le dépôt lorsque le système de fichiers est complètement plein.

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

Pour un plan de sauvegarde NAS plus complet, le guide de sauvegarde 3-2-1 de ZimaOS rappelle utilement que la rétention du dépôt n’est qu’un volet de la conception d’une sauvegarde.

Valider le calendrier avant de lui faire confiance

  • Chaque sauvegarde a-t-elle créé une nouvelle archive ?
  • prune ne s’est-il exécuté qu’après la réussite des sauvegardes ?
  • L’ensemble de rétention correspondait-il au plan de simulation ?
  • Le compactage hebdomadaire s’est-il terminé avant la sauvegarde suivante ?
  • L’espace libre a-t-il augmenté après compact ?
  • Une tâche a-t-elle attendu le verrou Borg plus longtemps que prévu ?

Si compact chevauche régulièrement la sauvegarde suivante, réduisez la fréquence de compactage, conservez le seuil par défaut, déplacez compact vers une plage horaire plus calme ou répartissez les charges de travail sans lien entre elles dans des dépôts distincts.

Un modèle de maintenance Borg avec peu d’interruptions

QUOTIDIEN
01:00  borg create
        |
        +-- réussite --> borg prune
        |
        +-- échec --> conserver les anciennes archives, envoyer une alerte

HEBDOMADAIRE
04:00  borg compact

PÉRIODIQUE
        vérification de Borg
        fichiers sélectionnés pour le test de restauration

La règle fondamentale est simple : prune applique la politique de rétention ; compact récupère de l’espace de stockage ; ils n’ont pas besoin d’être exécutés à la même fréquence.

Assistance et conseils

À lire aussi

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.