Sauvegarde et restauration
Deux scripts fournis protègent les données de l'instance : backup.sh produit une sauvegarde complète, restore.sh la restaure sur une pile neuve. Cette page décrit leur usage et les objectifs de reprise.
Qui peut le faire : l'exploitant, sur le serveur Docker, depuis une copie du dépôt source.
Ce qui est sauvegardé#
| Élément | Fichier | Remarque |
|---|---|---|
| Base PostgreSQL | postgres.dump | Instantané cohérent, format restaurable par pg_restore |
| Rôles PostgreSQL | roles.sql | Sans mot de passe, pour référence |
Stockage privé platform-storage | storage.tar | Avec propriétaires et droits |
| Configuration | config.env | Seulement si un fichier est fourni |
| Métadonnées | backup.info | Projet, date UTC, commit de l'image |
| Empreintes | SHA256SUMS | Vérifiées avant toute restauration |
Redis n'est pas sauvegardé : il n'est pas la source de vérité et se reconstruit depuis PostgreSQL.
Sur Coolify, la configuration vit dans la ressource. Exportez les variables vers le coffre de l'équipe à chaque changement. Sans ces valeurs, une base restaurée reste inaccessible.
Sauvegarder#
sh infra/compose/backup.sh <projet-compose> /chemin/neuf/2026-11-20 [fichier-env]<projet-compose>: sur Coolify, l'identifiant de la ressource, visible comme préfixe des conteneurs dansdocker ps.- Le dossier de sortie doit être neuf. Il est créé avec des droits privés (0700).
- Le script n'affiche ni données ni secrets : seulement des noms de fichiers, des tailles et des empreintes.
Ensuite :
- Chiffrez le dossier, par exemple avec
ageougpg. - Copiez-le hors du serveur.
La sauvegarde est inscrite au journal des actions : operations.backup « demandé » avant l'instantané, puis « réussi ». Si le service web est arrêté, la sauvegarde se poursuit et le script indique l'entrée à rejouer avec infra/compose/audit-operation.sh.
Fréquence proposée#
- Une sauvegarde quotidienne planifiée (cron de l'hôte ou tâche planifiée Coolify), conservée 14 jours.
- Une sauvegarde manuelle avant chaque déploiement qui contient une migration.
Restaurer#
La restauration vise toujours une pile neuve. Le script refuse de remplacer une base existante.
- Restaurez la configuration à l'identique de la sauvegarde : variables Coolify depuis le coffre, ou fichier
config.env. Les mots de passe des rôles doivent être les mêmes. - Démarrez une pile neuve, avec des volumes vides :
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> up -d --wait postgres redis
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> create web worker- Restaurez la base et le stockage. Le script vérifie les empreintes, compare la configuration et exige une base vide :
sh infra/compose/restore.sh <projet> <dossier-de-sauvegarde> <env>- Démarrez la pile. La release rejoue 0 migration et revérifie les droits du rôle runtime :
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> up -d --wait- Inscrivez la restauration au journal des actions :
sh infra/compose/audit-operation.sh <projet> restore succeeded <dossier-de-sauvegarde>- Vérifiez
/readyzà 200 et l'absence d'alerte Journal d'audit indisponible sur la page Exploitation.
La restauration de la base s'exécute en une seule transaction : un échec ne laisse pas de base partielle.
Pendant un incident#
- Si la base répond encore et que des effets doivent cesser, activez l'arrêt global.
- Restaurez comme ci-dessus.
- Examinez la file de secours du journal avant de clore l'incident.
- Levez l'arrêt global.
- Recensez les écritures perdues depuis la sauvegarde : elles mesurent la perte réelle.
Objectifs de reprise#
| Objectif initial | Hypothèse |
|---|---|
| Perte de données maximale (RPO) : 24 heures | Sauvegarde quotidienne réussie, plus une sauvegarde avant chaque migration. |
| Durée de remise en service (RTO) : 8 heures | Exploitant disponible, sauvegarde et configuration accessibles. |
Ces valeurs sont des objectifs, pas des engagements de service. Une répétition sur une pile de test, avec une base de quelques mégaoctets, a pris quelques secondes. La durée réelle dépend du volume de données, du transfert de la sauvegarde chiffrée et de la disponibilité de l'exploitant. Mesurez-la sur votre propre instance.
Essai de restauration#
Faites un essai de restauration au moins une fois par mois, dans une ressource ou un projet Compose jetable. Une sauvegarde jamais restaurée n'est pas une sauvegarde vérifiée.
Pour continuer#
Préparez les mises à jour avec Mises à jour et retour arrière.