Migrar desde Easypanel
Traslade sus servicios de Easypanel a sh0 uno a uno, manteniendo Easypanel en línea hasta verificar cada uno.
Antes de empezar
Esta guía sigue la migración que hicimos nosotros mismos: unos veinte servicios de producción de varios proyectos, pasados de Easypanel a sh0 y comparados uno a uno con producción. El método es deliberadamente secuencial: desplegar un servicio en sh0, compararlo con lo que sirve Easypanel y pasar al siguiente.
1. Haga inventario
Para cada servicio de Easypanel, anote:
- Su origen: repositorio Git y rama, la ruta de build si la app vive en una subcarpeta, y el nombre del Dockerfile si no es el predeterminado.
- Sus variables de entorno, incluidas las que solo se usan durante el build.
- Sus dominios y el puerto en el que escucha la app.
- Sus datos: las bases de datos que usa y los volúmenes o montajes donde escribe archivos.
- Si escucha en algún puerto. Los consumidores de colas y los planificadores no lo hacen, y se crean de otra forma en sh0.
2. Prepare el servidor sh0
Instale sh0 en otro servidor, no en la máquina de Easypanel: ambos necesitan los puertos 80 y 443. Siga Instalación y luego cree la cuenta de propietario.
Antes de mover nada, compruebe el host. El comando revisa Docker, los puertos, el espacio en disco, los certificados y el reloj, y termina con 0 cuando nada bloquea:
sudo sh0 doctorUn ejemplo de informe y el significado de cada línea están en Actualizaciones y diagnóstico.
3. Vuelva a crear cada app
Cree cada app en sh0 a partir del mismo origen que usa en Easypanel:
- Desde su propia máquina, sin proveedor Git: sh0 push sube el directorio del proyecto y lo construye, con su Dockerfile o, si no lo hay, detectando la pila.
- Desde el mismo repositorio Git y la misma rama: vea Despliegue con Git. Repositorios privados, ramas no predeterminadas y repositorios de otra organización funcionaron en nuestra migración.
- Monorepos: configure la ruta de build en la subcarpeta de la app, y el nombre del Dockerfile si no se llama Dockerfile. Un Dockerfile con nombre se resuelve respecto a la ruta de build.
- Servicios sin puerto (Celery, BullMQ, un planificador): créelos como Worker (sin puerto). sh0 comprueba entonces que el proceso sigue vivo en lugar de esperar un puerto.
Copie las variables de entorno antes del primer despliegue y luego compare la nueva app con producción: mismos códigos de estado en las mismas rutas, mismo título de página, misma respuesta del endpoint de salud.
4. Traslade las bases de datos
Cree en sh0 un servidor de bases de datos con el mismo motor y la misma versión mayor que el origen. Después copie los datos con las herramientas de volcado y restauración del propio motor. El ejemplo siguiente es PostgreSQL.
Sustituya EASYPANEL_DB por el contenedor de la base de datos de Easypanel (búsquelo con docker ps), y sh0-dbsrv-<name> por el contenedor del servidor de bases de datos de sh0. Use el nombre de base de datos y el usuario que muestran los datos de conexión del servidor.
docker exec EASYPANEL_DB pg_dump -U app -d app -Fc > app.dumpdocker exec -i sh0-dbsrv-NAME pg_restore -U app -d app --no-owner --no-privileges < app.dump
docker exec sh0-dbsrv-NAME psql -U app -d app -tAc "select count(*) from orders"Copie el archivo de volcado entre los dos servidores con scp o rsync. Después apunte el DATABASE_URL de la app (o su equivalente) al servidor de bases de datos de sh0 y vuelva a desplegar la app.
5. Traslade archivos y volúmenes
Los archivos que escribe una app (subidas, documentos generados) viven en un volumen de Docker. Copie el contenido del volumen mediante un archivo tar y luego añada a la app en sh0 un volumen con la misma ruta de montaje:
docker run --rm -v SOURCE_VOLUME:/data alpine:3.19 tar -czf - -C /data . > uploads.tgzdocker run --rm -i -v TARGET_VOLUME:/data alpine:3.19 tar -xzf - -C /data < uploads.tgz
docker run --rm -v TARGET_VOLUME:/data alpine:3.19 find /data -type fEncuentre los nombres de los volúmenes con docker volume ls en cada servidor. En sh0, los nombres de volumen empiezan por sh0- seguido del nombre de la app.
Lo que funciona distinto
- Memoria: Easypanel no fija ningún límite por defecto; sh0 limita cada app a 512 MB salvo que lo aumente. Un backend Python con cuatro workers necesitó más en nuestra migración y el límite lo detuvo hasta que lo aumentamos.
- Nombres de servicio: dentro de un proyecto, una app llega a otra por su nombre o por
<app>.internal, que no cambia entre despliegues. Actualice los nombres de host que apuntaban a nombres de servicio de Easypanel. - Contexto de build: sh0 lee su .dockerignore con las reglas de Docker, así que un proyecto que se construye en Easypanel se construye igual en sh0.
- Una base de datos nueva revela lo que una antigua oculta: en nuestra migración, una cadena de migraciones no se podía reproducir desde una base vacía y una app creaba sus tablas desde cuatro workers a la vez. Eran fallos de los proyectos, no de las plataformas; restaurar primero los datos los evita.
6. Cambie los dominios
- El día anterior, reduzca el TTL de cada registro DNS que vaya a mover, para que el cambio se propague rápido.
- Añada el dominio a la app en sh0.
- Apunte el registro DNS a la dirección IP del servidor sh0. sh0 obtiene el certificado por sí mismo en cuanto el registro resuelve hacia él.
- Compare el dominio en vivo con lo que servía Easypanel.
- Solo entonces detenga el servicio en Easypanel. Conserve sus datos hasta estar seguro de que no tendrá que volver atrás.