Una fase di Jenkins si riferisce a una fase di una pipeline di Jenkins. Le fasi ci consentono di raggruppare una serie di compiti in una singola entità e di fare riferimento a un identificatore univoco. Usando le fasi di Jenkins, possiamo visualizzare e tracciare l'avanzamento della build della pipeline usando l'identificatore specificato. Può anche aiutarci a monitorare gli errori nei registri.
Ad esempio, possiamo avere una pipeline con tre fasi: build, test e distribuzione. Ogni fase contiene una o più attività necessarie per completare le attività impostate. Ad esempio, nella fase di costruzione, possiamo avere attività come l'installazione delle dipendenze necessarie, la configurazione delle directory, ecc.
Nella fase di test, possiamo eseguire i test richiesti per quel progetto e pubblicare i risultati dei test utilizzando strumenti come report HTML, cetriolo, ecc.
Infine, nella fase di distribuzione, possiamo avere compiti come l'accesso a un server remoto, l'esecuzione di uno script di configurazione e altri passaggi.
Quando eseguiamo la pipeline, Jenkins esegue le attività in ogni fase dell'ordine in cui sono definiti al completamento. Se uno dei passaggi in una determinata fase fallisce, l'intera build non riesce e non vengono eseguite altre fasi.
Jenkins Stage Block
In un Jenkinsfile, possiamo definire le fasi usando le fasi e il blocco delle fasi. Il blocco delle fasi ci consente di dire a Jenkins che i prossimi blocchi contengono le fasi che desideriamo eseguire nella build.
Usiamo quindi il blocco stage per definire un insieme distinto di attività che vengono eseguite in pipeline.
Una sintassi di esempio è la seguente:
tubatura
agente qualsiasi
fasi
Stage ('build')
Passaggi
// Attività da eseguire vanno qui
stadio ('test')
Passaggi
// Attività di test
Stage ('Disploy')
Passaggi
// Attività di distribuzione
Ogni fase deve contenere uno o più passaggi che sono i singoli compiti che vengono eseguiti nel contesto dello stadio. Ad esempio, è possibile definire i passaggi utilizzando una delle funzioni del passaggio disponibili come SH per eseguire un comando shell, uno script groovy o git per eseguire un comando git.
È possibile controllare la documentazione e il supporto del plug -in per apprendere le capacità di Jenkins.
Esempio:
L'esempio seguente mostra una semplice pipeline con una singola fase:
tubatura
agente qualsiasi
fasi
Stage ('versione')
Passaggi
script
def jenkinsversion = hudson.modello.Hudson.esempio.versione
println "versione jenkins: $ jenkinsversion"
La pipeline precedente definisce una singola fase chiamata "versione" che contiene un singolo passaggio che esegue uno script groovy. Lo script usa Hudson.modello.Classe Hudson per ottenere la versione Jenkins e stamparla utilizzando la funzione println.
Una volta eseguita la pipeline precedente, dovremmo vedere la versione Jenkins installata nell'output della console.
Conclusione
Questo post copre su come creare e utilizzare le fasi in una pipeline di Jenkins. Le fasi ci consentono di raggruppare i compiti con un'unica entità per una gestione e monitoraggio più facili.