Import depuis Docker Compose
Copier les données des bases et des caches d'un Docker Compose dans les services de Joppa, puis basculer le projet, sans jamais modifier la source.
Votre projet fait tourner PostgreSQL ou Redis dans son propre docker-compose.yml ? Joppa peut copier leurs données dans ses services, puis faire pointer le projet vers eux. La source n’est jamais modifiée.
Où le trouver
- En ajoutant le projet : la fenêtre propose Importer dans Joppa pour chaque base ou cache trouvé. Les données sont copiées après l’ajout.
- Plus tard : onglet Domaines du projet, section Données Docker Compose.
Ce qui peut être importé
| Source (Compose) | Destination (Joppa) | Méthode |
|---|---|---|
| PostgreSQL | PostgreSQL | pg_dump puis restauration |
| MySQL, MariaDB | MySQL ou MariaDB | mysqldump puis restauration |
| Redis, Valkey | Redis ou Valkey | Copie des clés (DUMP / RESTORE) |
Joppa lit compose.yaml, compose.yml, docker-compose.yml ou .yaml, le fichier d’override et COMPOSE_FILE, en remplaçant les ${VAR:-défaut} par les valeurs du .env et des env_file. Il retrouve la version de l’image, même construite depuis un Dockerfile (FROM).
Le plan d’import
Avant de copier quoi que ce soit, Joppa montre la source, la destination et :
- Base à importer et Nom dans Joppa ;
- la taille (ou le nombre de clés) ;
- les versions des deux côtés ;
- les extensions utilisées par la base source : Disponible dans Joppa, À activer sur le serveur Joppa ou Non proposée par Joppa.
Pour un cache, l’option Remplacer les clés déjà présentes dans Joppa choisit entre fusion et écrasement.
Ce que Joppa règle pour vous
| Situation | Proposition |
|---|---|
| La source est arrêtée | La démarrer (docker compose up), avec votre accord |
| Pas encore de service dans Joppa | Créer PostgreSQL 17, dans la même version que la source |
| Le service Joppa est arrêté | Le démarrer |
| Le port de la source n’est pas publié (caches) | Le snippet à ajouter au Compose |
| Extensions à activer sur le serveur | Les ajouter à l’image et redémarrer le service |
| Une base du même nom existe | Importer sous un autre nom ou Remplacer |
L’import se déroule en étapes visibles : Dump, Création de la base, Restauration (ou Lecture des clés, Copie des clés).
Basculer le projet sur Joppa
Une fois les données copiées, Basculer le projet sur Joppa propose, au choix :
- Arrêter le service Compose et libérer le port : ses données restent dans Docker ;
- Pointer le .env du projet vers Joppa : l’original est sauvegardé dans
.env.joppa-backup.
Plus tard garde le Compose et le .env tels quels.