Script de backup restic pour Lisette et Bermite
Pull depuis ce PC via SSH : snapshot SQLite à chaud (API backup de Python, sans fichier temporaire sur le serveur), vérification d'intégrité locale, puis restic backup taggé par service. Rétention configurable, isolation des échecs par service, commande `list`. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
commit
f6053bb459
8 files changed
+267
No files matched your search
@@ -0,0 +1,71 @@
|
||||
# Backups des services auto-hébergés
|
||||
|
||||
Script lancé depuis ce PC : il se connecte en SSH à chaque serveur, prend un snapshot cohérent des données et les range dans un dépôt **restic** local, chiffré et dédupliqué.
|
||||
|
||||
| Service | Hôte | Données sauvegardées |
|
||||
|---------|----------|-----------------------------------------|
|
||||
| lisette | raspiweb | `lisette.db` (SQLite) + `.env` |
|
||||
| bermite | raspiweb | `bermite.db` (SQLite) + `.env` |
|
||||
|
||||
## Installation (une fois)
|
||||
|
||||
```sh
|
||||
cp config.env.example config.env # adapter si besoin
|
||||
./backup.sh --init # génère le mot de passe + restic init
|
||||
```
|
||||
|
||||
⚠️ Il faut **copier `~/.config/backups/restic-password` ailleurs**, par exemple dans Vaultwarden. Sans ce mot de passe, le dépôt est irrécupérable.
|
||||
|
||||
## Usage
|
||||
|
||||
```sh
|
||||
./backup.sh # tous les services (services/*.sh)
|
||||
./backup.sh lisette # un seul
|
||||
./backup.sh list # liste toutes les sauvegardes
|
||||
./backup.sh list lisette # seulement celles de lisette
|
||||
```
|
||||
|
||||
Un service en échec n'empêche pas les autres de tourner. Le résumé final et le code de sortie signalent l'échec. La rétention (`KEEP_*` dans `config.env`) n'est appliquée que si tout a réussi.
|
||||
|
||||
Pour lancer restic à la main, il faut d'abord charger la config :
|
||||
|
||||
```sh
|
||||
set -a; source config.env; set +a
|
||||
restic snapshots
|
||||
```
|
||||
|
||||
## Fonctionnement
|
||||
|
||||
1. **SQLite** : `lib/sqlite_snapshot.py` est envoyé au serveur par `ssh hôte python3 -`. Il utilise l'API `backup()` de SQLite, qui fonctionne à chaud sans arrêter le service, et renvoie la base sur stdout. Aucun fichier temporaire ne reste sur le serveur. Une fois la base rapatriée, on lance `PRAGMA integrity_check` en local.
|
||||
2. **Fichiers** : ils sont récupérés par `rsync -a`.
|
||||
3. Le staging (`~/.cache/backups/staging/<service>`, en mode 700) part dans restic avec `--tag <service> --host <hôte>`, puis il est supprimé.
|
||||
|
||||
## Restaurer
|
||||
|
||||
```sh
|
||||
set -a; source config.env; set +a
|
||||
restic snapshots --tag lisette
|
||||
restic restore latest --tag lisette --target /tmp/restore # ou un ID de snapshot
|
||||
|
||||
ssh raspiweb sudo systemctl stop lisette
|
||||
scp /tmp/restore/lisette.db raspiweb:/home/pi/Scripts/lisette/lisette.db
|
||||
ssh raspiweb 'rm -f /home/pi/Scripts/lisette/lisette.db-wal /home/pi/Scripts/lisette/lisette.db-shm'
|
||||
ssh raspiweb sudo systemctl start lisette
|
||||
rm -rf /tmp/restore
|
||||
```
|
||||
|
||||
## Ajouter un service
|
||||
|
||||
Créer `services/<nom>.sh` :
|
||||
|
||||
```bash
|
||||
SERVICE_HOST=monserveur # alias ~/.ssh/config
|
||||
|
||||
backup_service() { # $1 = dossier de staging
|
||||
ssh_sqlite_snapshot "$SERVICE_HOST" /chemin/app.db "$1/app.db"
|
||||
pull_files "$SERVICE_HOST" "$1" /chemin/.env /chemin/uploads
|
||||
# ou un dump : ssh "$SERVICE_HOST" pg_dump ... > "$1/db.sql"
|
||||
}
|
||||
```
|
||||
|
||||
Les fonctions disponibles se trouvent dans `lib/common.sh`.
|
||||
Reference in new issue
Block a user