# 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` | | gitea | raspitipi | dump PostgreSQL `gitea.sql` + `/data` du conteneur (dépôts, LFS, `app.ini`, avatars, pièces jointes, clés SSH) + `app.env` runtipi. Exclus car regénérables : sessions, queues, indexers, tmp, log, repo-archive | ## 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/`, en mode 700) part dans restic avec `--tag --host `, 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 ``` ### Restaurer Gitea (raspitipi / runtipi) ```sh restic restore latest --tag gitea --target /tmp/rg D=/home/pi/runtipi/app-data/migrated/gitea ssh raspitipi sudo docker stop gitea_migrated-gitea-1 rsync -a --rsync-path="sudo rsync" /tmp/rg/data/ raspitipi:$D/data/gitea/ ssh raspitipi "sudo chown -R 1000:1000 $D/data/gitea/git $D/data/gitea/gitea && sudo chown -R root:root $D/data/gitea/ssh" # base : repartir d'une base vide puis rejouer le dump ssh raspitipi 'sudo docker exec gitea_migrated-gitea-db-1 psql -U gitea -d postgres -c "DROP DATABASE gitea" -c "CREATE DATABASE gitea OWNER gitea"' ssh raspitipi 'sudo docker exec -i gitea_migrated-gitea-db-1 psql -U gitea -d gitea' < /tmp/rg/gitea.sql ssh raspitipi sudo docker start gitea_migrated-gitea-1 rm -rf /tmp/rg ``` Le `DROP DATABASE` ne passe que si Gitea est arrêté, faute de quoi des connexions restent ouvertes. Au premier démarrage, Gitea reconstruit les index. ## Ajouter un service Créer `services/.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 # PostgreSQL en conteneur : ssh_pg_dump "$SERVICE_HOST" "$1/db.sql" # Fichiers root/docker : pull_dir_sudo "$SERVICE_HOST" /chemin "$1/data" --exclude=/cache } ``` Les fonctions disponibles se trouvent dans `lib/common.sh`.