Documentazione

Jira

Leggi e scrivi ticket Jira (Cloud o Server/Data Center) da una pipeline, in modalità BYO.

Jira

L'integrazione Jira collega il tuo issue tracker alle tue pipeline: per leggere lo stato di un progetto (ticket, sprint, transizioni) e per agire (creare un ticket, farlo avanzare, commentare). Funziona sia con Jira Cloud sia con Jira Server / Data Center.

Cosa puoi farci

  • Cercare ticket (JQL), leggere un ticket, elencare i progetti e le transizioni disponibili.
  • Creare un ticket, farlo transitare da uno stato a un altro, aggiungere un commento.
  • Alimentare un agent che sintetizza l'avanzamento di un progetto o apre automaticamente un ticket a partire da un segnale in ingresso (email, modulo, allerta).

Strumenti e nodi

  • Strumenti di lettura (messi a disposizione di un agent): jira.search, jira.get_issue, jira.list_projects, jira.list_transitions.
  • Strumenti di scrittura (con conferma): jira.create_issue, jira.transition_issue, jira.add_comment.
  • Nodo jira_report — lettura deterministica di un insieme di ticket, pubblicata nel contesto.
  • Nodo jira_create_issue — creazione di ticket in uscita, con garanzia exactly-once (nessun duplicato in caso di retry).

Connessione (BYO)

  1. Amministrazione → Integrazioni → Jira.
  2. Scegli la modalità:
    • Jira Cloud — email + token API (autenticazione Basic, API /rest/api/3).
    • Jira Server / Data Center — token personale (autenticazione Bearer, API /rest/api/2).
  3. L'host è bloccato su https e le chiavi dei ticket/progetti vengono validate (protezione anti-SSRF). Le credenziali sono cifrate a riposo e circoscritte alla tua organizzazione.

Jira è un connettore BYO rigoroso: nessun metering, nessun margine betool. Usi la tua stessa istanza e i tuoi permessi Jira.

Casi d'uso

  • Supporto → ticket — un'email in ingresso qualificata da un agent crea automaticamente un ticket Jira nel progetto giusto.
  • Report di avanzamento — ogni mattina, una pipeline legge i ticket aperti e invia al team un aggiornamento di stato leggibile.