Jenkinsfile når uttrykk

Vi kan bruke når uttrykket i en Jenkinsfile for å spesifisere forholdene under hvilke et bestemt byggetrinn eller etter bygningshandling skal utføres. Det lar deg spesifisere et boolsk uttrykk som avgjør om byggetrinnet eller handlingen etter bygningen skal kjøres.

Denne opplæringen dekker det grunnleggende om å bruke når uttrykket når det gjelder Jenkins -rørledninger.

Jenkins når uttrykk

Når uttrykket må inneholde minst en boolsk tilstand. Du kan også kombinere flere forhold, men alle de spesifiserte forholdene må evaluere sanne for at blokken skal kjøre.

Følgende viser syntaks for når uttrykket i Jenkins:

når

I dette tilfellet spesifiserer det boolske uttrykket som blir evaluert før du kjører eller ikke kjører byggetrinnet eller etterbygget handling.

Det er flere typer forhold som du kan bruke i når uttrykket inkludert følgende:

1. Gren - Den spesifiserer et grennavn eller et vanlig uttrykk som brukes til å matche mot den nåværende grenen.
2. uttrykk - Den spesifiserer et groovy uttrykk som blir evaluert for å avgjøre om byggetrinnet eller handlingen etter bygningen skal kjøres.
3. ikke - Det negerer tilstanden som følger den.
4. alt - Den spesifiserer at alle forholdene som følger det, må være sant for byggetrinnet eller handlingen etter bygningen som skal kjøres.
5. noen av - Den spesifiserer at minst en av forholdene som følger det, må være sant for byggetrinnet eller handlingen etter bygning som skal kjøres.

La oss se på et eksempel på rørledning om hvordan vi kan bruke når uttrykket i Jenkins.

Eksempel 1: Grunnleggende eksempel

Følgende rørledning demonstrerer et grunnleggende eksempelbruk av når uttrykk i Jenkins:

rørledning
agent noen
parametere
booleanparam (navn: 'run_build', defaultValue: falsk)

Stadier
scene ('build')
når
uttrykk returparams.Run_build

trinn
Echo 'Run Build er satt til True'

I det medfølgende eksemplet rørledningen blir byggetrinnet bare utført når parameteren Run_build er sann. Som standard er verdien av parameteren RUN_BUILD FALSE. I dette tilfellet blir trinnet hoppet over som vist i følgende konsollutgang:

Hvis vi endrer verdien av RUN_BUILD -parameteren til True, utføres byggetrinnet som vist på følgende:

rørledning
agent noen
parametere
booleanparam (navn: 'run_build', defaultValue: true)

Stadier
scene ('build')
når
uttrykk returparams.Run_build

trinn
Echo 'Run Build er sant'

Den resulterende konsollutgangen er som følger:

I dette tilfellet utføres ekko -meldingen i byggetrinnet.

Eksempel 2: Bruker ikke

Vi kan også bruke ikke -tilstanden for å negere resultatet av et gitt uttrykk som demonstrert i følgende rørledning:

rørledning
agent noen
parametere
booleanparam (navn: 'run_build', defaultValue: falsk)

Stadier
scene ('build')
når
ikke
uttrykk returparams.Run_build


trinn
// Bygg skritt Gå hit

Med denne modifiseringen kjøres byggetrinnet bare hvis parameteren Run_build er falsk.

Eksempel 3: Bruke allofing betinget

Ved å bruke allof -tilstanden, må alt det spesifiserte uttrykket evaluere til sant for trinnet for å kjøre.

scene ("kjør dette trinnet")
når
alt
uttrykk1
Expression2

Konklusjon

Når uttrykket i Jenkins er en betinget uttalelse som lar deg spesifisere forholdene under hvilke et byggetrinn eller etter bygningshandling bør utføres.

Den lar deg bruke de boolske uttrykkene for å kontrollere utførelsen av rørledningen, noe som gjør den mer fleksibel og tilpasningsdyktig til forskjellige byggescenarier. Du kan bruke når uttrykket til å spesifisere en enkelt tilstand eller for å kombinere flere forhold ved hjelp av logiske operatører som && (og) og || (eller). Utforske dokumentasjonen for mer.