117 lines
3.3 KiB
Markdown
117 lines
3.3 KiB
Markdown
---
|
|
title: "Borg"
|
|
date: 2025-05-23T09:14:36+02:00
|
|
tags:
|
|
- 100DaysToOffload
|
|
draft: false
|
|
author: "Colmaris"
|
|
toc: true
|
|
---
|
|
## Créer un dépôt distant
|
|
|
|
*Ne pas oublié d'activité l'authentification par cléf pour SSH*
|
|
|
|
```shell
|
|
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
|
|
|
|
```shell
|
|
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
|
|
|
|
```shell
|
|
borg list ssh://utilisateur@serveur:port/chemin/sur/le/dépôt/distant
|
|
```
|
|
|
|
## Restaurer une sauvegarde
|
|
|
|
```shell
|
|
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.weekly`ou `cron.monthly` par exemple.
|
|
|
|
```shell
|
|
#!/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}
|
|
```
|