Control de Versiones Dinámico de GitHub para la Automatización - Flujo de trabajo de n8n

• Especialistas en automatización que requieren control de versiones para sus proyectos.
• Equipos de DevOps que gestionan plantillas de n8n de producción y preproducción (staging).
• Usuarios que necesitan comparar las diferencias entre su flujo de trabajo de n8n activo y su copia de seguridad remota en GitHub.
• Desarrolladores que buscan herramientas robustas de gestión de cambios para sus proyectos de n8n.

Gestionar los cambios en la lógica de automatización crucial puede ser complicado sin un control de versiones adecuado. Este complejo flujo de trabajo de n8n soluciona esto actuando como una interfaz de control de versiones, vinculando específicamente tus flujos de trabajo activos de n8n directamente con GitHub. Utiliza múltiples webhooks de activación de n8n para manejar cuatro operaciones clave: listar los flujos disponibles, obtener el estado del flujo de trabajo, comparar los cambios locales con GitHub y confirmar (commit) las actualizaciones. Al aprovechar el nodo de n8n, esta solución recupera los datos del flujo de trabajo en vivo, los empaqueta y luego utiliza el nodo de n8n de GitHub para gestionar las operaciones de archivos (lecturas y commits), creando un entorno de desarrollo fluido y auditable para tus plantillas de n8n.

Este potente flujo de trabajo de n8n opera a través de cuatro ramas operativas distintas, cada una iniciada por un webhook de activación de n8n dedicado:

1. Generación de IU (Listado de Flujos de GitHub): Un webhook de activación (Webhook-ideogener8r) captura la solicitud. El flujo establece las variables necesarias y utiliza el nodo de n8n de GitHub para obtener una lista de los archivos de flujo de trabajo. Estos datos se agregan y se pasan al nodo de n8n HTML-UI, que renderiza una interfaz de usuario funcional, respondiendo a través del nodo de n8n Respond with UI (Responder con IU).


2. Comparación de Flujos de Trabajo: El webhook Get-Workflow-Changes inicia una comparación. El flujo primero recupera el JSON del flujo de trabajo especificado de GitHub usando el nodo de n8n de GitHub. Luego utiliza el nodo de n8n Get n8n Workflow para obtener la definición activa del mismo flujo de trabajo de n8n desde la instancia local. Un nodo de código de n8n subsiguiente (ComapreNodes) ejecuta la lógica para resaltar las diferencias, y el resultado se devuelve mediante una respuesta de webhook.


3. Listado de Flujos de Trabajo Locales: El desencadenador Get-n8n-workflows utiliza el nodo de n8n n8n | get wf1 para recuperar una lista de todas las plantillas activas de n8n en la instancia. Esta lista se procesa y se devuelve mediante un webhook para su visualización en el panel de control.


4. Confirmación (Commit) de Cambios: El webhook submit-form se encarga de guardar las actualizaciones. Determina si el usuario está editando un flujo de trabajo existente o creando uno nuevo a través del nodo de n8n Switch1. Ambas rutas utilizan un nodo de n8n para recuperar el contenido actual del flujo de trabajo antes de pasarlo al nodo de n8n de GitHub correspondiente (Commit Workflow Edit o Commit New File) para finalizar el proceso de control de versiones. Cada commit utiliza el nodo de n8n de GitHub para garantizar la sincronización entre el flujo de trabajo activo de n8n y el repositorio remoto.

Para desplegar este completo flujo de trabajo de n8n:

1. Importar: Copia los datos JSON proporcionados y pégalos en tu instancia de n8n usando la función 'Nuevo' -> 'Importar desde JSON'.


2. Credenciales: Necesitarás configurar dos conjuntos principales de credenciales:

1. URLs de Webhook: Tras la activación, recupera las URLs de Webhook para los cuatro nodos de activación de n8n (Webhook-ideogener8r, Get-Workflow-Changes, Get-n8n-workflows y submit-form). Estas URLs son utilizadas por los componentes de la interfaz de usuario (front-end) que impulsan este sistema de control de versiones.


2. Configurar Rutas (Paths): Ajusta los parámetros en las distintas instancias del nodo Set de n8n (ejemplo: Set Workflow Variables, Set GH Repo and Path3) para que apunten al nombre específico de tu repositorio de GitHub y a las rutas de archivo deseadas para guardar tus archivos de flujo de trabajo de n8n.

Webhook (Múltiples Desencadenadores): Actúa como el punto de entrada (n8n trigger) para la interacción de la IU, las solicitudes de comparación y los envíos de commits.
Nodo Set de n8n: Se utiliza extensamente (ejemplo: Set Workflow Variables, Set Flows) para extraer, renombrar y establecer variables como el nombre del repositorio, las rutas de archivo y los IDs de flujo de trabajo necesarios para las operaciones posteriores de los nodos de GitHub y n8n.
Nodo n8n (ejemplo: n8n | get wf1, Get n8n Workflow): Esencial para la comunicación con la propia API de n8n. La función principal es listar todos los flujos de trabajo de n8n existentes (getAll) o recuperar la definición JSON de un flujo de trabajo específico de n8n (get) basándose en su ID.
Nodo n8n de GitHub: Gestiona todas las operaciones de control de versiones, incluyendo listar archivos en el repositorio, leer el contenido de un archivo de flujo de trabajo de n8n almacenado y confirmar (commit) el JSON del flujo de trabajo nuevo o editado de vuelta al repositorio.
Nodo HTML de n8n: Se utiliza en el flujo inicial (HTML-UI) para generar dinámicamente y servir la interfaz de usuario que interactúa con los otros endpoints de webhook, creando efectivamente una IU dedicada para gestionar las plantillas de n8n.
Nodo Responder a Webhook de n8n: Devuelve datos (IU HTML, resultados de comparación o confirmaciones de commit) al usuario o al cliente solicitante después de la ejecución de la ruta del flujo de trabajo de n8n.

• Nodo Switch de n8n (Switch1): Determina la ruta de ejecución durante un envío, distinguiendo entre actualizar un archivo de flujo de trabajo de n8n existente o crear uno nuevo en el repositorio de GitHub.