Sauvegarde et restauration

Ce qui est sauvegardé#

Le script deploy/sauvegarde.sh produit, sans arrêter la plateforme, un dossier horodaté (heure UTC) par sauvegarde dans SAUVEGARDE_DOSSIER (/var/backups/read) :

Les fichiers sont lisibles par root seulement (droits 600, dossier 700). Les sauvegardes de plus de SAUVEGARDE_JOURS jours (30) sont supprimées à chaque exécution, localement et à distance.

Activer la sauvegarde quotidienne#

Le minuteur systemd fourni lance la sauvegarde chaque jour à 2 h 30 UTC (3 h 30 à Niamey), à quelques minutes près ; une exécution manquée (serveur éteint) est rattrapée au démarrage.

sudo cp /opt/read/code/deploy/systemd/read-sauvegarde.* /etc/systemd/system/
sudo systemctl daemon-reload && sudo systemctl enable --now read-sauvegarde.timer
systemctl list-timers read-sauvegarde.timer          # prochaine exécution

Lancer une sauvegarde à la main (avant un déploiement, par exemple) :

sudo /opt/read/code/deploy/sauvegarde.sh

Lire le compte rendu de la dernière sauvegarde automatique :

sudo journalctl -u read-sauvegarde.service -n 20

Exemple de compte rendu (valeurs indicatives) :

[2026-10-08T02:31:04Z] Sauvegarde dans /var/backups/read/20261008-023104
[2026-10-08T02:31:19Z] Taille : 48M ; organisations 24;activites 300;…;fichiers_app-keys 1;
[2026-10-08T02:31:41Z] Copie hors serveur : chiffre:/20261008-023104
[2026-10-08T02:31:42Z] Sauvegarde terminée.

Copie hors serveur chiffrée#

La copie est faite par rclone (dans un conteneur : rien à installer), chiffrée avant l'envoi (couche crypt) : l'hébergeur du stockage ne peut lire ni les contacts ni le journal.

1. Créez un stockage objet compatible S3 dans une autre région que le serveur, un conteneur et un utilisateur S3 limité à ce conteneur. Notez le point d'accès, la région, la clé d'accès et la clé secrète.

2. Choisissez une phrase de chiffrement longue et conservez-la hors du serveur (gestionnaire de mots de passe). Convertissez-la au format attendu par rclone :

   Copier

   docker run --rm rclone/rclone:1.75.1 obscure '<phrase>'

3. Ajoutez à /opt/read/.env (modèle commenté dans deploy/.env.example) :

   Copier

   RCLONE_CONFIG_DISTANT_TYPE=s3
   RCLONE_CONFIG_DISTANT_PROVIDER=Other
   RCLONE_CONFIG_DISTANT_ENDPOINT=https://s3.<region>.example.net
   RCLONE_CONFIG_DISTANT_REGION=<region>
   RCLONE_CONFIG_DISTANT_ACCESS_KEY_ID=<clé d'accès>
   RCLONE_CONFIG_DISTANT_SECRET_ACCESS_KEY=<clé secrète>
   RCLONE_CONFIG_CHIFFRE_TYPE=crypt
   RCLONE_CONFIG_CHIFFRE_REMOTE=distant:<conteneur>/read
   RCLONE_CONFIG_CHIFFRE_PASSWORD=<phrase convertie par « rclone obscure »>
   SAUVEGARDE_DISTANTE=chiffre:

4. Lancez une sauvegarde à la main ; le compte rendu doit indiquer Copie hors serveur.

5. Listez les copies distantes :

   Copier

   docker run --rm --env-file <(grep ^RCLONE_ /opt/read/.env) rclone/rclone:1.75.1 lsd chiffre:

Restaurer#

Le script deploy/restaurer.sh vérifie d'abord les empreintes (SHA256SUMS) du dossier fourni, puis travaille selon le mode choisi.

Restauration d'essai#

Elle restaure la sauvegarde dans des conteneurs jetables et compare les nombres de lignes et de fichiers avec ceux relevés à la sauvegarde. Elle n'a aucun effet sur la plateforme.

sudo /opt/read/code/deploy/restaurer.sh /var/backups/read/<horodatage> --essai

Elle se termine par Restauration d'essai réussie, identique à la sauvegarde, ou par ÉCHEC et les différences.

Restauration réelle#

Elle remplace la base et les fichiers déposés de la plateforme par ceux de la sauvegarde.

1. Prévenez les utilisateurs : tout ce qui a été saisi après la sauvegarde sera perdu.

2. Lancez :

   Copier

   sudo /opt/read/code/deploy/restaurer.sh /var/backups/read/<horodatage> --confirmer

   Le script arrête app et caddy, recrée la base, y restaure base.dump, remplace le contenu des volumes app-donnees et app-keys, puis relance tout par docker compose up -d. Le service migrations redonne au rôle de l'application ses droits et applique les migrations plus récentes que la sauvegarde.

3. Connectez-vous et contrôlez quelques fiches récentes.

Serveur perdu : rapatrier une copie distante#

Sur un nouveau serveur installé comme au chapitre Installation, avec le même fichier .env (mêmes variables RCLONE_CONFIG_* et même phrase de chiffrement) :

1. Déployez la plateforme (elle démarre sur une base vide).

2. Listez les copies (lsd chiffre:) et rapatriez la plus récente :

   Copier

   docker run --rm --env-file <(grep ^RCLONE_ /opt/read/.env) -v /var/backups/read:/r rclone/rclone:1.75.1 \
     copy chiffre:<horodatage> /r/<horodatage>

3. Faites une restauration d'essai, puis la restauration réelle.
4. Pointez le nom de domaine vers le nouveau serveur.