Déploiement et exploitation

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émentFichierRemarque
Base PostgreSQLpostgres.dumpInstantané cohérent, format restaurable par pg_restore
Rôles PostgreSQLroles.sqlSans mot de passe, pour référence
Stockage privé platform-storagestorage.tarAvec propriétaires et droits
Configurationconfig.envSeulement si un fichier est fourni
Métadonnéesbackup.infoProjet, date UTC, commit de l'image
EmpreintesSHA256SUMSVé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#

bash
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 dans docker 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 :

  1. Chiffrez le dossier, par exemple avec age ou gpg.
  2. 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.

  1. 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.
  2. Démarrez une pile neuve, avec des volumes vides :
bash
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
  1. Restaurez la base et le stockage. Le script vérifie les empreintes, compare la configuration et exige une base vide :
bash
sh infra/compose/restore.sh <projet> <dossier-de-sauvegarde> <env>
  1. Démarrez la pile. La release rejoue 0 migration et revérifie les droits du rôle runtime :
bash
docker compose -p <projet> -f compose.mvp.yaml --env-file <env> up -d --wait
  1. Inscrivez la restauration au journal des actions :
bash
sh infra/compose/audit-operation.sh <projet> restore succeeded <dossier-de-sauvegarde>
  1. 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#

  1. Si la base répond encore et que des effets doivent cesser, activez l'arrêt global.
  2. Restaurez comme ci-dessus.
  3. Examinez la file de secours du journal avant de clore l'incident.
  4. Levez l'arrêt global.
  5. Recensez les écritures perdues depuis la sauvegarde : elles mesurent la perte réelle.

Objectifs de reprise#

Objectif initialHypothèse
Perte de données maximale (RPO) : 24 heuresSauvegarde quotidienne réussie, plus une sauvegarde avant chaque migration.
Durée de remise en service (RTO) : 8 heuresExploitant 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.