Importación desde Docker Compose
Copiar los datos de las bases de datos y las cachés de un Docker Compose en los servicios de Joppa y luego pasar el proyecto a ellos, sin modificar nunca el origen.
¿Tu proyecto ejecuta PostgreSQL o Redis en su propio docker-compose.yml? Joppa puede copiar sus datos en sus servicios y luego hacer que el proyecto apunte a ellos. El origen nunca se modifica.
Dónde encontrarlo
- Al añadir el proyecto: la ventana propone Importar en Joppa para cada base de datos o caché encontrada. Los datos se copian después de añadirlo.
- Más tarde: pestaña Dominios del proyecto, sección Datos de Docker Compose.
Qué se puede importar
| Origen (Compose) | Destino (Joppa) | Método |
|---|---|---|
| PostgreSQL | PostgreSQL | pg_dump y luego restauración |
| MySQL, MariaDB | MySQL o MariaDB | mysqldump y luego restauración |
| Redis, Valkey | Redis o Valkey | Copia de las claves (DUMP / RESTORE) |
Joppa lee compose.yaml, compose.yml, docker-compose.yml o .yaml, el archivo de override y COMPOSE_FILE, sustituyendo los ${VAR:-defecto} por los valores del .env y de los env_file. Encuentra la versión de la imagen, aunque se construya desde un Dockerfile (FROM).
El plan de importación
Antes de copiar nada, Joppa muestra el origen, el destino y:
- Base de datos a importar y Nombre en Joppa;
- el tamaño (o el número de claves);
- las versiones de ambos lados;
- las extensiones que usa la base de datos de origen: Disponible en Joppa, Hay que activarla en el servidor de Joppa o Joppa no la ofrece.
Para una caché, la opción Reemplazar las claves que ya están en Joppa elige entre fusionar y sobrescribir.
Lo que Joppa resuelve por ti
| Situación | Propuesta |
|---|---|
| El origen está detenido | Iniciarlo (docker compose up), con tu permiso |
| Aún no hay servicio en Joppa | Crear PostgreSQL 17, en la misma versión que el origen |
| El servicio de Joppa está detenido | Iniciarlo |
| El puerto del origen no está publicado (cachés) | El fragmento que hay que añadir al Compose |
| Extensiones que activar en el servidor | Añadirlas a la imagen y reiniciar el servicio |
| Existe una base de datos con el mismo nombre | Importar con otro nombre o Reemplazar |
La importación avanza en pasos visibles: Dump, Crear la base de datos, Restauración (o Lectura de claves, Copia de claves).
Pasar el proyecto a Joppa
Una vez copiados los datos, Pasar el proyecto a Joppa propone, a elegir:
- Detener el servicio de Compose y liberar el puerto: sus datos se quedan en Docker;
- Apuntar el .env del proyecto a Joppa: el original se guarda en
.env.joppa-backup.
Más tarde deja el Compose y el .env tal cual.