Utilitário de Sincronização de Fluxos de Trabalho Entre Instâncias - Fluxo de trabalho n8n

Arquitetos de Automação que gerem múltiplos ambientes de staging e produção n8n.
Equipas Técnicas que necessitam de implementar atualizações consistentes de fluxos de trabalho n8n em diferentes instâncias autoalojadas.
Utilizadores que pretendam um método fiável para fazer cópias de segurança ou mover modelos n8n específicos entre contas.
Qualquer pessoa que utilize a API n8n para tarefas administrativas e de DevSecOps.

Gerir múltiplas instâncias n8n resulta frequentemente em desafios de sincronização. Exportar e importar manualmente definições complexas de fluxos de trabalho n8n é moroso e propenso a erros. Este fluxo de trabalho n8n especializado resolve isto, identificando e clonando automaticamente os fluxos de trabalho presentes numa instância de origem mas ausentes numa instância de destino.

Ao alavancar a funcionalidade nativa dos nós n8n e a lógica de comparação SQL dentro do nó Merge (Junção), esta automação garante uma sincronização de alta fidelidade. Após clonar o fluxo de trabalho n8n em falta, utiliza um passo avançado de Pedido HTTP (HTTP Request) para atribuir opcionalmente o novo fluxo de trabalho a um projeto específico na instância de destino, oferecendo controlo administrativo total sobre a implementação dos seus novos modelos n8n.

Esta automação começa com o acionador n8n 'Ao clicar em Testar fluxo de trabalho' (When clicking Test workflow).

1. Obter Fluxos de Trabalho: O fluxo de trabalho n8n ramifica imediatamente, consultando simultaneamente o nó n8n GET - Workflows para os fluxos de trabalho da instância de origem e o nó n8n GET - Destination Workflows para os fluxos de trabalho da instância de destino.


2. Preparar Dados: Os dados de ambas as instâncias são separados utilizando as variantes do nó n8n Split Out Workflows (Dividir Fluxos de Trabalho).


3. Identificar Fluxos de Trabalho em Falta: A lógica central reside no nó n8n Merge Workflows (Junção de Fluxos de Trabalho), que utiliza uma comparação SQL LEFT JOIN. Compara os nomes dos fluxos de trabalho da origem (Entrada 1) com os do destino (Entrada 2). A cláusula WHERE input2.name IS NULL garante que apenas os fluxos de trabalho que existem na origem mas estão ausentes no destino são passados adiante.


4. Processamento em Lote: O nó n8n Loop Over Items (Ciclar Sobre Itens) processa os fluxos de trabalho identificados em pequenos lotes (5 itens por lote).


5. Criar Fluxo de Trabalho: Para cada fluxo de trabalho em falta, o nó n8n CREATE - Workflow (Criar Fluxo de Trabalho) utiliza as credenciais da API n8n da instância de destino para recriar o fluxo de trabalho, incluindo os seus nós, ligações e configurações.


6. Atribuição de Projeto (Opcional): Após a criação, o fluxo de trabalho encontra dinamicamente um ID de projeto de destino na instância de destino utilizando Pedidos HTTP e filtragem. Finalmente, o nó n8n PUT - Workflow in Project (Colocar Fluxo de Trabalho no Projeto) transfere o fluxo de trabalho n8n recém-criado para o projeto especificado.

Para implementar este potente fluxo de trabalho n8n e gerir os seus modelos n8n, siga estes passos:

1. Importar o JSON: Copie o código JSON do fluxo de trabalho n8n fornecido e importe-o para a sua instância n8n utilizando o menu 'Novo' -> 'Importar de JSON'.


2. Configuração das Credenciais da Instância de Origem: Localize o nó n8n GET - Workflows. Atualize a credencial 'API n8n' (rotulada como 'AK n8n original account' no modelo) para apontar para a sua instância n8n de Origem.


3. Configuração das Credenciais da Instância de Destino: Atualize as credenciais 'API n8n' utilizadas por GET - Destination Workflows e CREATE - Workflow (rotuladas como 'AlexK1919 n8n ent account' no modelo) para apontar para a sua instância n8n de Destino.


4. Chaves de API: Certifique-se de que as credenciais configuradas têm as permissões necessárias (geralmente permissões Todas) para listar e criar itens de fluxo de trabalho n8n.


5. Configurar Filtro de Projeto (Opcional): Se pretender utilizar a funcionalidade de atribuição de projeto, navegue até ao nó n8n Filter Project (Filtrar Projeto) e altere o rightValue na condição para corresponder ao nome exato do projeto para o qual pretende que o novo fluxo de trabalho n8n seja transferido na instância de destino.

Este fluxo de trabalho n8n depende de nós centrais e da API n8n:

Ao clicar em ‘Testar fluxo de trabalho’ (Acionador Manual): O acionador n8n essencial para iniciar o processo de clonagem. Utilizado para testes de sincronização imediatos.
GET - Workflows / GET - Destination Workflows (Nó n8n): Utiliza o recurso da API n8n para obter todos os fluxos de trabalho das respetivas instâncias de origem e destino.
Merge Workflows (Nó de Junção): Crucial para o controlo da lógica. Utiliza o modo Combinar por SQL com um LEFT JOIN para filtrar qualquer fluxo de trabalho n8n que já exista na instância de destino com base no nome do fluxo de trabalho.
CREATE - Workflow (Nó n8n): O nó de ação final, responsável por publicar a definição JSON completa do fluxo de trabalho n8n em falta na API da instância de destino.
Filter Project (Nó de Filtro): Utilizado para identificar um ID de Projeto específico na instância de destino ao corresponder o nome do projeto (ex: 'z Fluxos de Trabalho n8n Originais de AlexK1919').
PUT - Workflow in Project (Nó de Pedido HTTP): Um nó n8n de utilidade avançada que realiza uma chamada à API para transferir o fluxo de trabalho n8n recém-criado para um contentor de projeto específico.