sauvegardes/Plan Borg/README.md

274 lines
6.7 KiB
Markdown
Raw Normal View History

2023-01-15 01:10:38 +01:00
| Plan Borg |
| --------- |
# Introduction
2023-01-12 10:17:33 +01:00
Le plan Borg est une solution de sauvegarde basée sur Borgmatic.
2023-01-15 01:10:38 +01:00
[[_TOC_]]
# Installation d'un serveur de sauvegarde
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Ajouter les backports bullseye dans `/etc/apt/source.list` :
```
deb http://ftp.fr.debian.org/debian/ bullseye-backports main
```
2023-01-12 10:17:33 +01:00
Installer les paquets nécessaires :
```
2023-01-15 01:10:38 +01:00
apt install -t bullseye-backports borgmatic borgbackup
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Créer un utilisateur dédié `borg` :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
adduser --disabled-password --system --group --home /srv/borg/ --shell /bin/bash borg
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Créer des clés `ssh` pour l'utilisateur `borg` :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
su - borg
mkdir ~/.ssh
chmod go-rwx ~/.ssh
ssh-keygen -t ed25519
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Créer un dossier pour les scripts maison :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
mkdir -p ~borg/bin
2023-01-12 10:17:33 +01:00
```
2023-01-16 19:44:21 +01:00
Récupérer les scripts et modèles :
2023-01-12 10:17:33 +01:00
```
2023-01-16 19:44:21 +01:00
cd ~borg/
mkdir bin models
wget
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Créer les dossiers de configuration de Borgmatic :
```
mkdir -p /etc/borgmatic/ /etc/borgmatic.d/
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Définir dans `/etc/borgmatic/retention.yaml` les valeurs de rétentions communes :
```
keep_within: 14d
keep_daily: 7
keep_weekly: 12
keep_monthly: 11
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Définir dans `/etc/borgmatic/excludes` les patterns d'exclusion :
```
pp:var/cache/
pp:var/backups/vm/
pp:var/backups/borg/
fm:*/.gvfs
fm:*/.thumbnails
fm:*/.bkl-thumbnails
fm:*/Cache
fm:*/.cache
fm:*/cache
fm:*/cache2
fm:*/.davfs2
fm:*/.local/share/Trash
fm:*/lost+found
fm:*/sharedfs
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Définir une passphrase générique :
```
echo "XXXXXXXXXXXXXXXXXXXXXXXXXXX" > ~borg/.borg-passphrase
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Ajouter la ligne suivante dans `/root/.bashrc` (facilite la commande `borg` directe même si normalement on fait tout avec la commande `borgmatic`) :
```
export BORG_PASSCOMMAND="cat /srv/borg/.borg-passphrase"
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Créer un dossier dédié aux sauvegardes du plan Borg :
```
mkdir -p /var/backup/borg
chown borg /var/backup/borg
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Configurer le `cron` dans `/etc/cron.d/backups` :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
10 0 * * * borg /srv/borg/bin/dobackups >> /var/backups/borg/dobackups.log 2>&1
10 12 * * * borg /srv/borg/bin/doprune >> /var/backups/borg/doprune.log 2>&1
10 5 * * 0 borg /srv/borg/bin/dochecks >> /var/backups/borg/dochecks.log 2>&1
```
2023-01-15 01:21:07 +01:00
# Configurer la sauvegarde de la machine locale
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Créer une configuration pour la sauvegarde de la machine locale `/etc/borgmatic.d/sauvkipeu.yaml` :
```
cp /srv/borg/models/model-conf-local.yaml /etc/borgmatic.d/
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Vérifier que la configuration Borgmatic est valide :
```
validate-borgmatic-config
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Initialiser le dépôt de la machine locale :
```
/srv/borg/bin/doinit sauvkipeu
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Lancer la première sauvegarde locale (dure moins d'une minutes) :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
time /srv/borg/bin/dobackup-local
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Afficher les informations du dépôt :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
borgmatic -c /etc/borgmatic.d/sauvkipeu.yaml info
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Afficher la liste des sauvegardes du dépôt :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
borgmatic -c /etc/borgmatic.d/sauvkipeu.yaml list
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Afficher le contenu de la sauvegarde :
```
borgmatic -c /etc/borgmatic.d/sauvkipeu.yaml list --archive 2023-01-14T09:20
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Ajouter le lancement de la sauvegarde dans `/srv/borg/bin/dobackups` :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
/srv/borg/bin/dobackup-local
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:17:11 +01:00
# Configurer la sauvegarde d'une machine en remote
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
C'est le cas nominal. Le principe consiste à configurer le serveur de sauvegarde pour déclencher l'action de sauvegarde sur la machine à sauvegarder.
2023-01-15 01:17:11 +01:00
## Côté serveur de sauvegarde
2023-01-15 01:10:38 +01:00
Configurer Borgmatic dans `/etc/borgmatic.d/foo.bar.org.yaml` :
```
2023-01-16 19:44:21 +01:00
cp /srv/borg/models/model-conf-remote.yaml /etc/borgmatic.d/config.yaml
2023-01-15 01:10:38 +01:00
```
Modifier le chemin le chemin du dépôt :
2023-01-12 10:17:33 +01:00
```
repositories:
2023-01-15 01:10:38 +01:00
- /var/backups/borg/foo.bar.org.repo
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Créer le dossier du nouveau dépôt de sauvegarde :
```
/srv/borg/bin/doinit foo.bar.org
```
Ajouter un accès ssh restreint dans `/srv/borg/.ssh/authorized_keys` :
```
command="export BORG_PASSCOMMAND=/srv/borg/.borg-passphrase; borg serve --restrict-to-path /var/backups/borg/foo.bar.org.repo/ --restrict-to-repository /var/backups/borg/foo.bar.org.repo --append-only",restrict ssh-rsa AAAAZZZZZ admin666@foo.bar.org
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:17:11 +01:00
## Côté machine à sauvegarder
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Ajouter les backports bullseye dans `/etc/apt/source.list` :
```
deb http://ftp.fr.debian.org/debian/ bullseye-backports main
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Installer les paquets nécessaires :
```
apt install -t bullseye-backports borgmatic borgbackup
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Créer et peupler le dossier de configruation de Borgmatic :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
mkdir -p /etc/borgmatic
cd /etc/borgmatic
wget htpps://.../retention.yaml
wget htpps://.../Plan B/models/excludes
wget htpps://.../Plan B/models/model-conf-remote2.yaml /etc/borgmatic/config.yaml
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
Vérifier que la configuration Borgmatic est valide :
```
validate-borgmatic-config
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Configurer la passphrase dans `/etc/borgmatic/config.yaml` :
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:10:38 +01:00
encryption_passphrase: XXXXXXXXXXXXXX
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:17:11 +01:00
Ajouter la clé borg du serveur de sauvegarde dans `/home/admin666/.ssh/authorized_keys` :
2023-01-15 01:10:38 +01:00
```
2023-01-15 01:17:11 +01:00
ssh-ed25519 AAAAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX borg@sauvkipeu.libre-en-communs.org
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:17:11 +01:00
## Tester côté serveur
2023-01-15 01:10:38 +01:00
Lancer une première sauvegarde :
```
time sudo /srv/borg/bin/dobackup-remote foo.bar.org
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Afficher les informations du dépôt :
```
borgmatic -c /etc/borgmatic.d/foo.bar.org.yaml info
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Afficher la liste des sauvegardes du dépôt :
```
borgmatic -c /etc/borgmatic.d/foo.bar.orgyaml list
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Afficher le contenu de la sauvegarde :
```
borgmatic -c /etc/borgmatic.d/foo.bar.org.yaml list --archive 2023-XX-XXTXX:XX
```
2023-01-12 10:17:33 +01:00
2023-01-15 01:10:38 +01:00
Ajouter le lancement de la sauvegarde dans `/srv/borg/bin/dobackups` :
```
/srv/borg/bin/dobackup-remote foo.bar.org
2023-01-12 10:17:33 +01:00
```
2023-01-15 01:19:33 +01:00
# Configurer la sauvegarde d'une machine en rsync
Le principe consiste en deux étapes :
- création d'un miroir de la machine à sauvegarder ;
- sauvegarde borgmatic du miroir.
C'est notamment adapté aux cas des routeurs où le logiciel Borgmatic n'est pas déployable.
## Côté serveur de sauvegarde
2023-01-15 01:31:48 +01:00
STU
2023-01-15 01:19:33 +01:00
## Côté machine à sauvegarder
2023-01-15 01:31:48 +01:00
STU
2023-01-15 01:19:33 +01:00
## Tester côté serveur
2023-01-15 01:31:48 +01:00
STU
# Sauver les bases de données
2023-01-16 19:44:21 +01:00
STU
# Notes pour les mises à jour futures
Actuellement :
```
root@sauvkipeu:/var/backups/borg# borgmatic --version
1.5.13.dev0
root@sauvkipeu:/var/backups/borg# borg -V
borg 1.1.16
```
Or :
- [Borgmatic releases](https://projects.torsion.org/borgmatic-collective/borgmatic/releases) : 1.7.5
- [Borg release](https://github.com/borgbackup/borg/releases) : 1.2.3
Donc des précautions sont à prévoir dans le futur. Normalement, commme l'usage fait est relativment basique, cela devrait avoir des impactes limités.
Pour Borgmatic :
- [1.7.0](https://projects.torsion.org/borgmatic-collective/borgmatic/releases/tag/1.7.0) :
- #571: Add "--list" as alias for "--files" flag on "create" and "export-tar" actions.
- [1.6.1](https://projects.torsion.org/borgmatic-collective/borgmatic/releases/tag/1.6.1) :
- #402: Remove the error when "archive_name_format" is specified but a retention prefix isn't.
-