Dynamische GitHub-Versionskontrolle für Automatisierung - n8n-Workflow

• Automatisierungsspezialisten, die eine Versionskontrolle für ihre Projekte benötigen.
• DevOps-Teams, die Produktions- und Staging-n8n-Vorlagen verwalten.
• Benutzer, die Unterschiede zwischen ihrem aktuellen n8n-Workflow und seinem externen GitHub-Backup vergleichen müssen.
• Entwickler, die nach robusten Werkzeugen für das Änderungsmanagement ihrer n8n-Projekte suchen.

Die Verwaltung von Änderungen an entscheidender Automatisierungslogik kann ohne eine angemessene Versionskontrolle eine Herausforderung darstellen. Dieser komplexe n8n-Workflow löst dies, indem er als Versionskontrollschnittstelle fungiert und Ihre aktiven n8n-Workflows direkt mit GitHub verknüpft. Er nutzt mehrere n8n-Trigger-Webhooks zur Abwicklung von vier Schlüsseloperationen: Auflisten verfügbarer Flows, Abrufen des Workflow-Status, Vergleichen lokaler Änderungen mit GitHub und Übernehmen von Updates. Durch die Nutzung des n8n-Knotens ruft diese Lösung Live-Workflow-Daten ab, bündelt diese und verwendet anschließend den GitHub n8n-Knoten zur Verwaltung von Dateioperationen (Lesen und Commits), wodurch eine nahtlose und nachvollziehbare Entwicklungsumgebung für Ihre n8n-Vorlagen entsteht.

Dieser leistungsstarke n8n-Workflow arbeitet über vier unterschiedliche operationelle Zweige, die jeweils durch einen dedizierten n8n-Trigger-Webhook ausgelöst werden:

1. UI-Generierung (Auflisten von GitHub-Workflows): Ein Webhook-Trigger (Webhook-ideogener8r) erfasst die Anfrage. Der Flow setzt notwendige Variablen und verwendet den GitHub n8n-Knoten, um eine Liste der Workflow-Dateien abzurufen. Diese Daten werden aggregiert und an den HTML-UI n8n-Knoten übergeben, der eine funktionale Benutzeroberfläche rendert, die über den n8n-Knoten Respond with UI antwortet.


2. Workflow-Vergleich: Der Get-Workflow-Changes-Webhook initiiert einen Vergleich. Der Flow ruft zuerst die angegebene Workflow-JSON aus GitHub mithilfe des GitHub n8n-Knotens ab. Anschließend verwendet er den n8n-Knoten Get n8n Workflow, um die Live-Definition desselben n8n-Workflows von der lokalen Instanz abzurufen. Ein nachfolgender Code n8n-Knoten (ComapreNodes) führt die Logik zur Hervorhebung von Unterschieden aus, und das Ergebnis wird über eine Webhook-Antwort zurückgegeben.


3. Auflisten lokaler Workflows: Der Trigger Get-n8n-workflows verwendet den n8n-Knoten n8n | get wf1, um eine Liste aller aktiven n8n-Vorlagen auf der Instanz abzurufen. Diese Liste wird verarbeitet und über einen Webhook zur Anzeige im Bedienfeld zurückgegeben.


4. Übernehmen (Committing) von Änderungen: Der submit-form-Webhook kümmert sich um das Speichern von Aktualisierungen. Er ermittelt über den n8n-Knoten Switch1, ob der Benutzer einen bestehenden Workflow bearbeitet oder einen neuen erstellt. Beide Pfade nutzen einen n8n-Knoten, um den aktuellen Workflow-Inhalt abzurufen, bevor dieser an den entsprechenden GitHub n8n-Knoten (Commit Workflow Edit oder Commit New File) übergeben wird, um den Versionskontrollprozess abzuschließen. Jeder Commit nutzt den GitHub n8n-Knoten, um die Synchronisierung zwischen dem laufenden n8n-Workflow und dem Remote-Repository sicherzustellen.

Um diesen umfassenden n8n-Workflow bereitzustellen:

1. Importieren: Kopieren Sie die bereitgestellten JSON-Daten und fügen Sie sie in Ihre n8n-Instanz über die Funktion 'Neu' -> 'Aus JSON importieren' ein.


2. Anmeldeinformationen (Credentials): Sie müssen zwei Hauptsätze von Anmeldeinformationen einrichten:

1. Webhook-URLs: Nach der Aktivierung rufen Sie die Webhook-URLs für alle vier n8n-Trigger-Knoten (Webhook-ideogener8r, Get-Workflow-Changes, Get-n8n-workflows und submit-form) ab. Diese URLs werden von den Frontend-UI-Komponenten verwendet, die dieses Versionskontrollsystem steuern.


2. Pfade konfigurieren: Passen Sie die Parameter in den verschiedenen Set n8n-Knoteninstanzen (z. B. Set Workflow Variables, Set GH Repo and Path3) an, sodass sie auf Ihren spezifischen GitHub-Repository-Namen und die gewünschten Dateipfade zum Speichern Ihrer n8n-Workflow-Dateien verweisen.

Webhook (Mehrere Trigger): Dient als Einstiegspunkt (n8n trigger) für die UI-Interaktion, Vergleichsanfragen und Commit-Übermittlungen.
Set n8n-Knoten: Wird extensiv genutzt (z. B. Set Workflow Variables, Set Flows), um Variablen wie Repository-Name, Dateipfade und Workflow-IDs zu extrahieren, umzubenennen und festzulegen, die für nachfolgende GitHub- und n8n-Knotenoperationen benötigt werden.
n8n-Knoten (z. B. n8n | get wf1, Get n8n Workflow): Unerlässlich für die Kommunikation mit der n8n-API selbst. Die Hauptfunktion besteht darin, alle vorhandenen n8n-Workflows (getAll) aufzulisten oder die JSON-Definition eines spezifischen n8n-Workflows (get) basierend auf seiner ID abzurufen.
GitHub n8n-Knoten: Erledigt alle Versionskontrolloperationen, einschließlich des Auflistens von Dateien im Repository, des Lesens des Inhalts einer gespeicherten n8n-Workflow-Datei und des Übertragens (Committing) neuer oder bearbeiteter Workflow-JSONs zurück in das Repository.
HTML n8n-Knoten: Wird im initialen Flow (HTML-UI) verwendet, um dynamisch die Benutzeroberfläche zu generieren und bereitzustellen, die mit den anderen Webhook-Endpunkten interagiert, wodurch effektiv eine dedizierte UI für die Verwaltung der n8n-Vorlagen entsteht.
Auf Webhook antworten n8n-Knoten: Gibt Daten (HTML-UI, Vergleichsergebnisse oder Commit-Bestätigungen) nach der Ausführung des n8n-Workflow-Pfades an den Benutzer oder den anfragenden Client zurück.

• Switch n8n-Knoten (Switch1): Bestimmt den Ausführungspfad während einer Übermittlung und unterscheidet zwischen der Aktualisierung einer bestehenden n8n-Workflow-Datei und der Erstellung einer neuen im GitHub-Repository.