From 92171df32f00ed94462bea012d7063c0768b7656 Mon Sep 17 00:00:00 2001 From: "Christian P. MOMON" Date: Sun, 29 Jan 2023 23:45:21 +0000 Subject: [PATCH 1/5] Update README.md --- Plan Borg/README.md | 110 +++++++++++++++++++++++++++----------------- 1 file changed, 69 insertions(+), 41 deletions(-) diff --git a/Plan Borg/README.md b/Plan Borg/README.md index 19d262a..c9543e8 100644 --- a/Plan Borg/README.md +++ b/Plan Borg/README.md @@ -5,6 +5,10 @@ Le plan Borg est une solution de sauvegarde basée sur Borgmatic. +Documentations : +- Borgmatic : https://torsion.org/borgmatic/docs/reference/command-line/ ; +- Borgbackups : https://borgbackup.readthedocs.io/en/stable/index.html (recommandation d'aller voir le sous-menu `Usage`). + [[_TOC_]] # Principes @@ -16,46 +20,45 @@ Quelques pré-requis : Organisation des fichiers côté serveur de sauvegarde : - /etc/borgmatic/ - - retention.yaml - - excludes -- /etc/borgmatic.d/ + - retention.yaml : paramétrage par défaut de la purge, par défaut inclus par les fichiers de configuration de `/etc/borgmatic.d`, + - excludes : pattern d'exclusion pour la sauvegarde du serveur de sauvegarde, +- /etc/borgmatic.d/ : configurations des sauvegardes, 1 fichier par machine pour permettre la personnalisation, - fqdn1.yaml - fqdn2.yaml - … -- /var/backups/borg/ - - dobackups.log - - dochecks.log - - doprunes.log - - fqdn1.repo - - fqdn2.repo +- /var/backups/borg/ : espace de stockage des sauvegardes + - dobackups.log : log des sauvegardes, + - dochecks.log : log des vériciations des sauvegardes, + - doprunes.log : log des purges des sauvegardes, + - fqdn1.repo : dépôt des sauvegardes de la machine fqdn1, + - fqdn2.repo : dépôt des sauvegardes de la machine fqdn2, - … -- /srv/borg/bin/ - - doreport : TODO - - dobackups - - doprunes - - dochecks - - countbackups - - dobackup-remote - - doinit - - doinit-remote - - doprunesb - - dochecksb - - doinit-rsync - - doinit-local - - dobackup-local - - lastbackups - - dobackup-rsync +- /srv/borg/bin/ : ensemble de scripts pour gérer les sauvegardes, + - doreport : génère un rapport sur les sauvegardes, + - dobackups : lance la sauvegarde de toutes les machines, appelé par `cron`, + - doprunes : lance la purge de chaque dépôt de sauvegarde, appelé par `cron`, + - dochecks : lance la vériciation de chaque dépôt de sauvegarde, appelé par `cron`, + - countbackups : affiche le nombre de sauvegardes pour chaque dépôt de sauvegarde, + - dobackup-remote : lance une sauvegarde en mode `remote`, c'est à dire par une commande `ssh`, + - doinit : créé un dépôt de sauvegarde dans `/var/backups/borg/`, + - doinit-remote : appelle `doinit` et créé le fichier de configuration associé, + - doinit-rsync : appelle `doinit` et créé le fichier de configuration associé, + - doinit-local : appelle `doinit` et créé le fichier de configuration associé pour le serveur de sauvegarde, + - dobackup-local : lance une sauvegarde du serveur de sauvegarde, + - lastbackups : affiche la dernière sauvegarde de chaque dépôt, + - dobackup-rsync : lance une sauvegarde en mode `rsync`, c'est à dire via un miroir (en cours), - /srv/borg/models/ - - cron - - excludes - - retention.yaml -- /srv/borg/.borg-passphrase -- /srv/borg/.ssh/ + - cron : modèle pour un fichier `cron`, + - excludes : modèle pour l'exclusion par défaut pendant les sauvegardes, + - retention.yaml : modèle pour le paramétrage par défaut des purges, +- /srv/borg/.borg-passphrase : passphrase des dépôts, +- /srv/borg/.ssh/ : + - authorized_keys : définition des accès restreint pour les machines à sauvegarder, Organisation des fichiers côté machine sauvegardée en mode `remote` : - /etc/borgmatic/ - - config.yaml - - excludes + - config.yaml : configuration de la sauvegarde, + - excludes : liste des patterns d'exclusion de la sauvegarde, # Installation d'un serveur de sauvegarde @@ -344,25 +347,50 @@ Sys. de fichiers Taille Utilisé Dispo Uti% Monté sur ## Récupération -Explorer la sauvegarde : +Lister les sauvegardes de la machine `audio.a-lec.org` : +``` +$ sudo borgmatic -c /etc/borgmatic.d/audio.a-lec.org.yaml list +/var/backups/borg/audio.a-lec.org.repo: Listing archives +2023-01-20T01:34 Fri, 2023-01-20 01:34:12 [625a6eb4255718932254fa8eda18a17f10ada05d051c1576168758ea1ec9e014] +2023-01-21T12:52 Sat, 2023-01-21 12:52:23 [b256357077848c23ca0650164f4ec51ecb97a8bb8fc38d652a8acb1e0968a951] +2023-01-22T01:03 Sun, 2023-01-22 01:03:37 [c51614c0545d106881e49942d58d2f1c1adebfe3e11fae22d897de4442dafc58] +2023-01-23T00:11 Mon, 2023-01-23 00:11:34 [8c6720c3b4da7646512d90c4f65a6063d95894bfc909e57ef20d94622bfac04f] +2023-01-24T00:11 Tue, 2023-01-24 00:11:41 [687d58fd4acfad1bf0f3aa302ed57484e149db7447bef05865888cdf8b2fcc5c] ``` +Lister les fichiers d'une sauvegarde : +``` +mkdir -p tmp ; cd tmp +sudo borgmatic -c /etc/borgmatic.d/audio.a-lec.org.yaml list --archive 2023-01-25T00:11 +/var/backups/borg/audio.a-lec.org.repo: Listing archives +drwxr-xr-x root root 0 Fri, 2023-01-20 01:22:45 etc +drwxr-xr-x root root 0 Mon, 2021-08-16 17:00:51 etc/console-setup +-rw-r--r-- root root 34 Thu, 2019-08-15 16:11:30 etc/console-setup/compose.ARMSCII-8.inc +-rw-r--r-- root root 31 Thu, 2019-08-15 16:11:30 etc/console-setup/compose.CP1251.inc +-rw-r--r-- root root 31 Thu, 2019-08-15 16:11:30 etc/console-setup/compose.CP1255.inc +-rw-r--r-- root root 31 Thu, 2019-08-15 16:11:30 etc/console-setup/compose.CP1256.inc +-rw-r--r-- root root 569 Fri, 2022-05-13 11:40:24 etc/fstab +[…] ``` -Récupérer un fichier : +Récupérer un fichier ou un dossier : ``` -``` - -Récupérer un dossier : -``` - +mkdir -p tmp ; cd tmp +sudo borgmatic -c /etc/borgmatic.d/audio.a-lec.org.yaml extract --archive 2023-01-25T00:11 --path /etc/fstab +ll etc/fstab +-rw-r--r-- 1 root root 569 13 mai 2022 etc/fstab ``` Récupérer tout une sauvegarde : ``` - +mkdir -p tmp ; cd tmp +sudo borgmatic -c /etc/borgmatic.d/audio.a-lec.org.yaml extract --archive 2023-01-25T00:11 ``` ## Suppression -TODO +Borgmatic ne prévoit pas de commande pour supprimer une sauvegarde. Il faut passer par Borgb : +``` +borg delete /var/backups/borg/audio.a-lec.org.repo::2023-01-25T00:11 +``` + From 510fc7898214aecbb9fa87cb45784778c59e8710 Mon Sep 17 00:00:00 2001 From: "Christian P. MOMON" Date: Sun, 29 Jan 2023 23:45:58 +0000 Subject: [PATCH 2/5] Update README.md --- Plan Borg/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Plan Borg/README.md b/Plan Borg/README.md index c9543e8..df789a8 100644 --- a/Plan Borg/README.md +++ b/Plan Borg/README.md @@ -389,7 +389,7 @@ sudo borgmatic -c /etc/borgmatic.d/audio.a-lec.org.yaml extract --archive 2023-0 ## Suppression -Borgmatic ne prévoit pas de commande pour supprimer une sauvegarde. Il faut passer par Borgb : +Borgmatic ne prévoit pas de commande pour supprimer une sauvegarde. Il faut passer par Borg : ``` borg delete /var/backups/borg/audio.a-lec.org.repo::2023-01-25T00:11 ``` From 6e70f675c821c2789e503ad084e9fe59c6e74140 Mon Sep 17 00:00:00 2001 From: "Christian P. MOMON" Date: Mon, 30 Jan 2023 00:01:40 +0000 Subject: [PATCH 3/5] Update README.md --- Plan Borg/README.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/Plan Borg/README.md b/Plan Borg/README.md index df789a8..3bc5536 100644 --- a/Plan Borg/README.md +++ b/Plan Borg/README.md @@ -1,6 +1,8 @@ | Plan Borg | | --------- | +[[_TOC_]] + # Introduction Le plan Borg est une solution de sauvegarde basée sur Borgmatic. @@ -9,14 +11,21 @@ Documentations : - Borgmatic : https://torsion.org/borgmatic/docs/reference/command-line/ ; - Borgbackups : https://borgbackup.readthedocs.io/en/stable/index.html (recommandation d'aller voir le sous-menu `Usage`). -[[_TOC_]] - # Principes +Borgmatic prend une définition déclarative des paramètres d'une sauvegarde (excludes, rétention, nommage, chemin dépôt…) pour les traduire en action Borg : créer un dépôt, le purger, le vérifier… + Quelques pré-requis : - l'adminsys d'une machine doit pouvoir régler lui-même certaines caractéristiques de la sauvegarde de sa machine : avec Borgmatic, il dispose d'un fichier de configuration où configurer des hooks (pour une base de données par exemple) ou définir les dossiers à sauver, définir les exclusions… - l'adminsys de la sauvegarde doit pouvoir régler lui-même certaines caractérisiques des sauvegardes tels que rétention, horaire et autres : il dispose d'un fichier de configuration par machine sauvegardée et d'un script de déclenchement des sauvegardes. +Flux général : +``` +saukvipeu:/etc/cron.d/backups + -> /srv/borg/bin/dobackup-remote fqdn1 + --ssh(admin666@fqdn1)--> sudo borgmatic create --verbosity 1 + --ssh(borg@sauvkipeu)--> /var/backups/borg/fqdn1.repo +``` Organisation des fichiers côté serveur de sauvegarde : - /etc/borgmatic/ From b420cd104ff19d5566632c79c3908c0d732d687c Mon Sep 17 00:00:00 2001 From: "Christian P. MOMON" Date: Mon, 30 Jan 2023 00:04:28 +0000 Subject: [PATCH 4/5] Update README.md --- Plan Borg/README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Plan Borg/README.md b/Plan Borg/README.md index 3bc5536..b34a344 100644 --- a/Plan Borg/README.md +++ b/Plan Borg/README.md @@ -24,7 +24,8 @@ Flux général : saukvipeu:/etc/cron.d/backups -> /srv/borg/bin/dobackup-remote fqdn1 --ssh(admin666@fqdn1)--> sudo borgmatic create --verbosity 1 - --ssh(borg@sauvkipeu)--> /var/backups/borg/fqdn1.repo + -> fqdn1:/etc/borgmatic/config.yaml + /etc/borgmatic/excludes + --ssh(borg@sauvkipeu)--> /var/backups/borg/fqdn1.repo ``` Organisation des fichiers côté serveur de sauvegarde : From 68c58142762dc1ab12052813aa49a47507d8ce61 Mon Sep 17 00:00:00 2001 From: "Christian P. MOMON" Date: Mon, 30 Jan 2023 00:05:30 +0000 Subject: [PATCH 5/5] Update README.md --- Plan Borg/README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/Plan Borg/README.md b/Plan Borg/README.md index b34a344..15ed55e 100644 --- a/Plan Borg/README.md +++ b/Plan Borg/README.md @@ -28,6 +28,11 @@ saukvipeu:/etc/cron.d/backups --ssh(borg@sauvkipeu)--> /var/backups/borg/fqdn1.repo ``` +Organisation des fichiers côté machine sauvegardée en mode `remote` : +- /etc/borgmatic/ + - config.yaml : configuration de la sauvegarde, + - excludes : liste d'exclusions pour la sauvegarde. + Organisation des fichiers côté serveur de sauvegarde : - /etc/borgmatic/ - retention.yaml : paramétrage par défaut de la purge, par défaut inclus par les fichiers de configuration de `/etc/borgmatic.d`, @@ -63,12 +68,8 @@ Organisation des fichiers côté serveur de sauvegarde : - retention.yaml : modèle pour le paramétrage par défaut des purges, - /srv/borg/.borg-passphrase : passphrase des dépôts, - /srv/borg/.ssh/ : - - authorized_keys : définition des accès restreint pour les machines à sauvegarder, + - authorized_keys : définition des accès restreint pour les machines à sauvegarder. -Organisation des fichiers côté machine sauvegardée en mode `remote` : -- /etc/borgmatic/ - - config.yaml : configuration de la sauvegarde, - - excludes : liste des patterns d'exclusion de la sauvegarde, # Installation d'un serveur de sauvegarde