Pour les administrateurs
← Tous les sujets

Sauvegarde et restauration

La sauvegarde quotidienne de la base de données et celle à la demande, pourquoi les copier hors du serveur avec MASTER_KEY, et comment restaurer un dump.

Dans une installation sur votre propre serveur, tout ce qui compte se trouve dans la base de données : paramètres, consignes, sources de connaissances, messages, brouillons et secrets chiffrés. Vous sauvegardez donc la base de données – ainsi que le fichier .env avec la MASTER_KEY.

Ce qu’il faut sauvegarder

  1. La base de données – draften en fait lui-même des dumps dans le dossier backups/ (voir ci-dessous) ; à vous de veiller à ce que les dumps soient copiés hors du serveur.
  2. .env, et surtout MASTER_KEY – hors du serveur, en lieu sûr. Sans elle, vous ne pouvez pas lire dans la base de données les clés API, les accès aux boîtes mail ni les clients de connexion ; la sauvegarde ne servirait à rien. Nous ne l’avons pas.

Un dump de la base de données contient les e-mails des clients. Protégez-le comme la boîte mail elle-même.

Les sauvegardes que fait draften

draften enregistre un dump de la base de données dans le dossier backups/ du répertoire d’installation :

Les sauvegardes quotidiennes et celles faites sur demande sont comptées à part de celles faites avant les mises à jour : les 7 dernières sont conservées, et à côté d’elles les 3 dernières sauvegardes antérieures à une mise à jour. La carte affiche les sept dernières sauvegardes – quand elles ont été réalisées, leur type, la version et la taille.

Les paramètres peuvent être modifiés dans .env :

VariableÀ quoi elle sert
DRAFTEN_DAILY_BACKUPScombien de sauvegardes quotidiennes et de sauvegardes sur demande conserver (7 par défaut) ; 0 désactive la sauvegarde quotidienne, une sauvegarde sur demande est tout de même réalisée
DRAFTEN_BACKUP_AT, DRAFTEN_TIMEZONEl’heure de la sauvegarde quotidienne et son fuseau horaire (par défaut 01:00, Europe/Prague) ; une heure définie dans l’interface l’emporte
DRAFTEN_BACKUPScombien de sauvegardes antérieures à une mise à jour conserver (3 par défaut)

Sans l’updater

Les sauvegardes quotidiennes et le bouton sont le travail de l’updater. Quand aucun updater ne tourne sur l’installation, la même sauvegarde est faite par la commande :

./draften backup

Pour une sauvegarde quotidienne, lancez-la depuis cron, par exemple à une heure du matin (remplacez le chemin par le répertoire de votre installation) :

0 1 * * * cd /srv/draften && ./draften backup

Les sauvegardes de backups/ ne sont pas hors du serveur

Elles se trouvent sur le même disque que la base de données – si vous perdez le disque ou le serveur, vous les perdez aussi. Copiez le dossier backups/ avec .env ailleurs, comme vos autres sauvegardes, ou sauvegardez tout le serveur après la sauvegarde quotidienne (c’est-à-dire après 01:00 ou l’heure que vous avez définie).

Les sauvegardes de backups/ ne sont pas concernées par la conservation des données : un dump conserve ce que contenait la base de données au moment où il a été réalisé.

Restauration

Chaque dump de backups/ porte dans son nom l’heure et la version qui tournait à ce moment-là : <heure>-<version>.backup.sql.gz pour les sauvegardes quotidiennes et celles faites sur demande, <heure>-<version>.sql.gz pour celles faites avant une mise à jour. Arrêtez les workers, chargez le dump et démarrez la version indiquée dans son nom :

docker compose stop worker
gunzip -c backups/<dump>.sql.gz | docker compose exec -T db sh -c 'mariadb -uroot -p"$MARIADB_ROOT_PASSWORD"'
./draften update <version> --no-backup

Tout ce qui s’est passé dans draften après la création du dump est perdu.

Sur un nouveau serveur, installez d’abord draften et placez dans .env la MASTER_KEY en vigueur au moment du dump.

Remplacer la clé de chiffrement

La MASTER_KEY peut être remplacée sans interruption de service – dans l’interface (Installation → Installation → Clé de chiffrement → Remplacer la clé de chiffrement, nécessite l’updater), ou avec la commande :

./draften rotate-key

La nouvelle clé est d’abord inscrite dans .env, les conteneurs la prennent l’un après l’autre et tout ce qui est stocké est chiffré à nouveau avec elle. L’ancienne clé reste dans .env sous le nom MASTER_KEY_PREVIOUS tant que backups/ contient des dumps antérieurs au remplacement – elle seule peut les ouvrir. draften refuse un nouveau remplacement tant qu’un tel dump existe. Les sauvegardes quotidiennes antérieures au remplacement disparaissent au plus tard au bout de 7 jours, les sauvegardes antérieures à une mise à jour seulement après trois nouvelles mises à jour.

Après le remplacement, copiez immédiatement le nouveau .env hors du serveur. La nouvelle clé n’apparaît jamais dans l’interface ; elle se trouve uniquement dans .env sur le serveur.

Attention

Version texte