Docs/ Primeros pasos/ Migrar desde Easypanel

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.

Note
Hoy sh0 no tiene un importador automático de Easypanel. Cada paso siguiente es manual, y cada comando de esta página se ejecutó en un servidor real antes de escribirse aquí.

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:

Terminal
sudo sh0 doctor

Un 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.

On the Easypanel server
docker exec EASYPANEL_DB pg_dump -U app -d app -Fc > app.dump
On the sh0 server
docker 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.

Tip
Las escrituras hechas en Easypanel después del volcado no se copian. Para una base de datos que cambia sin parar, detenga la app en Easypanel justo antes del volcado final, o programe el cambio en una hora tranquila.

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:

On the Easypanel server
docker run --rm -v SOURCE_VOLUME:/data alpine:3.19 tar -czf - -C /data . > uploads.tgz
On the sh0 server
docker 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 f

Encuentre 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

  1. El día anterior, reduzca el TTL de cada registro DNS que vaya a mover, para que el cambio se propague rápido.
  2. Añada el dominio a la app en sh0.
  3. 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.
  4. Compare el dominio en vivo con lo que servía Easypanel.
  5. Solo entonces detenga el servicio en Easypanel. Conserve sus datos hasta estar seguro de que no tendrá que volver atrás.
Warning
Si un proxy de Cloudflare está delante del dominio, puede ocultar qué servidor responde. Revise las cabeceras de respuesta o una página que difiera entre los dos servidores antes de detener Easypanel.