Utilidad de Sincronización de Flujos de Trabajo Entre Instancias - Flujo de trabajo de n8n

Arquitectos de Automatización que gestionan múltiples entornos de staging y producción de n8n.
Equipos técnicos que necesitan desplegar actualizaciones de flujos de trabajo de n8n consistentes en diferentes instancias alojadas por ellos mismos (self-hosted).
Usuarios que desean un método fiable para hacer copias de seguridad o mover plantillas específicas de n8n entre cuentas.
Cualquier persona que utilice la API de n8n para tareas administrativas y de DevSecOps.

Gestionar múltiples instancias de n8n a menudo genera desafíos de sincronización. Exportar e importar manualmente definiciones complejas de flujos de trabajo de n8n consume mucho tiempo y es propenso a errores. Esta automatización especializada de n8n lo soluciona identificando y clonando automáticamente los flujos de trabajo que existen en una instancia de origen pero faltan en una de destino.

Al aprovechar la funcionalidad nativa de los nodos de n8n y la lógica de comparación SQL dentro del nodo Merge, esta automatización garantiza una sincronización de alta fidelidad. Después de clonar el flujo de trabajo de n8n faltante, utiliza un paso avanzado de Solicitud HTTP para asignar opcionalmente el nuevo flujo de trabajo a un proyecto específico en la instancia de destino, ofreciendo un control administrativo total sobre el despliegue de sus nuevas plantillas de n8n.

Esta automatización comienza con el disparador de n8n 'When clicking Test workflow' (Al hacer clic en Probar flujo de trabajo).

1. Recuperar Flujos de Trabajo: El flujo de trabajo de n8n se bifurca inmediatamente, consultando simultáneamente el nodo n8n GET - Workflows para obtener los flujos de trabajo de la instancia de origen y el nodo n8n GET - Destination Workflows para los flujos de trabajo de la instancia de destino.


2. Preparar Datos: Los datos de ambas instancias se separan utilizando las variantes del nodo n8n Split Out Workflows.


3. Identificar Flujos de Trabajo Faltantes: La lógica central reside en el nodo n8n Merge Workflows, que utiliza una comparación SQL de LEFT JOIN. Compara los nombres de los flujos de trabajo del origen (Entrada 1) con los del destino (Entrada 2). La cláusula WHERE input2.name IS NULL garantiza que solo se pasen aquellos flujos de trabajo que existen en el origen pero faltan en el destino.


4. Procesamiento por Lotes: El nodo n8n Loop Over Items procesa los flujos de trabajo identificados en lotes pequeños (5 elementos por lote).


5. Crear Flujo de Trabajo: Para cada flujo de trabajo faltante, el nodo n8n CREATE - Workflow utiliza la credencial de la API de n8n para la instancia de destino para recrear el flujo de trabajo, incluyendo sus nodos, conexiones y configuraciones.


6. Asignación de Proyecto (Opcional): Tras la creación, el flujo de trabajo encuentra dinámicamente un ID de proyecto objetivo en la instancia de destino mediante Solicitudes HTTP y filtrado. Finalmente, el nodo PUT - Workflow in Project transfiere el flujo de trabajo de n8n recién creado al proyecto especificado.

Para desplegar este potente flujo de trabajo de n8n y gestionar sus plantillas de n8n, siga estos pasos:

1. Importar el JSON: Copie el código JSON del flujo de trabajo de n8n proporcionado e impórtelo en su instancia de n8n usando el menú 'New' (Nuevo) -> 'Import from JSON' (Importar desde JSON).


2. Configuración de Credenciales de Instancia de Origen: Localice el nodo n8n GET - Workflows. Actualice la credencial 'API de n8n' (etiquetada como 'AK n8n original account' en la plantilla) para que apunte a su instancia de n8n de Origen.


3. Configuración de Credenciales de Instancia de Destino: Actualice las credenciales 'API de n8n' utilizadas por GET - Destination Workflows y CREATE - Workflow (etiquetadas como 'AlexK1919 n8n ent account' en la plantilla) para que apunten a su instancia de n8n de Destino.


4. Claves API: Asegúrese de que las credenciales configuradas tengan los permisos necesarios (normalmente permisos 'All' - Todos) para listar y crear elementos de flujo de trabajo de n8n.


5. Configurar el Filtro de Proyecto (Opcional): Si desea utilizar la función de asignación de proyecto, navegue hasta el nodo n8n Filter Project y cambie el rightValue en la condición para que coincida con el nombre exacto del proyecto al que desea transferir el nuevo flujo de trabajo de n8n en la instancia de destino.

Este flujo de trabajo de n8n se basa en nodos principales y en la API de n8n:

Al hacer clic en 'Test workflow' (Disparador Manual): El disparador esencial de n8n para iniciar el proceso de clonación. Se utiliza para pruebas de sincronización inmediatas.
GET - Workflows / GET - Destination Workflows (Nodo n8n): Utiliza el recurso de la API de n8n para recuperar todos los flujos de trabajo de las respectivas instancias de origen y destino.
Merge Workflows (Nodo Merge): Crucial para el control de la lógica. Utiliza el modo Combinar por SQL con un LEFT JOIN para filtrar cualquier flujo de trabajo de n8n que ya exista en la instancia de destino basándose en el nombre del flujo de trabajo.
CREATE - Workflow (Nodo n8n): El nodo de acción final, responsable de publicar la definición JSON completa del flujo de trabajo de n8n faltante en la API de la instancia de destino.
Filter Project (Nodo Filter): Se utiliza para identificar un ID de Proyecto específico en la instancia de destino haciendo coincidir el nombre del proyecto (ej. 'z Original n8n Workflows from AlexK1919').
PUT - Workflow in Project (Nodo HTTP Request): Un nodo avanzado de utilidad de n8n que realiza una llamada a la API para transferir el flujo de trabajo de n8n recién creado a un contenedor de proyecto específico.