Différences

Ci-dessous, les différences entre deux révisions de la page.

--- borgbackup [2025/07/05 20:07] – luc
+++ borgbackup [2025/09/12 12:12] (Version actuelle) – luc
@@ Ligne 31: / Ligne 31: @@
 borg create /path/to/repo::Monday ~/src ~/Documents
 # ici l'archive s'appelle Monday
+# options utiles :
+# --list : afficher la liste des fichiers sauvegardés
+# --show-rc : afficher le code de retour en dernier dans les logs, permet de récupérer via une variable bash ex: BACKUP=$?
+# --glob-archives : n'appliquer prune qu'aux archives qui match le pattern
+# --stats : affiche les stats de l'archive créée (et c'est vraiment bien)
+# --progress : affiche la progression de l'opération
 </code>
 Note : si le repo n'est pas initialisé, on aura une erreur. Pratique si on a un mount qui peut ne pas marcher : aucun risque de mettre des données n'importe où
@@ Ligne 37: / Ligne 44: @@
 === Consulter le repo / une archive ===
-''info'' et ''list''
+outils existent : ''info'' et ''list''
 <code bash>
@@ Ligne 58: / Ligne 65: @@
+=== Extraire des données ===
+<code bash>
+# extraire les données d'une archiveavec des chemins relatifs au dossier actuel
+cd /current/folder/
+borg extract /path/to/repo::archive-name
+# extraire seulement quelques fichiers
+# ?
+</code>
+=== Supprimer une archive ===
+<code bash>
+## --- delete ---
+# Supprimer l'archive, mais ne libère pas l'espace disque
+borg delete /path/to/repo::archive-name
+## --- compact ---
+# recupérer de l'espace disque en compactant les segments de fichiers (notamment des archives supprimées)
+borg compact /path/to/repo
+</code>
+Note : on peut aussi ''prune'' le repo, pour une suppression automatique d'archives selon des critères définis #stratégieDeSauvegarde
+<code bash>
+## --- prune ---
+borg prune --glob-archives 'pattern-*' --keep-daily 7 --keep-weekly 4 --keep-monthly 3 /path/to/repo/
+# --glob-archives : permet de restreindre la purge aux archives qui match le pattern
+</code>
+===== Exemple de script automatisé =====
+L'idée est d'automatiser le processus de backup, par exemple avec un script déclenché par un crontab
+<code bash>
+### backup_auto.sh
+#!/bin/sh
+# Ce script a pour vocation la sauvegarde d'un dossier en particulier dans un dossier SMB mount.
+# Le préfix "auto" sera mis en place, et ces backups seront concernés par les prunes / purges
+# Variable d'environnement pour accéder au repo
+export BORG_REPO=/path/to/repo/
+export BORG_PASSPHRASE=aAbBcCdDeE1234
+# nom de la sauvegarde : manual + date du jour
+NAME="auto_$(date +%Y-%m-%d%.H-%M)"
+# Create the backup
+echo "starting backup"
+borg create --list --stats --progress ::$NAME /folder/to/backup/*
+backup_exit=$?
+echo "borg exit = $backup_exit"
+# prune
+echo "Pruning repository"
+borg prune --list --glob-archives "auto_*" --show-rc --keep-daily 7 --keep-weekly 3 --keep-monthly 2
+# --show-rc : afficher le code de retour en dernier dans les logs
+# --glob-archives n'appliquer prune qu'aux archives qui match le pattern
+prune_exit=$?
+# compacting repository
+echo "compacting repository"
+borg compact
+compact_exit=$?
+# use highest exit code as global exit code
+global_exit=$(( backup_exit > prune_exit ? backup_exit : prune_exit ))
+global_exit=$(( compact_exit > global_exit ? compact_exit : global_exit ))
+echo "global exit = ${global_exit}"
+exit ${global_exit}
+</code>
+Il conviendrait de récupérer les info (echo) et les mettre dans un système de log, et de faire du reporting. Pour une prochaine fois !
+Exemple de script de sauvegarde automatisée avec monitoring (via un service comme healthchecks) :
+<code bash>
+#!/bin/sh
+# Ce script a pour vocation la sauvegarde d'un dossier en particulier dans un dossier SMB mount.
+# Le préfix "auto" sera mis en place, et ces backups seront concernés par les prunes / purges
+## Monitoring
+wget -O - https://healthchecks.example.com/ping/<uuid>/start
+OUTPUT_STATUS=0
+# Variable d'environnement pour accéder au repo
+export BORG_REPO=/path/to/repo/
+export BORG_PASSPHRASE=aAbBcCdDeE1234
+# nom de la sauvegarde : manual + date du jour
+NAME="auto_$(date +%Y-%m-%d%.H-%M)"
+# Create the backup
+borg create --list --stats --progress ::$NAME /folder/to/backup/*
+OUTPUT_STATUS=$(($OUTPUT_STATUS + $?))  # MONITORING
+# prune
+echo "Pruning repository"
+borg prune --list --glob-archives "auto_*" --show-rc --keep-daily 7 --keep-weekly 3 --keep-monthly 2
+# --list : afficher la liste des fichiers sauvegardés
+# --show-rc : afficher le code de retour en dernier dans les logs
+# --glob-archives n'appliquer prune qu'aux archives qui match le pattern
+OUTPUT_STATUS=$(($OUTPUT_STATUS + $?))  # MONITORING
+# compacting repository
+borg compact
+OUTPUT_STATUS=$(($OUTPUT_STATUS + $?))  # MONITORING
+# Monitoring - informer le serveur
+wget -O - https://healthchecks.example.com/ping/<uuid>/$OUTPUT_STATUS
+</code>