So richtest du Borg Prune und Compact ein, ohne lange Sicherungslücken in Kauf zu nehmen

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Um lange Lücken zwischen Borg-Sicherungen zu vermeiden, führen Sie die Aufbewahrungsbereinigung nach einer erfolgreichen Sicherung aus, planen Sie die Repository-Kompaktierung jedoch seltener und außerhalb des Hauptsicherungszeitraums. Borg 1.4 trennt das Löschen von Archiven von der physischen Speicherplatzrückgewinnung. Daher muss borg compact nicht nach jedem borg prune ausgeführt werden.

Diese Anleitung bezieht sich auf das aktuelle Befehlsmodell der stabilen Version Borg 1.4.x. Borg 2 ändert in mehreren Bereichen die Semantik von Repositories und Archiven. Prüfen Sie daher die installierte Version, bevor Sie Automatisierungen aus einer anderen Hauptversion übernehmen.

Borg-Version und Repository bestätigen

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

Die Borg-FAQ weist darauf hin, dass Borg eine Sperre für das gesamte Repository verwendet und jeweils nur ein Prozess Schreibzugriff haben kann. Überschneidet sich eine lange Kompaktierung mit der nächsten geplanten Sicherung, wartet diese auf die Sperre oder schlägt fehl, wenn die Zeitüberschreitung für die Sperre erreicht ist.

Aufbewahrung zuerst mit einem Testlauf festlegen

borg prune verändert den Archivverlauf unwiderruflich. Die Prune-Dokumentation von Borg empfiehlt dringend, mit --dry-run und --list zu testen.

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

Wenn ein Repository Sicherungen mehrerer Computer oder Datensätze enthält, ist der Archivfilter unerlässlich. Ohne einen einschränkenden Filter berücksichtigt Borg 1.4 alle Archive im Repository als Kandidaten für dieselben Aufbewahrungsregeln.

Bereinigung nur nach einer erfolgreichen Sicherung ausführen

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

Führen Sie die Bereinigung nicht aus, nur weil ein Zeitplan ausgelöst wurde, sondern weil eine neue Sicherung erfolgreich abgeschlossen wurde und die Aufbewahrungsrichtlinie bereits geprüft wurde.

Single board computer zimaboard2

Verstehen, warum die Bereinigung nicht sofort Speicherplatz freigibt

Seit Borg 1.2 ist die Kompaktierung von den normalen Repository-Schreibbefehlen getrennt. Borgs separate Hinweise zur Kompaktierung erklären, dass durch das Löschen oder Bereinigen von Archiven nicht sofort der gesamte Repository-Speicherplatz freigegeben wird.

borg create
    |
Neues Archiv gespeichert
    |
borg prune
    |
Alte Archive aus dem Aufbewahrungssatz entfernt
    |
borg compact
    |
Speicherplatz in ungenutzten Segmenten zurückgewonnen

Das ist für die Zeitplanung hilfreich, da tägliche Sicherungen nicht die vollen Kosten für das Umschreiben teilweise genutzter Repository-Segmente verursachen müssen.

Kompaktierung seltener als Bereinigung planen

  • Sicherung: jede Nacht;
  • Bereinigung: nach jeder erfolgreichen Sicherung oder einige Male pro Woche;
  • Kompaktierung: einmal pro Woche während einer ruhigen Zeit;
  • Vollständige Repository-Prüfung: nach einem separaten, weniger häufigen Zeitplan.
# Tägliche Sicherung + Bereinigung
0 1 * * * /usr/local/sbin/borg-backup

# Wöchentlich compact
0 4 * * 0 /usr/local/sbin/borg-compact

Wenn Backups häufig mehrere Stunden dauern, verlegen Sie die Komprimierung weiter weg oder verwenden Sie einen Timer mit expliziten Abhängigkeiten.

Verwenden Sie den standardmäßigen Compact-Schwellenwert, bevor Sie maximale Neuschreibvorgänge erzwingen

Die aktuelle compact-Dokumentation verwendet standardmäßig einen Schwellenwert von 10 %.

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

Dieser Standardwert ist ein guter Ausgangspunkt, wenn Ihnen ein kurzes Wartungsfenster wichtig ist. Vermeiden Sie es, automatisch --threshold 0 zu verwenden; damit wird jedes Mal neu geschrieben, wenn sich Speicherplatz einsparen lässt, was bei einem großen Repository deutlich länger dauern kann.

Verhindern Sie, dass Wartungsarbeiten mit dem nächsten Backup kollidieren

Wenn ein Auftrag berechtigterweise auf einen anderen Borg-Prozess warten muss, legen Sie eine begrenzte Wartezeit auf die Sperre fest:

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

Verwenden Sie keine übermäßig lange Wartezeit auf Sperren als Ersatz für eine gute Zeitplanung. Überwachen Sie, wann das Backup tatsächlich startet und endet.

Wenn mehrere Clients dasselbe Repository nutzen, staffeln Sie ihre Zeitpläne. Laut der Borg-FAQ können mehrere Repositories Sperrkonflikte verringern, wenn die Deduplizierung über mehrere Clients hinweg nicht wichtig ist.

Verwenden Sie Quick Stats, wenn Berichte prune verlangsamen

Borg 1.4.5 ergänzte --quick-stats für create, delete und prune, wodurch langsamere repositoryweite Statistiken vermieden werden, wenn sie nicht benötigt werden.

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

Halten Sie freien Speicherplatz bereit, bevor Sie compact benötigen

Warten Sie nicht, bis das Dateisystem des Repositorys keinen freien Speicherplatz mehr hat. Borg kann normale Schreibvorgänge im Repository auf einem vollständig gefüllten Dateisystem nicht zuverlässig ausführen.

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

Als umfassendere Orientierung für einen NAS-Backupplan erinnert der 3-2-1-Backup-Leitfaden für ZimaOS daran, dass die Aufbewahrung im Repository nur eine Ebene der Backupplanung ist.

Zeitplan überprüfen, bevor Sie ihm vertrauen

  • Hat jedes Backup ein neues Archiv erstellt?
  • Wurde prune nur nach erfolgreichen Backups ausgeführt?
  • Entsprach die Aufbewahrungsmenge dem Probelaufplan?
  • War compact am Ende der Woche vor dem nächsten Backup abgeschlossen?
  • Hat sich der freie Speicherplatz nach compact erhöht?
  • Hat ein Auftrag unerwartet lange auf die Borg-Sperre gewartet?

Wenn compact wiederholt mit dem nächsten Backup kollidiert, verringern Sie die Häufigkeit der Komprimierung, behalten Sie den Standard-Schwellenwert bei, verlegen Sie compact in eine ruhigere Zeit oder teilen Sie nicht zusammenhängende Workloads auf separate Repositories auf.

Ein Borg-Wartungsmuster mit geringen Lücken

TÄGLICH
01:00  borg create
        |
        +-- Erfolg --> borg prune
        |
        +-- Fehler --> alte Archive behalten, Warnung ausgeben

WÖCHENTLICH
04:00  borg compact

REGELMÄSSIG
        borg check
        Ausgewählte Dateien wiederherstellen

Die Grundregel ist einfach: prune schützt die Aufbewahrungsrichtlinie; compact gibt Speicherplatz frei; sie müssen nicht gleich häufig ausgeführt werden.

Support und Tipps

Mehr zum Lesen

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.