Possiamo usare quando l'espressione in un Jenkinsfile per specificare le condizioni in base alle quali dovrebbero essere eseguiti un determinato passaggio di build o un'azione post-costruzione. Ti consente di specificare un'espressione booleana che determina se il passaggio di build o l'azione post-build dovrebbero essere eseguiti.
Questo tutorial copre le basi dell'uso dell'espressione quando si tratta di pipelines Jenkins.
Jenkins quando espressione
L'espressione di quando deve contenere almeno una condizione booleana. È inoltre possibile combinare più condizioni, ma tutte le condizioni specificate devono valutare vero per l'esecuzione del blocco.
Di seguito mostra la sintassi dell'espressione di When in Jenkins:
Quando
In questo caso, specifica l'espressione booleana che viene valutata prima di eseguire o meno il passaggio di build o l'azione post-costruzione.
Esistono diversi tipi di condizioni che è possibile utilizzare nell'espressione di quando, compresa la seguente:
Diamo un'occhiata a una pipeline di esempio su come possiamo usare l'espressione di quando in Jenkins.
Esempio 1: esempio di base
La seguente pipeline dimostra un uso di base dell'espressione di quando in Jenkins:
tubatura
agente qualsiasi
parametri
BooleanParam (nome: 'run_build', defaultValue: false)
fasi
Stage ('build')
Quando
espressione return params.Run_build
Passaggi
Echo 'Run Build è impostato su True'
Nella pipeline di esempio fornito, la fase di build viene eseguita solo quando il parametro Run_Build è vero. Per impostazione predefinita, il valore del parametro run_build è falso. In questo caso, il passaggio viene saltato come mostrato nella seguente uscita della console:
Se modifichiamo il valore del parametro Run_Build su True, il passaggio di build viene eseguito come mostrato da segue:
tubatura
agente qualsiasi
parametri
BooleanParam (nome: 'run_build', defaultValue: true)
fasi
Stage ('build')
Quando
espressione return params.Run_build
Passaggi
echo 'run build è vero'
L'output della console risultante è la seguente:
In questo caso, viene eseguito il messaggio Echo nella fase di build.
Esempio 2: usando no
Possiamo anche usare la condizione non per negare il risultato di una data espressione come dimostrato nella seguente pipeline:
tubatura
agente qualsiasi
parametri
BooleanParam (nome: 'run_build', defaultValue: false)
fasi
Stage ('build')
Quando
non
espressione return params.Run_build
Passaggi
// Build Passi vai qui
Con questa modifica, la fase di build viene eseguita solo se il parametro run_build è falso.
Esempio 3: Utilizzo del condizionale
Usando la condizione allof, tutta l'espressione specificata deve valutare a True per il passaggio.
Stage ("Esegui questo passaggio")
Quando
tutto di
espressione1
espressione2
Conclusione
L'espressione di quando Jenkins è un'affermazione condizionale che consente di specificare le condizioni in base alle quali dovrebbero essere eseguiti un passaggio di build o un'azione post-build.
Ti consente di utilizzare le espressioni booleane per controllare l'esecuzione della pipeline, rendendola più flessibile e adattabile a diversi scenari di costruzione. È possibile utilizzare l'espressione quando specificare una singola condizione o per combinare più condizioni utilizzando operatori logici come && (e) e || (O). Sentiti libero di esplorare la documentazione per ulteriori informazioni.