_Assistant_Lead_Tech/60_playbooks/restaurer_backup_projet.md

Playbook — Restaurer un projet depuis un backup

Ce playbook décrit la procédure standard pour restaurer un projet Docker sur le NUC à partir d’une sauvegarde.

Il couvre principalement :

• restauration de base de données
• restauration de volumes persistants
• redémarrage de la stack Docker

Ce playbook est utilisé après :

• une migration
• une perte de données
• la recréation d’un environnement

---

Architecture de référence

Sur le NUC, les données vivent dans :

/srv/
  projects/        # code source
  docker-data/     # volumes persistants
  backups/         # sauvegardes

Les backups sont stockés dans :

/srv/backups/

Exemple :

/srv/backups/portfolio/

---

Étape 1 — Vérifier que le projet existe

Le projet doit être présent dans :

/srv/projects/<nom-projet>

Sinon :

cd /srv/projects
git clone <repo>

---

Étape 1b — Initialiser la mémoire projet

Depuis la racine du projet :

cd /srv/projects/<nom-projet>
gen-claude

Cette commande :

• génère CLAUDE.md depuis le template projet
• crée AGENTS.md -> CLAUDE.md
• initialise la mémoire active du projet pour Claude / Codex

---

---

Étape 2 — Arrêter la stack

Avant toute restauration, arrêter les conteneurs :

cd /srv/projects/<nom-projet>
docker compose down

Cela évite les corruptions de données.

---

Étape 3 — Restaurer les volumes persistants

Si le backup contient des volumes :

Exemple :

/srv/backups/portfolio/uploads
/srv/backups/portfolio/postgres

Restaurer dans :

/srv/docker-data/<nom-projet>/

Exemple :

cp -r /srv/backups/portfolio/uploads /srv/docker-data/portfolio/

Important :

• vérifier les permissions
• vérifier que les dossiers existent

---

Étape 4 — Restaurer la base de données

Si un dump SQL est disponible :

Exemple :

/srv/backups/portfolio/db.sql

Importer :

psql -U <user> -d <database> -f db.sql

Exemple concret :

psql -U portfolio_user -d portfolio -f /srv/backups/portfolio/db.sql

---

Étape 5 — Vérifier la configuration Docker

Contrôler :

• chemins des volumes
• variables d’environnement
• ports

Fichier principal :

docker-compose.yml

---

Étape 6 — Redémarrer le projet

Depuis le dossier projet :

docker compose up -d

Vérifier :

docker ps

---

Étape 7 — Vérifications post-restauration

Contrôler :

• que l’application démarre
• que la base contient bien les données
• que les volumes sont montés

Commandes utiles :

docker compose logs -f

ou

docker logs <container>

---

Bonnes pratiques

• toujours arrêter la stack avant restauration
• restaurer les volumes avant de relancer Docker
• vérifier les permissions des dossiers

---

Quand utiliser ce playbook

Utiliser ce playbook lorsque :

• un projet doit être restauré après incident
• un environnement doit être reconstruit
• une sauvegarde doit être testée

Ce playbook complète :

• bootstrap_projet_docker.md
• migration_projet_vers_nuc.md

---

Outils associés

• scripts/generate_project_claude.sh — permet de réinitialiser la mémoire projet si nécessaire après restauration