Slik oppretter du en ny byggejobb i Jenkins Freestyle-prosjekt
Thomas Hamilton
⚡ Smart oppsummering
Jenkins Freestyle Project er en repeterbar byggejobb som samler kildekodeutsjekking, byggetrinn og etterbyggingshandlinger i én konfigurerbar oppgave, opprettet utelukkende gjennom Jenkins webgrensesnitt uten å skrive pipeline-kode.
Hva er en Jenkins Freestyle-prosjekt?
Jenkins Freestyle-prosjekt er en repeterbar byggejobb, et skript eller en pipeline som inneholder trinn og handlinger etter bygging. Det er en forbedret jobb eller oppgave som kan strekke seg over flere operasjoner. Den lar deg konfigurere byggeutløsere og tilbyr prosjektbasert sikkerhet for din Jenkins prosjekt. Den tilbyr også programtillegg som hjelper deg med å bygge trinn og handlinger etter bygging.
Hvilke typer handlinger du kan utføre i en Jenkins Byggetrinn eller handling etter bygging er ganske begrenset. Det finnes mange standard plugins tilgjengelig i en Jenkins Freestyle-prosjektet for å hjelpe deg med å løse dette problemet.
Diagrammet nedenfor plasserer freestyle-jobben innenfor det bredere kontinuerlig integrering løkke, fra kildeutsjekking til handlingene etter bygging som rapporterer resultatet.
Forutsetninger for å opprette en Jenkins Freestyle-jobb
Før de ti trinnene nedenfor fungerer fra start til slutt, må fire ting være på plass. Å ikke ha ett av dem er den vanlige grunnen til at en første freestyle-bygging mislykkes med en rød ball i stedet for en blå.
- En løpende Jenkins kontrolleren. Jenkins lytter på port 8080 som standard. Hvis Jenkins ikke kjører ennå, følg installasjonsgjennomgang først.
- En JDK på maskinen som kjører byggingen. Det utarbeidede eksemplet kompilerer Java, så
javacmå være på PATH-en til kontrolleren eller agenten som utfører jobben. Bekreft dette med en linjejava -versionbyggetrinnet før du legger til noe annet. - Git-pluginen. Ocuco gå alternativet vises bare under Kilde Code Administrasjon når plugin-modulen er installert, gjennom Administrer Jenkins > Programtillegg.
- Et tilgjengelig arkiv. En offentlig HTTPS URL trenger ingen påloggingsinformasjon. Et privat arkiv trenger en påloggingsinformasjon lagret i Jenkins først, ellers mislykkes utsjekkingen under den aller første byggingen.
En konto hos Jobb/Opprett tillatelse er også nødvendig – på en ny enkeltbruker Jenkins administratorkontoen har den allerede.
Slik oppretter du en ny byggejobb i Jenkins
Freestyle byggejobben er et svært fleksibelt og brukervennlig alternativ. Du kan bruke den til alle typer prosjekter; det er enkelt å sette opp, og mange av alternativene vises i andre byggejobber. Nedenfor er en trinnvis prosess for å skape jobb i Jenkins.
Trinn 1) Logg inn på Jenkins
Å opprette en Jenkins freestyle-jobb, logg inn på din Jenkins dashbordet ved å besøke ditt Jenkins installasjonssti. Vanligvis vil den være lagret på localhost på http://localhost:8080 Har du installerte Jenkins i en annen bane, bruk riktig URL for å få tilgang til dashbordet ditt som vist nedenfor Jenkins eksempel på jobbskaping.
Trinn 2) Opprett nytt element
Klikk på "Nytt element« øverst til venstre på dashbordet ditt. Skjermbildet nedenfor viser hvor den lenken er plassert.
Trinn 3) Skriv inn varedetaljer
I neste skjermbilde,
- Skriv inn navnet på elementet du vil lage. Vi skal bruke "Hello world" for denne demoen.
- Velg Freestyle-prosjekt
- Klikk OK
Trinn 4) Skriv inn prosjektdetaljer
Skriv inn detaljene for prosjektet du vil teste. Konfigurasjonssiden som åpnes vises nedenfor.
Trinn 5) Gå inn i arkivet URL
Under kilde Code Administrasjon, skriv inn depotet ditt URLVi har et testarkiv plassert på https://github.com/kriru/firstJava.git
Det er også mulig for deg å bruke et lokalt depot.
Hvis GitHub-depotet ditt er privat, Jenkins vil først validere påloggingsinformasjonen din med GitHub og først deretter hente kildekoden fra GitHub-repositoriet ditt.
Trinn 6) Juster innstillingene
Nå som du har oppgitt alle detaljene, er det på tide å bygge koden. Juster innstillingene under bygge seksjon for å bygge koden på det tidspunktet du ønsker. Du kan til og med planlegge at byggingen skal skje med jevne mellomrom, til bestemte tider.
Under bygging,
- Klikk på "Legg til byggetrinn"
- Klikk på "Henrette Windows batch-kommando” og legg til kommandoene du vil utføre under byggeprosessen.
Rullegardinmenyen som viser de tilgjengelige byggetrinnene ser slik ut.
⚠️ Versjonsmerknad: nylig Jenkins utgivelser etiketterer dette området Bygg trinn snarere enn Bygge, og på Linux eller macOS agenter det tilsvarende alternativet er Utfør skalletKnappen kalles fortsatt Legg til byggetrinn.
Her har jeg lagt til java-kommandoer for å kompilere java-koden.
Jeg har lagt til følgende Windows-kommandoer:
javac HelloWorld.java java HelloWorld
Kommandoboksen med de to linjene som er skrevet inn vises nedenfor.
Trinn 7) Lagre prosjektet
Når du har lagt inn alle data,
- Klikk Påfør
- Spar prosjektet.
Trinn 8) Bygg kildekode
Nå, på hovedskjermen, klikk på Bygg nå-knappen på venstre side for å bygge kildekoden.
Trinn 9) Sjekk statusen
Etter å ha klikket på Bygg nå, kan du se statusen til bygget du kjører under Bygghistorikk.
Trinn 10) Se konsollutgangen
Klikk på byggenummeret og deretter på konsollutdata for å se statusen til byggeprosjektet du kjører. Det skal vises en vellykket melding, forutsatt at du har fulgt oppsettet riktig som vist nedenfor. Jenkins eksempel på å opprette en ny jobb.
Oppsummert har vi kjørt et HelloWorld-program som er driftet på GitHub. Jenkins henter koden fra det eksterne depotet og bygger kontinuerlig med en frekvens du definerer.
Jenkins Forklaring av seksjoner i Freestyle-prosjektkonfigurasjonen
Gjennomgangen ovenfor berører bare feltene som HelloWorld-eksemplet trenger. Selve konfigurasjonssiden er delt inn i seks skjemaseksjoner, og det å vite hva hver enkelt eier gjør de resterende alternativene mye enklere å finne.
| Seksjon | Hva den kontrollerer | Typisk innstilling |
| Informasjon | Jobbbeskrivelse, forkasting av gamle bygg, parametere og om jobben kjører på en bestemt agent | Description pluss en grense for byggeoppbevaring |
| Kilde Code Administrasjon | Hvilket repository som skal sjekkes ut og med hvilken legitimasjon og gren | Git, en HTTPS URL, gren */master or */main |
| Bygg utløsere | Hva starter byggingen automatisk | Avstem SCM, bygg med jevne mellomrom, eller en webhook fra GitHub |
| Byggemiljø | Omslag påført rundt hele bygget | Slett arbeidsområdet før byggingen starter; legg til tidsstempler i konsollloggen |
| Bygg trinn | Kommandoene som gjør jobben, kjører topp til bunn | Henrette Windows batch-kommando, eller Utfør skall |
| Handlinger etter bygging | Hva skjer etter at trinnene er fullført, uansett resultat | Archise artefaktene, publiser en testrapport, send en e-post |
To vaner sparer mye feilsøking senere. Legg til byggetrinn i den rekkefølgen de må kjøres, fordi Jenkins behandler dem ovenfra og ned og stopper ved første feil. Arkiver deretter det bygget produserer som en handling etter bygget, fordi arbeidsområdet brukes på nytt av neste bygg mens arkiverte artefakter beholdes per byggnummer.
Freestyle Project vs Pipeline: Hvilken bør du bruke?
Freestyle er ikke den eneste prosjekttypen på skjermbildet for nytt element, og det er ikke alltid den riktige. Tabellen nedenfor setter den opp mot en Rørledningsjobb på punktene som avgjør de fleste reelle valgene.
| Sammenligningspunkt | Freestyle-prosjekt | Rørledning |
| Hvordan det er definert | Nettskjemaer lagret i jobbens config.xml på kontrolleren |
A Jenkinsfilen er lagret med programkoden |
| Endringshistorikk | Holdt av Jenkins, utenfor arkivet ditt | Revvist og versjonert som enhver annen kildefil |
| Faser og parallelt arbeid | En enkelt flat liste over byggetrinn | Navngitte stadier, parallelle grener og en stadievisning |
| Læringskurve | Ingen skripting nødvendig | Krever den deklarative pipeline-syntaksen |
| Passer best | Én kompilering, ett skript, én planlagt oppgave eller læring Jenkins | Flertrinns bygging, testing og distribusjon av flyter på tvers av miljøer |
En praktisk regel: grip løs mens jobben er en enkeltstående oppgave og du fortsatt lærer deg verktøyet, og flytt arbeidet til en CI/CD pipeline så snart det utvikler seg til et andre trinn eller må gjennomgås sammen med koden. Team som kobler seg sammen Jenkins med byggeverktøy når man ofte det punktet raskt – en Maven og Selenium oppsett er en vanlig utløser for byttet, og den samme resonnementet gjelder for alle automatiseringstesting suite som går i flere faser.
