Jenkinsfile ArchiveArtifacts

Jenkins bygger gjenstander refererer til filene generert av en spesifikk Jenkins -bygg og lagres på ett sted, slik at de kan arkiveres og deles med andre teammedlemmer eller distribueres til test- og produksjonsmiljøer.

Noen eksempler på bygningsgjenstander inkluderer kompilerte kjørbare filer, biblioteker og pakkefiler, samt dokumentasjon, testresultater og andre filer produsert som en del av byggeprosessen. Bygg gjenstander lagres hovedsakelig i et depot eller gjenstandsansvarlig, for eksempel Nexus eller Artifactory, hvor de kan nås og brukes av andre bygge- og distribusjonsprosesser.

Artifact -arkivering i Jenkins kan defineres som arkivering av byggegenskaper i et depot eller gjenstandsansvarlig, og letter tilgang og bruk av andre bygge- og distribusjonsprosesser.

Du kan spesifisere gjenstandsfilene du ønsker å arkivere under jobbkonfigurasjonsprosessen. Du definerer også hvor du ønsker å lagre de arkiverte gjenstandene.

Når Jenkins -jobben er fullført, vil serveren lagre de lagrede gjenstandene på det spesifiserte stedet der de kan nås og brukes etter behov.

Det er flere fordeler med artefaktarkivering i Jenkins. Ved å lagre build -gjenstander i et sentralt depot, kan du for eksempel sikre at de er tilgjengelige for alle teammedlemmer som trenger dem og spore historien til gjenstander over tid.

I tillegg kan artefaktarkivering bidra til å administrere og distribuere gjenstander til test- og produksjonsmiljøer, da du kan bruke depotet til å lagre forskjellige versjoner av gjenstander og raskt hente en bestemt versjon.

Denne opplæringen vil dekke hvordan vi kan jobbe og bruke arkiveringens blokkering i Jenkins -jobben.

Jenkins ArchiveArtifacts

Følgende viser syntaksen til Jenkins ArchiveArtifacts -blokken:

trinn
ArchiveArtifacts Artifacts: Alternativer

Blokken godtar forskjellige alternativer som vist:

1. Gjenstander - Dette lar deg spesifisere gjenstandene du ønsker å arkivere. Dette er en strengtype; du definerer det som et bokstavelig eller jokertegn. Husk at dette følger maurfilset -wildcard -formatet. Derfor, spesialtegn som komma som behandlet som en separator. Du kan sjekke dokumentasjonen for å lære mer.
2. TillatEmptyarchive - Dette boolske alternativet avgjør om Jenkins vil opprette arkivet selv om ingen gjenstander er tilgjengelige. Som standard er denne verdien satt til falsk, noe som betyr at bygningen vil mislykkes hvis ingen gjenstander er tilgjengelige.
3. tilfellersfølsomme - Et boolsk alternativ spesifiserer om gjenstandsarkiveren er case-sensitiv. Som standard er denne verdien satt til sann. Derfor filfilen.tjære og fil.tjære er forskjellige filnavn.
4. StandardExclude - Dette er en annen boolsk parameter som lar deg ekskludere standardgjenstander.
5. Ekskluderer - Denne parameteren er en strengtype som lar deg definere filene du ønsker å utelukke fra arkivet. Du kan også bruke jokertegn som spesifisert av maurfilsetten.
6. Fingeravtrykk - Hvis den er satt til True, vil Jenkins lage et fingeravtrykk for hver gjenstand som kan brukes til å skille gjenstandene over tid.
7. FølgSYMLINKS - Dette gjør at arkiveren kan følge symbolske lenker hvis det er tilgjengelig.
8. Bare for å være - Dette lar deg spesifisere at gjenstander bare skal arkiveres hvis bygningen er vellykket.

Nå som vi har brutt ned alternativene til ArchiveArtifacts -blokken i Jenkins, la oss utforske hvordan vi kan bruke den.

Eksempelbruk

Følgende eksempel viser hvordan du bruker arkivarteringsblokken for å lage et arkiv med kjørbare filer fra et Rust -prosjektbygging.

rørledning
agent noen
Stadier
scene ('build')
trinn
sh 'curl -proto "= https" - -tlsv1.2 -ssf https: // sh.Rustup.RS | sh -s --y '
sh 'ekko' eksportbane = $ hjem/.Last/bin: $ bane ">> $ Bash_env '
// Bygg programmet
Sh 'Cargo Build -Release'


scene ('arkivartefakter')
trinn
// Arkiv den kjørbare
ArchiveArtifacts Artifacts: 'Target/Release/Hello_World', Fingerprint: True

Rørledningen over har to stadier: et "bygg" -trinn og et "arkivartefakter" -trinn.

"Build" -stadiet installerer Rust, legger det til banen og bygger deretter programmet ved hjelp av Cargo Build -kommandoen.

"Archive Artifacts" -stadiet arkiverer deretter den kjørbare filen produsert av byggeprosessen (Target/Release/Hello_World) som en Build Artifact.

Vi setter også fingeravtrykkalternativet til True, slik at Jenkins kan lage et fingeravtrykk for gjenstanden.

Denne rørledningen antar rustprosjektet og lasten.Toml -filer er lokalisert i roten til Jenkins arbeidsområde.

Konklusjon

Denne opplæringen lærte oss om Jenkins ArchiveArtifact -blokken, de forskjellige alternativene vi kan bruke og mer. Vi ga også et praktisk eksempel som viser hvordan vi kan bruke ArchiveArtifact -blokken for å lage et arkiv med binære gjenstander fra Build.