Creare ticket jira da jenkins

Jira

Informazioni sul plugin

Questo plugin integra con Jenkins il software Atlassian Jira (sia in versione Cloud che Server). Per le segnalazioni di bug, consulta i bug o tutti i problemi aperti. Per la documentazione, vedere il sito ufficiale del plugin.

Compatibilità

Per la compatibilità del plugin con il plugin Pipeline, vedere COMPATIBILITÀ.

Configurazione del plugin

Configurazione per Jira Cloud

Con Atlassian Jira Cloud, non è possibile creare un utente senza un'e-mail, quindi è necessario creare un token API che verrà utilizzato come utente del servizio da Jenkins per eseguire chiamate API a Jira Cloud - seguire la documentazione

dei token API di Atlassian Quindi crea una credenziale Jenkins globale:

  • inserisci l'e-mail ID Atlassian come nome utente
  • Token API come password.

Puoi verificare se il tuo token API funziona correttamente ottenere una risposta corretta al problema JSON con questo comando (dove TEST-1 è un problema di esempio nel tuo progetto):

curl -X GET -u <email> :<API token> -H "Content-Type: application/json" https://<YourCloudInstanceName> .atlassian.net/rest/api/latest/issue/TEST-1

Proprietà del sistema

  • -Dhudson.plugins.jira.JiraMailAddressResolver.disabled=true

    Utilizzare per disabilitare la risoluzione delle e-mail degli utenti dai nomi utente Jira. Attualmente non è disponibile alcuna opzione per questa opzione nell'interfaccia utente.

Utilizzo dell'API REST di Jira

: questo plug-in dispone di una funzionalità opzionale per aggiornare i problemi di Jira con un puntatore all'indietro alle pagine di build di Jenkins. Ciò consente al mittente e agli osservatori di scoprire rapidamente quale build devono scegliere per ottenere la correzione.

Quando

configuri il tuo sito Jira in Jenkins, il plugin collega automaticamente tutti i nomi dei problemi corrispondenti a Jira.

Se hai fornito anche nome utente/password a Jira, i collegamenti ipertestuali conterranno anche suggerimenti con il riepilogo del problema.

Aggiornamento dei problemi di Jira con i puntatori all'indietro

Se desideri utilizzare anche questa funzione, devi fornire un ID utente/password valido. Se hai bisogno che il commento sia visibile solo a un determinato gruppo Jira, ad esempio Sviluppo software , inserisci il nome del gruppo.

A questo punto è necessario configurare anche i processi. Ho pensato che potresti non avere sempre accesso in scrittura a Jira (diciamo che hai una build Jenkins per uno dei progetti Apache commons da cui dipendi), quindi ecco perché questo è opzionale.

La schermata seguente mostra come viene aggiornato un problema Jira:

Sfruttando la funzione dell'impronta digitale di Jenkins, quando gli altri progetti che dipendono da questo progetto riprendono una build con una correzione, quei numeri di build può anche essere registrato in Jira.

Questo è molto utile quando un bug viene corretto in una delle librerie, ma il mittente vuole una correzione in un progetto diverso. Questo accade spesso nel mio lavoro, dove viene segnalato un bug contro JAX-WS ma la correzione è in JAXB.

Per una mente curiosa, consulta questo thread per sapere come funziona dietro le quinte.

Per

fare riferimento alle versioni di Jira Release nella tua build, puoi estrarre queste versioni direttamente da Jira aggiungendo il parametro Jira Release Version.

Questo può essere utile per generare note di rilascio, trigerring di build parametrizzate, ecc.

È inoltre possibile generare note di rilascio da utilizzare durante la compilazione. Queste note possono essere recuperate da una variabile di ambiente. Consulta il plug-in del progetto Maven per le variabili d'ambiente presenti all'interno del POM.

Dopo l'esecuzione della compilazione, è possibile Fai in modo che il plugin contrassegni una versione come risolta. In genere si tratta di una versione specificata nei parametri di compilazione.

Il plugin può anche spostare alcuni problemi che corrispondono a una query JQL a una nuova versione di rilascio.

Note di

rilascio generate:

Autenticazione Jira e autorizzazioni richieste

Nota: Come regola generale, dovresti sempre utilizzare un account di servizio (invece di un account personale) per integrare Jenkins con Jira.

Assicurati che l'utente Jira utilizzato da Jenkins disponga di autorizzazioni sufficienti per eseguire le sue azioni. Puoi farlo tramite lo strumento Jira Permission Helper.

  • Per creare problemi Jira, l'utente deve essere in grado di creare problemi nel progetto specificato
  • Se si immettono inoltre i valori dei campi assegnatario o componente, assicurarsi che: - entrambi i campi siano assegnati alla schermata Jira corrispondente - l'utente Jira è assegnabile nel progetto: l'utente Jira Jenkins può assegnare problemi

Risorse correlate

Problemi comuni

Jenkins<> problemi di connettività SSL Jira

Se si verifica lo stacktrace in questo modo:

assicurarsi che il JRE/JDK in esecuzione nel master Jenkins (o negli slave Jenkins) contenga i certificati della catena CA validi con cui è in esecuzione Jira. Puoi testarlo usando questa classe SSLPoke.java:

$ wget -O SSLPoke.java https://gist.githubusercontent.com/warden/e4ef13ea60f24d458405613be4ddbc51/raw/7f258a30be4ddea7b67239b40ae305f6a2e98e0a/SSLPoke.java $ /usr/java/jdk1.8.0_131/bin/javac SSLPoke.java $ /usr/java/jdk1.8.0_131/jre/bin/java SSLPoke jira.domain.com 443 Connesso con successo

Riferimenti:

Qualcosa non funziona?

Contribuisci o Sponsorizza!

Tutti noi amiamo l'Open Source, ma... Il software open source si basa su contributi di altri sviluppatori. Per favore contribuisci aprendo le Richieste Pull o, se non sei uno sviluppatore, considera di sponsorizzare uno dei manutentori.

Le proposte di

nuove funzionalità e le proposte di correzione di bug devono essere inviate come richieste pull. Quando si aggiungono nuove funzionalità, assicurarsi che supportino Jenkins Pipeline Plugin - vedere COMPATIBILITY.md per ulteriori informazioni

Test

Ci sono stati molti sviluppatori coinvolti nello sviluppo di questo plugin e ci sono molti utenti a valle che dipendono da esso. I test ci aiutano a garantire che stiamo fornendo un plugin affidabile e che abbiamo comunicato il nostro intento ad altri sviluppatori in modo che possano rilevarlo quando eseguono i test.

  • Nel
  • caso in cui non sia possibile testare tramite un test unitario, dovrebbe essere testato su un'istanza Jira reale, possibilmente sia Jira Server che Jira Cloud. C'è un'istanza di test di Jira Cloud che stiamo utilizzando per testare le versioni del plug-in: faccelo sapere nella richiesta di pull nel caso in cui tu abbia bisogno di accedere per il test.

Vedi

MANUTENTORI per alcune informazioni utili.