Aller au contenu

Fonctionnement des sauvegardes

Ce que contient une sauvegarde, ses déclencheurs, ses statuts, son chiffrement, sa rétention et ce qu'il advient d'elle quand la ressource source disparaît.

ConceptDéveloppeur
Voir en Markdown

Une sauvegarde Wakastart est un fichier : l'export complet d'une base de données ou l'archive du contenu d'un bucket, à un instant donné, chiffré et rangé dans le stockage de sauvegardes de la plateforme. Elle vit indépendamment de la ressource sauvegardée, jusqu'à son expiration.

Définition

Une sauvegarde porte :

  • la ressource source : une instance de base ou de bucket d'un environnement ;
  • un déclencheur : manuel, planifié, ou sauvegarde de sécurité ;
  • un statut ;
  • la configuration de la source au moment de la sauvegarde (moteur, mode, version, offre, région) : elle sert à recréer une base lors d'une restauration dans une nouvelle base ;
  • une date d'expiration.

Une sauvegarde n'est pas une réplique : elle ne suit pas les changements faits après sa création.

Pourquoi ça existe

Les bases dans le cluster tournent sur un seul volume, et une erreur applicative peut corrompre des données dans n'importe quel mode. Une sauvegarde stockée ailleurs que la ressource permet de revenir en arrière, de copier des données entre environnements, et de récupérer une base supprimée.

Comment ça marche

Déclencheurs

DéclencheurLibellé (liste de l'application)Origine
MANUALManuelbouton Sauvegarder maintenant
SCHEDULEDPlanifiéplanification de la ressource
PRE_DESTROYPre-destroysauvegarde de sécurité faite automatiquement sur la cible avant une restauration en place

Statuts

Chargement du schéma…
CodeLibelléSignification
PENDINGEn attentela demande est enregistrée
IN_PROGRESSEn coursl'export est en cours
COMPLETEDTerminéle fichier est stocké ; la sauvegarde peut être restaurée ou téléchargée
FAILEDÉchecl'export a échoué ; les logs de l'opération sont disponibles
EXPIREDExpiréla rétention est dépassée
DELETEDSuppriméla sauvegarde a été supprimée

Une sauvegarde qui reste En cours plus de 3 heures passe en Échec. Le fichier d'une sauvegarde expirée ou supprimée est effacé lors du nettoyage suivant, qui a lieu toutes les 6 heures.

Chiffrement

Chaque fichier est chiffré avant d'être stocké, avec une clé propre à l'environnement, et une empreinte SHA-256 est enregistrée. La clé de déchiffrement reste chez Wakastart : pour exploiter le contenu d'une sauvegarde, restaurez-la depuis la console. Le fichier téléchargeable sert d'archive hors plateforme.

Rétention

SauvegardeExpire après
Manuelle7 jours
Planifiéela Rétention (jours) de la planification, de 1 à 365 jours (7 par défaut)
Sauvegarde de sécurité avant restauration7 jours

La planification fixe aussi un nombre maximum de sauvegardes planifiées conservées (30 par défaut) : au-delà, les plus anciennes sont supprimées. Les sauvegardes manuelles ne comptent pas dans ce maximum.

Règles d'exécution

  • La ressource doit être Prête.
  • Une seule sauvegarde à la fois par ressource, et aucune pendant une restauration sur cette ressource.
  • Une sauvegarde dure au plus 2 heures.

Sauvegardes orphelines

Quand une base est supprimée, ses sauvegardes restent listées dans la page Backups de l'application avec le badge Orphelin, jusqu'à leur expiration. Elles ne peuvent être restaurées que dans une nouvelle base.

Exemples

  • Une base de production planifiée chaque jour : rétention 14 jours, maximum 14 : vous pouvez revenir à n'importe quel jour des deux dernières semaines.
  • Avant une migration de schéma : une sauvegarde manuelle, conservée 7 jours, en plus des sauvegardes planifiées.

Pour aller plus loin