# 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.

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éclencheur | Libellé (liste de l'application) | Origine |
|---|---|---|
| `MANUAL` | **Manuel** | bouton **Sauvegarder maintenant** |
| `SCHEDULED` | **Planifié** | planification de la ressource |
| `PRE_DESTROY` | **Pre-destroy** | sauvegarde de sécurité faite automatiquement sur la cible avant une restauration en place |

### Statuts

```mermaid
stateDiagram-v2
  [*] --> PENDING : demande
  PENDING --> IN_PROGRESS : prise en charge
  IN_PROGRESS --> COMPLETED : fichier chiffré stocké
  IN_PROGRESS --> FAILED : erreur ou plus de 3 h
  COMPLETED --> EXPIRED : date d'expiration atteinte
  COMPLETED --> DELETED : Supprimer
  EXPIRED --> [*] : fichier effacé
  DELETED --> [*] : fichier effacé
```

| Code | Libellé | Signification |
|---|---|---|
| `PENDING` | **En attente** | la demande est enregistrée |
| `IN_PROGRESS` | **En cours** | l'export est en cours |
| `COMPLETED` | **Terminé** | le fichier est stocké ; la sauvegarde peut être restaurée ou téléchargée |
| `FAILED` | **Échec** | l'export a échoué ; les logs de l'opération sont disponibles |
| `EXPIRED` | **Expiré** | la rétention est dépassée |
| `DELETED` | **Supprimé** | 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

| Sauvegarde | Expire après |
|---|---|
| Manuelle | 7 jours |
| Planifiée | la **Rétention (jours)** de la planification, de 1 à 365 jours (7 par défaut) |
| Sauvegarde de sécurité avant restauration | 7 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

- [Modes de restauration](/v1.0/sauvegardes/modes-de-restauration)
- [Planifier les sauvegardes](/v1.0/sauvegardes/planifier-les-sauvegardes)
- [Référence des sauvegardes](/v1.0/sauvegardes/reference)
