Guía de migración de n8n v2

La espera ha terminado. n8n v2.0 ha aterrizado oficialmente, trayendo el tan esperado Autoguardado (Autosave), una mejora masiva de rendimiento y un flujo de trabajo "Borrador vs. Publicar" (Draft vs. Publish) que cambia para siempre la forma en que construimos automatizaciones.

Si alojas n8n en Zeabur, aquí tienes una guía completa. Actualizar tu instancia es generalmente sencillo, pero debido a que la v2 trae algunos cambios arquitectónicos (especialmente para los usuarios de Python), hay tres caminos diferentes a seguir dependiendo de cómo utilices los nodos de Código (Code nodes).

Aquí te explicamos cómo migrar tu proyecto en Zeabur de forma segura.

---

🚀 ¿Solo quieres empezar de cero?

Si prefieres empezar desde cero en lugar de migrar una instancia existente, hemos lanzado una Plantilla Estática de n8n v2 preconfigurada. Viene optimizada para Zeabur lista para usar.

Desplegar Plantilla n8n v2 en Zeabur →

---

Camino 1: El Usuario "Básico" (Actualización Estándar)

¿Para quién es esto?

• Utilizas nodos estándar de n8n (Webhooks, HTTP Requests, Google Sheets, etc.).
• Utilizas JavaScript en tus nodos de Código.
• No utilizas Python en tus nodos de Código.

Si esto te describe, el proceso de actualización en Zeabur es increíblemente simple.

Cómo actualizar:

1. Inicia sesión en tu Dashboard de Zeabur.
2. Haz clic en tu servicio n8n.
3. Ve a la pestaña Settings (Configuración).
4. Busca el campo Image Tag.
5. Cambia la etiqueta de tu versión actual (o latest) a 2.1.4 (o la versión más reciente disponible).
6. Zeabur redesplegará tu servicio automáticamente.

Eso es todo. Una vez que el servicio se reinicie, verás la nueva interfaz v2.

⚠️ Importante: Incluso para usuarios básicos, la v2 tiene cambios disruptivos (breaking changes) respecto a cómo fluyen los datos entre sub-flujos de trabajo. Recomendamos encarecidamente leer la Guía Oficial de Cambios Disruptivos antes de cambiar.

---

Camino 2: El Usuario "Pyodide" (Soporte Legacy de Python)

¿Para quién es esto?

• Actualmente utilizas Python en tus flujos de trabajo.
• Estás utilizando la implementación Pyodide (el Python ligero en navegador/servidor que no requiere un ejecutor de tareas externo completo).
• Quieres mantener tu arquitectura simple actual sin desplegar Task Runners complejos.

El inconveniente: n8n v2 cambia la forma en que se maneja Python. Si simplemente actualizas la etiqueta de la imagen, tus nodos basados en Pyodide pueden fallar porque los requisitos del entorno han cambiado. Necesitas aplicar una configuración específica a tu instancia de Zeabur para mantener esta funcionalidad.

Cómo actualizar:

Hemos preparado una guía de configuración específica para este escenario. Por favor, verifica tus configuraciones y variables de entorno con la guía a continuación para asegurar que Pyodide continúe funcionando en Zeabur:

👉 Guía: Actualizando n8n v2 con Pyodide en Zeabur

Sigue los pasos en el enlace anterior para parchear tu instancia actual antes de esperar que tus flujos de trabajo en Python se ejecuten correctamente.

---

Resumen de Cambios Disruptivos (Breaking Changes)

Ya seas un usuario básico o avanzado, estos cambios de la v2 afectan a todos:

1. Datos de Sub-Workflow: Si usas el nodo "Execute Workflow", n8n ahora devuelve el resultado real del sub-flujo en lugar de pasar los datos de entrada. ¡Revisa tu salida de datos!
2. Seguridad del Nodo de Código: Por defecto, los nodos de Código ya no pueden acceder a las variables de entorno (process.env). Debes habilitar explícitamente los permisos si tu código depende de ellas.
3. Guardar vs. Publicar: Ahora tienes un estado de "Borrador" (Draft). Hacer clic en "Save" no hace que los cambios estén en vivo. Debes hacer clic en "Publish" para actualizar tus flujos de trabajo activos.

Para profundizar en cada cambio técnico, por favor consulta la documentación oficial: 📄 Documentación de Breaking Changes de n8n v2.0

---

⚡️ Guía de Decisión Rápida

¿No estás seguro de qué camino tomar? Usa esta tabla para decidir:

Característica / Uso	Camino 1: Básico	Camino 2: Pyodide	Nuevo Despliegue
Lenguaje de Código Principal	Solo JavaScript	JavaScript + Python Simple	Todos
Paquetes Pip Externos	No	No (Solo librerías estándar)	-
Necesidades de Rendimiento	Estándar	Estándar	Estándar
Acción de Migración	Actualizar Image Tag	Actualizar Tag + Aplicar Config	Usar Plantilla
Mejor Para	La mayoría de usuarios	Usuarios de Python ligero	Nuevo comienzo / Limpio

Pensamiento Final

Actualizar a la v2 en Zeabur es un gran paso adelante para la estabilidad y la experiencia del desarrollador. ¡Elige el camino que se adapte a la complejidad de tu flujo de trabajo y feliz automatización! 🚀