Dokumentation

Jira

Lesen und schreiben Sie Jira-Tickets (Cloud oder Server/Data Center) aus einer Pipeline, im BYO-Modus.

Jira

Die Jira-Integration verbindet Ihren Issue-Tracker mit Ihren Pipelines: um den Projektstatus zu lesen (Tickets, Sprints, Übergänge) und um zu handeln (ein Ticket erstellen, es weiterbewegen, kommentieren). Sie funktioniert sowohl mit Jira Cloud als auch mit Jira Server / Data Center.

Was Sie damit tun können

  • Tickets durchsuchen (JQL), ein Ticket lesen, Projekte auflisten und die verfügbaren Übergänge.
  • Ein Ticket erstellen, es von einem Status in einen anderen überführen, einen Kommentar hinzufügen.
  • Einen Agenten speisen, der den Fortschritt eines Projekts zusammenfasst oder automatisch ein Ticket aus einem eingehenden Signal (E-Mail, Formular, Alarm) öffnet.

Tools und Knoten

  • Lese-Tools (einem Agenten zur Verfügung gestellt): jira.search, jira.get_issue, jira.list_projects, jira.list_transitions.
  • Schreib-Tools (mit Bestätigung): jira.create_issue, jira.transition_issue, jira.add_comment.
  • Knoten jira_report — deterministisches Lesen einer Menge von Tickets, in den Kontext veröffentlicht.
  • Knoten jira_create_issue — Ticket-Erstellung am Ausgang, mit einer Exactly-once-Garantie (kein Duplikat bei einem Retry).

Verbindung (BYO)

  1. Administration → Integrationen → Jira.
  2. Wählen Sie den Modus:
    • Jira Cloud — E-Mail + API-Token (Basic-Authentifizierung, API /rest/api/3).
    • Jira Server / Data Center — persönlicher Token (Bearer-Authentifizierung, API /rest/api/2).
  3. Der Host ist auf https festgelegt und Ticket-/Projektschlüssel werden validiert (Anti-SSRF-Schutz). Zugangsdaten sind ruhend verschlüsselt und auf Ihre Organisation begrenzt.

Jira ist ein strikter BYO-Konnektor: kein Metering, keine betool-Marge. Sie nutzen Ihre eigene Instanz und Ihre eigenen Jira-Berechtigungen.

Anwendungsfälle

  • Support → Ticket — eine eingehende, von einem Agenten qualifizierte E-Mail erstellt automatisch ein Jira-Ticket im richtigen Projekt.
  • Fortschrittsbericht — jeden Morgen liest eine Pipeline die offenen Tickets und sendet dem Team ein lesbares Status-Update.