colmaris.fr/content/post/notes/borg/index.md

title	date	tags	draft	author	categories	toc
Borg	2025-05-23T09:14:36+02:00	100DaysToOffload	false	Colmaris	notes	true

Créer un dépôt distant

Ne pas oublié d'activité l'authentification par cléf pour SSH

borg init -e none ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant

• -e none : signifie que le dépôt n'est pas chiffré, pour chiffré le dépôt on utilisera l'options repokey

Créer une sauvegarde

borg create --verbose --stats --compression lz4  /repertoire/source ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant::nom-de-sauvegarde

Lister les sauvegardes

borg list ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant

Restaurer une sauvegarde

borg extract ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant::nom-de-la-sauvegarde-a-extraire /dossier/dextraction

Automatisation

Placer le script dans /etc/cron.daily/pour une sauvegarde quotidienne vers 5h du matin. On peut aussi utiliser les dossier cron.weeklyou cron.monthly par exemple.

#!/bin/bash

# Setting this, so the repo does not need to be given on the commandline:
export BORG_REPO=ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant

# See the section "Passphrase notes" for more infos.
#export BORG_PASSPHRASE=''

# some helpers and error handling:
info() { printf "\n%s %s\n\n" "$( date )" "$*" >&2; }
trap 'echo $( date ) Backup interrupted >&2; exit 2' INT TERM

info "Starting backup"

# Backup the most important directories into an archive named after
# the machine this script is currently running on:

borg create                         \
    --verbose                       \
    --filter AME                    \
    --list                          \
    --stats                         \
    --show-rc                       \
    --compression lz4               \
    --exclude-caches                \
    --exclude 'home/*/.cache/*'     \
    --exclude 'var/tmp/*'           \
                                    \
    ::'{hostname}-{now}'            \
    /dossier/a/sauvegarder          \
    /dossier/a/sauvegarder          \
    /dossier/a/sauvegarder                       

backup_exit=$?

info "Pruning repository"

# Use the `prune` subcommand to maintain 7 daily, 4 weekly and 6 monthly
# archives of THIS machine. The '{hostname}-*' matching is very important to
# limit prune's operation to this machine's archives and not apply to
# other machines' archives also:

borg prune                          \
    --list                          \
    --glob-archives '{hostname}-*'  \
    --show-rc                       \
    --keep-daily    7               \
    --keep-weekly   4               \
    --keep-monthly  12              \
    --keep-yearly   5

prune_exit=$?

# actually free repo disk space by compacting segments

info "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 ))

if [ ${global_exit} -eq 0 ]; then
    info "Backup, Prune, and Compact finished successfully"
elif [ ${global_exit} -eq 1 ]; then
    info "Backup, Prune, and/or Compact finished with warnings"
else
    info "Backup, Prune, and/or Compact finished with errors"
fi

exit ${global_exit}