Automatisierter Generator für technische Release Notes (GitHub, JIRA, Gemini) - n8n-Workflow

• DevOps- und Engineering Manager, die Lösungen für kontinuierliche Dokumentation suchen.


• Technische Projektmanager, die sofortige, zielgruppenspezifische Release-Kommunikation benötigen.


• Anwender, die nach fortgeschrittenen n8n-Vorlagen suchen, die Versionskontrolle und Projektmanagement integrieren.


• Organisationen, die nach der Code-Bereitstellung eine automatisierte Compliance-Dokumentation benötigen.

Das manuelle Synthetisieren von Commit-Nachrichten und JIRA-Tickets zu polierten, kundenorientierten Release Notes ist zeitaufwändig und fehleranfällig. Dieser spezialisierte n8n-Workflow automatisiert diesen kritischen Dokumentationsschritt vollständig. Mithilfe eines n8n-Triggers, der auf GitHub-Push-Ereignisse lauscht, beginnt der Prozess unmittelbar nach der Code-Bereitstellung. Der Workflow extrahiert intelligent zugehörige JIRA-Schlüssel aus den Commit-Nachrichten, ruft detaillierte Ticketbeschreibungen ab und speist diesen komplexen Datensatz dann in das große Sprachmodell (LLM) von Google Gemini ein. Das LLM folgt strengen Prompt-Anweisungen, um saubere, strukturierte HTML-Release Notes zu generieren, die für CxOs und nicht-technische Stakeholder geeignet sind. Diese leistungsstarke Kombination zeigt, wie die Flexibilität der n8n-Knoten die Effizienz moderner CI/CD-Pipelines drastisch verbessert, Stunden manueller Arbeit einspart und eine qualitativ hochwertige, zeitnahe Kommunikation gewährleistet.

Dieser umfassende n8n-Workflow folgt einem sequenziellen Datenanreicherungsprozess:

1. Auslösen bei Push: Der n8n-Knoten Github Trigger initiiert den Workflow bei einem push-Ereignis für einen festgelegten Branch in Ihrem Repository.


2. JIRA-Schlüssel extrahieren: Der erste n8n-Knoten Code iteriert durch die vom Trigger bereitgestellten Commit-Nachrichten und verwendet einen regulären Ausdruck, um JIRA-Issue-IDs (z. B. ABC-123) zu extrahieren.


3. JIRA-Details abrufen: Jede extrahierte JIRA-ID wird vom JIRA n8n-Knoten Get an issue verarbeitet, der die entsprechende Zusammenfassung, Beschreibung und den Status abruft.


4. Daten bereinigen und zusammenführen: Der Knoten Code2 bereinigt die umfangreichen JIRA-Ausgaben und behält nur wesentliche Felder (jiraid, jirasummary, jira_description) bei. Der n8n-Knoten Merge kombiniert diese bereinigten JIRA-Daten anschließend mit den ursprünglichen Commit-Nachrichtendaten.


5. Vorbereitung für LLM: Der n8n-Knoten Code3 aggregiert alle angereicherten Datenelemente in ein einzelnes, strukturiertes Array, das für die Einfügung in den LLM-Prompt bereit ist. Diese Vorbereitung ist entscheidend für eine effektive Verarbeitung durch generative KI.


6. Release Notes generieren: Die Basic LLM Chain verwendet das Google Gemini Chat Model (gemini-2.5-pro) und einen hochspezifischen System-Prompt. Der Prompt weist das LLM an, als technischer Release Manager zu fungieren und die gesamten Release Notes im HTML-Format zu erstellen, wobei die technischen JIRA/Commit-Daten in geschäftsfreundliche Stichpunkte umgewandelt werden.


7. Stakeholder benachrichtigen: Abschließend stellt der n8n-Knoten Send email den vom LLM generierten HTML-Inhalt per SMTP an die angegebenen Empfänger zu. Damit ist der automatisierte Dokumentationszyklus mithilfe dieses fortschrittlichen n8n-Workflows abgeschlossen.

Um diese n8n-Vorlage bereitzustellen, gehen Sie wie folgt vor:

1. Importieren: Kopieren Sie die bereitgestellten JSON-Daten und importieren Sie sie direkt in Ihre n8n-Instanz als neuen n8n-Workflow.


2. GitHub-Anmeldeinformationen: Richten Sie Ihre GitHub API-Anmeldeinformationen ein oder wählen Sie diese im n8n-Knoten Github Trigger aus. Konfigurieren Sie den Trigger so, dass er das korrekte Repository und den Ereignistyp überwacht (Standard ist push).


3. JIRA-Anmeldeinformationen: Verbinden Sie Ihre Anmeldeinformationen für das JIRA Software Cloud-Konto mit dem n8n-Knoten Get an issue.


4. Google Gemini Einrichtung: Richten Sie Ihre Google Gemini (PaLM) API-Anmeldeinformationen ein oder wählen Sie diese für den n8n-Knoten Google Gemini Chat Model aus. Stellen Sie sicher, dass die Modellauswahl mit den Prompt-Anforderungen kompatibel ist (z. B. models/gemini-2.5-pro).


5. SMTP-Einrichtung: Konfigurieren Sie Ihre SMTP-Anmeldeinformationen für den n8n-Knoten Send email. Aktualisieren Sie die Felder To Email und From Email mit Ihren gewünschten Absender- und Empfängeradressen.


6. Aktivieren: Speichern und aktivieren Sie den n8n-Workflow. Er ist nun bereit, bei einem GitHub-Push automatisch ausgeführt zu werden.

• Github Trigger: Dies ist der zentrale n8n-Trigger. Er lauscht auf push-Ereignisse im konfigurierten Repository und liefert Rohdaten der Commits, die den Dokumentationsprozess starten.


• Code (JIRA-IDs extrahieren): Ein benutzerdefinierter n8n-Knoten, der JavaScript verwendet, um Commit-Nachrichten zu parsen und Zeichenfolgen zu extrahieren, die dem JIRA-ID-Muster entsprechen (z. B. [A-Z]+-\d+).


• Get an issue (JIRA): Ein JIRA n8n-Knoten, der so konfiguriert ist, dass er detaillierte Felder (Zusammenfassung, Beschreibung) für jeden einzelnen JIRA-Schlüssel abruft, der aus den Commits stammt.


• Merge: Ein wesentlicher n8n-Knoten zur Flusssteuerung, der die ursprünglichen Commit-Metadaten und die neu abgerufenen JIRA-Daten für eine strukturierte Eingabe in das LLM kombiniert.


• Code3 (Vorbereitung für LLM): Dieser n8n-Knoten strukturiert die zusammengeführten Daten in ein einzelnes Objekt um, das ein Array von Elementen enthält, wodurch die Nutzlast für den Eingabekontext des großen Sprachmodells optimiert wird.


• Google Gemini Chat Model: Der n8n-Knoten des KI-Dienstanbieters, hier konfiguriert mit dem leistungsstarken Modell gemini-2.5-pro zur Handhabung komplexer Generierungsaufgaben.


• Basic LLM Chain: Dieser n8n-Knoten zur Orchestrierung verwendet einen detaillierten HumanMessage-Prompt, um das Gemini-Modell anzuweisen, hochstrukturierte Release Notes im HTML-Format zu erstellen, basierend auf den kombinierten technischen Eingabedaten.


• Send email: Der letzte Aktionsknoten von n8n, zuständig für den Versand des generierten HTML-Dokuments per SMTP an die angegebenen E-Mail-Adressen.