Romulus21andClaude Opus 5.5 f74c16ef7c Ajout du backup Gitea (raspitipi / runtipi)
- services/gitea.sh : dump PostgreSQL + /data du conteneur + app.env
- lib/common.sh : helpers ssh_pg_dump et pull_dir_sudo
- README : service gitea, procédure de restauration

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 09:20:54 +01:00

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)

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

./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 :

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

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)

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/<nom>.sh :

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" <conteneur> <user> <base> "$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.

S
Description
No description provided
Readme
35 KiB
0 Stars 1 Watchers 0 Forks
Languages
Shell 88.4%
Python 11.6%