Automatisierte Zuweisung von GitHub-Issues via Befehlseingabe - n8n-Workflow

Entwicklungsteams: Die ihren Issue-Triage-Prozess straffen möchten.
Open-Source-Maintainer: Die die Zuweisung für freiwillig meldende Mitwirkende automatisieren möchten.
n8n Automatisierungsspezialisten: Die daran interessiert sind, komplexe bedingte Routings innerhalb eines n8n-Workflows zu nutzen.
DevOps-Profis: Die eine zuverlässige, befehlsbasierte Interaktion mit GitHub benötigen.

Die Verwaltung von Zuweisungen in GitHub-Repositories mit hohem Volumen kann zeitaufwendig sein. Dieser robuste n8n-Workflow löst dieses Problem, indem er es Benutzern ermöglicht, Issues einfach durch Eingabe eines Befehls, wie z. B. 'assign me', entweder im ursprünglichen Issue-Text oder in einem nachfolgenden Kommentar, selbst zuzuweisen. Die zugrunde liegende n8n-Logik stellt sicher, dass ein Issue nur zugewiesen wird, wenn es derzeit nicht zugewiesen ist, wodurch Konflikte vermieden werden. Versucht ein Benutzer, ein bereits zugewiesenes Issue zu beanspruchen, antwortet die Automatisierung mit einem hilfreichen Kommentar, um Transparenz zu gewährleisten. Diese spezifische n8n-Template-Implementierung demonstriert eine leistungsstarke Ablaufsteuerung und vereinfacht die Koordination von Entwicklungsaufgaben.

Der gesamte Prozess beginnt mit dem n8n-Trigger 'Github Trigger1', der so konfiguriert ist, dass er auf neue Issues (Ereignis issues) oder neue Kommentare (Ereignis issue_comment) lauscht.

1. Trigger und Weiterleitung: Wenn ein Ereignis eintritt, fließen die Daten in den n8n-Workflow ein. Der n8n-Knoten 'Switch' analysiert die Ereignisaktion (z. B. 'opened' für ein Issue oder 'created' für einen Kommentar).


2. Zuweisung neuer Issues: Wenn die Aktion 'opened' ist, bewegt sich der Ablauf zu 'IF no assignee?'. Dieser bedingte n8n-Knoten prüft, ob das Issue nicht zugewiesen ist UND ob der Issue-Text den Regex-Befehl /assign me/gm enthält. Wenn beides zutrifft, weist der n8n-Knoten 'Assign Issue Creator' das Issue der Person zu, die es erstellt hat, und wendet ein 'assigned'-Label an.


3. Versuch der Zuweisung über Kommentar: Wenn die Aktion 'created' ist (ein neuer Kommentar), bewegt sich der Ablauf zu 'IF wants to work?'. Dieser n8n-Knoten prüft, ob der Kommentartext den Regex-Befehl /assign me/gm enthält.


4. Konfliktprüfung: Wenn der Kommentar die Zuweisungsphrase enthält, fährt der Ablauf mit 'IF not assigned?' fort. Dieser bedingte n8n-Knoten prüft den aktuellen Zuweisungsstatus.


5. Zuweisung oder Benachrichtigung: Ist das Issue nicht zugewiesen, weist der n8n-Knoten 'Assign Commenter' das Issue dem Kommentator zu. Ist das Issue bereits zugewiesen, postet der n8n-Knoten 'Add Comment' automatisch eine Antwort, die den Kommentator darüber informiert, dass das Issue bereits vergeben ist, und erwähnt den aktuellen Bearbeiter. Alle anderen nicht übereinstimmenden Ereignisse oder Aktionen führen zu einem n8n-Knoten 'No Operation, do nothing', wodurch dieser spezifische Ausführungspfad kontrolliert beendet wird.

Um diesen leistungsstarken n8n-Workflow bereitzustellen, gehen Sie wie folgt vor:

1. Importieren: Kopieren Sie den bereitgestellten JSON-Code und importieren Sie ihn direkt über das Menü 'Workflows' in Ihre n8n-Instanz, indem Sie 'Neu' und 'Aus JSON importieren' auswählen.


2. GitHub-Zugangsdaten: Sie benötigen gültige in n8n eingerichtete GitHub OAuth2-Zugangsdaten. Stellen Sie sicher, dass diese Zugangsdaten mit den folgenden n8n-Knotenkomponenten verknüpft sind: 'Github Trigger1', 'Assign Issue Creator', 'Add Comment' und 'Assign Commenter'.


3. Trigger konfigurieren: Ersetzen Sie im n8n-Trigger-Knoten 'Github Trigger1' [username] und [reponame] durch den tatsächlichen Besitzer und den Namen des Repositorys, das Sie überwachen möchten.


4. Aktivierung: Sobald die Zugangsdaten und Repository-Details konfiguriert sind, aktivieren Sie den n8n-Workflow, indem Sie den Schalter auf 'Aktiv' stellen.


5. Webhook-Einrichtung: Wenn Sie eine selbst gehostete n8n-Instanz verwenden, stellen Sie sicher, dass die GitHub-Webhook-URL in Ihren Repository-Einstellungen korrekt konfiguriert ist, um auf Ihren n8n-Trigger-Endpunkt zu verweisen.

Diese n8n-Vorlage stützt sich für ihre Logik auf mehrere Schlüsselkomponenten des n8n-Knotens:

Github Trigger1 (n8n-Trigger): Der Einstiegspunkt. Lauscht auf die Ereignisse issue_comment und issues, um sicherzustellen, dass der n8n-Workflow sowohl bei neuen Issues als auch bei nachfolgenden Kommentaren aktiviert wird.
Switch (n8n-Knoten): Leitet die Ausführung basierend auf der Ereignisaktion ('opened' vs. 'created') und definiert so die Kernpfade des n8n-Workflows.
IF no assignee? (n8n-Knoten): Ein bedingter n8n-Knoten, der zwei Schlüsselparameter für neue Issues prüft: ob das Issue null Zuweisungen hat (assignees.length gleich 0) und ob der Issue-Text dem Regex-Befehl /assign me/gm entspricht.
Assign Issue Creator (GitHub n8n-Knoten): Dient dazu, ein Issue dem user.login zuzuweisen, der es erstellt hat, und wendet das Label 'assigned' an.
IF wants to work? (n8n-Knoten): Prüft, ob ein Kommentar den Regex-Befehl /assign me/gm enthält, bevor fortgefahren wird.
IF not assigned? (n8n-Knoten): Führt eine abschließende Prüfung bei Versuchen der Zuweisung über Kommentare durch, um sicherzustellen, dass das Issue nicht bereits zugewiesen ist.
Assign Commenter (GitHub n8n-Knoten): Weist das Issue dem Kommentator zu, der es angefordert hat, und nutzt damit erfolgreich diese Funktion des n8n-Workflows.
Add Comment (GitHub n8n-Knoten): Wird ausgeführt, wenn ein Zuweisenkonflikt erkannt wird, und postet eine hilfreiche Benachrichtigung zurück an das GitHub Issue.