Hur man skapar ett nytt byggjobb i Jenkins Freestyle-projekt

By: Thomas Hamilton Thomas Hamilton
Hours Uppdaterad

⚡ Smart sammanfattning

Jenkins Freestyle Project är ett repeterbart byggjobb som samlar källkodsutcheckning, byggsteg och efterbyggningsåtgärder i en konfigurerbar uppgift, skapad helt och hållet genom Jenkins webbgränssnitt utan att skriva pipeline-kod.

  • 🔘 Definition: Ett freestylejobb är Jenkins' generell projekttyp, konfigurerad via formulär snarare än en Jenkinsfil.
  • ☑️ Förkunskaper: En löpning Jenkins en kontroller, en JDK på byggagenten, Git-pluginet och ett nåbart repository krävs först.
  • ✅ Tio steg: Logga in, skapa ett nytt objekt, namnge det, ange arkivet, lägg till ett byggsteg, spara, bygg och läs konsolutdata.
  • 🧪 Utarbetat exempel: Ett HelloWorld-projekt hämtat från GitHub kompileras med javac och körs med java inuti en Windows batchbyggsteg.
  • 🛠️ Konfigurationskarta: Sexformulärsavsnitt — Allmänt, Källa Code Hantering, byggutlösare, byggmiljö, byggsteg och åtgärder efter byggandet – täcker alla alternativ.
  • ⚙️ Omfattningsgräns: Freestyle-jobb passar för automatisering av enskilda uppgifter; leveransarbete i flera steg hör istället hemma i ett versionsstyrt pipeline-jobb.
Läs mer

Hur man skapar ett nytt byggjobb i Jenkins Freestyle-projekt

Vad är en Jenkins Freestyle-projekt?

Jenkins Freestyle-projekt är ett upprepningsbart byggjobb, skript eller pipeline som innehåller steg och åtgärder efter byggandet. Det är ett förbättrat jobb eller en förbättrad uppgift som kan omfatta flera operationer. Det låter dig konfigurera byggutlösare och erbjuder projektbaserad säkerhet för din Jenkins projekt. Den erbjuder även plugins som hjälper dig att bygga steg och åtgärder efter byggandet.

De typer av åtgärder du kan utföra i en Jenkins Byggsteg eller åtgärder efter byggandet är ganska begränsade. Det finns många standardplugins tillgängliga inom en Jenkins Freestyle-projektet för att hjälpa dig att övervinna detta problem.

Diagrammet nedan placerar freestyle-jobbet inom det bredare området kontinuerlig integration loop, från utcheckning av källkod till de åtgärder efter byggandet som rapporterar resultatet.

Steg för att skapa ett jobb i Jenkins Freestyle-projekt
Hur man skapar ett jobb i Jenkins

Förutsättningar för att skapa en Jenkins Freestyle-jobb

Innan de tio stegen nedan fungerar från början till slut måste fyra saker vara på plats. Att missa något av dem är den vanliga anledningen till att ett första freestyle-bygge misslyckas med en röd boll snarare än en blå.

  • En löpning Jenkins styrenheten. Jenkins lyssnar på port 8080 som standard. Om Jenkins inte körs än, följ installationsgenomgång först.
  • En JDK på maskinen som kör bygget. Det bearbetade exemplet kompilerar Java, Så javac måste finnas på PATH-sökvägen för den kontrollant eller agent som utför jobbet. Bekräfta detta med en enradig text. java -version byggsteget innan du lägger till något annat.
  • Git-pluginet. Ocuco-landskapet gå alternativet visas bara under Källa Code Hantering när plugin-programmet är installerat, via hantera Jenkins > Insticksprogram.
  • Ett åtkomligt arkiv. En offentlig HTTPS URL behöver inga inloggningsuppgifter. Ett privat arkiv behöver en inloggningsuppgifter som lagras i Jenkins först, annars misslyckas utcheckningen under den allra första bygget.

Ett konto hos Jobb/Skapa behörighet behövs också — på en ny enskild användare Jenkins administratörskontot har det redan.

Hur man skapar ett nytt byggjobb i Jenkins

Freestylebygget är ett mycket flexibelt och lättanvänt alternativ. Du kan använda den för alla typer av projekt; det är lätt att installera och många av dess alternativ visas i andra byggjobb. Nedan följer en steg för steg process för att skapa jobb i Jenkins.

Steg 1) Logga in på Jenkins

För att skapa en Jenkins freestylejobb, logga in på din Jenkins instrumentpanelen genom att besöka din Jenkins installationssökväg. Vanligtvis kommer den att vara värd på localhost på http://localhost:8080 Om du installerad Jenkins i en annan sökväg, använd lämplig URL för att komma åt din instrumentpanel enligt nedan Jenkins exempel på jobbskapande.

Jenkins instrumentpanelen nåddes vid Jenkins installationssökväg efter inloggning

Steg 2) Skapa nytt objekt

Klicka på "Nytt objekt” längst upp till vänster på din instrumentpanel. Skärmdumpen nedan visar var länken finns.

Länken "Nytt objekt" längst upp till vänster på Jenkins instrumentbräda

Steg 3) Ange artikeldetaljer

På nästa skärm,

  1. Ange namnet på objektet du vill skapa. Vi kommer att använda "Hej världen" för denna demo.
  2. Välj Freestyle-projekt
  3. Klicka på Okej

Objektnamnsruta med Freestyle-projekt markerat innan du klickar på OK

Steg 4) Ange projektinformation

Ange informationen om projektet du vill testa. Konfigurationssidan som öppnas visas nedan.

Projektuppgifter som anges på Jenkins freestyle-jobbkonfigurationssida

Steg 5) Ange arkivet URL

Under Källa Code Hantering, ange ditt arkiv URLVi har ett testarkiv beläget på https://github.com/kriru/firstJava.git

Källa Code Hanteringsavsnitt med Git-testarkivet URL gick in i

Det är också möjligt för dig att använda ett lokalt arkiv.

Om ditt GitHub-arkiv är privat, Jenkins kommer först att validera dina inloggningsuppgifter med GitHub och först sedan hämta källkoden från ditt GitHub-arkiv.

RELATERADE ARTIKLAR

Steg 6) Justera inställningarna

Nu när du har angett alla detaljer är det dags att bygga koden. Justera inställningarna under SLUTRESULTAT avsnitt för att bygga koden vid den tidpunkt du vill. Du kan till och med schemalägga bygget så att det sker regelbundet, vid bestämda tider.

Under uppbyggnad,

  1. Klicka på "Lägg till byggsteg"
  2. Klicka på "Utförande Windows batch-kommando” och lägg till de kommandon du vill köra under byggprocessen.

Listrutan som listar de tillgängliga byggstegen ser ut så här.

Listrutan Lägg till byggsteg öppnades på konfigurationssidan för freestyle-jobbet

⚠️ Versionsnotering: senaste Jenkins utgåvor etikett detta område Bygg steg snarare än Bygga, och på Linux eller macOS agenter motsvarande alternativ är Kör skaletKnappen anropas fortfarande Lägg till byggsteg.

Här har jag lagt till java-kommandon för att kompilera java-koden.

Jag har lagt till följande Windows-kommandon:

javac HelloWorld.java
java HelloWorld

Kommandorutan med de två inmatade raderna visas nedan.

Utförande Windows batch-kommandoruta som innehåller javac- och java-kommandona

Steg 7) Spara projektet

När du har angett alla uppgifter,

  1. Klicka Ansök
  2. Spara projektet.

Steg 8) Bygg källkod

Nu, på huvudskärmen, klicka på knappen Bygg nu på vänster sida för att bygga källkoden.

Knappen Bygg nu på vänster sida av freestyle-projektskärmen

Steg 9) Kontrollera status

Efter att ha klickat på Bygg nu kan du se status för bygget du kör under Bygghistorik.

Panelen Bygghistorik som visar statusen för freestyle-bygget som kördes

Steg 10) Se konsolutgången

Klicka på byggnumret och sedan på konsolens utdata för att se statusen för bygget du kör. Det bör visas ett meddelande om att det lyckades, förutsatt att du har följt installationsanvisningarna korrekt enligt nedan. Jenkins skapa ett nytt jobbexempel.

Konsolens utdataskärm som visar meddelandet om att den färdiga versionen lyckades

Sammanfattningsvis har vi genomfört ett HelloWorld-program som finns på GitHub. Jenkins hämtar koden från fjärrarkivet och bygger kontinuerligt med en frekvens du definierar.

Jenkins Förklaring av avsnitt om konfiguration av Freestyle-projekt

Genomgången ovan berör endast de fält som HelloWorld-exemplet behöver. Själva konfigurationssidan är indelad i sex formuläravsnitt, och att veta vad varje sektion äger gör de återstående alternativen mycket lättare att hitta.

§ Vad den kontrollerar Typisk inställning
Allmänt Jobbbeskrivning, kassering av gamla versioner, parametrar och om jobbet körs på en specifik agent Descriptjon plus en gräns för byggretention
Källa Code Verksamhetsledningen Vilket repository som ska checkas ut och med vilka autentiseringsuppgifter och grenar Git, en HTTPS-tjänst URL, gren */master or */main
Bygg utlösare Vad som startar bygget automatiskt Polla SCM, bygg regelbundet eller en webhook från GitHub
Bygg miljö Omslag appliceras runt hela bygget Ta bort arbetsytan innan bygget startar; lägg till tidsstämplar i konsolloggen
Bygg steg Kommandona som gör jobbet körs uppifrån och ner Utförande Windows batch-kommando, eller Execute shell
Åtgärder efter byggnation Vad händer efter att stegen är avslutade, oavsett resultatet Archise artefakterna, publicera en testrapport, skicka ett e-postmeddelande

Två vanor sparar mycket felsökning senare. Lägg till byggsteg i den ordning de måste köras, eftersom Jenkins bearbetar dem uppifrån och ner och stoppar vid första felet. Arkivera sedan det som bygget producerar som en åtgärd efter bygget, eftersom arbetsytan återanvänds av nästa bygg medan arkiverade artefakter behålls per byggnummer.

Freestyle Project vs Pipeline: Vilken ska du använda?

Freestyle är inte den enda projekttypen på skärmen Nytt objekt, och det är inte alltid den rätta. Tabellen nedan jämför den med en Rörledningsjobb på de punkter som avgör de flesta verkliga val.

Punkt av jämförelse Freestyle-projekt Pipeline
Hur det definieras Webbformulär lagrade i jobbets config.xml på kontrollenheten A Jenkinsfilen som compigerades med programkoden
Förändra historien Innehas av Jenkins, utanför ditt arkiv Revvisad och versionerad som vilken annan källfil som helst
Etapper och parallellt arbete En enda platt lista med byggsteg Namngivna etapper, parallella grenar och en etappvy
Inlärningskurva Inget skript behövs Kräver den deklarativa pipeline-syntaxen
Bästa passform En kompilering, ett skript, en schemalagd uppgift eller inlärning Jenkins Bygg, test och driftsätt flöden i flera steg över olika miljöer

En praktisk regel: försök att använda freestyle medan jobbet är en enskild uppgift och du fortfarande lär dig verktyget, och flytta arbetet till en CI/CD pipeline så snart det växer fram ett andra steg eller behöver granskas tillsammans med koden. Team som parar ihop Jenkins med byggverktyg når man ofta den punkten snabbt — en Maven och Selenium inställning är en vanlig utlösande faktor för övergången, och samma resonemang gäller för alla automatiseringstestning svit som körs i flera faser.

Vanliga frågor

Konsolens utdata anger orsaken. De tre vanligaste orsakerna är att javac saknas i agentens PATH, ett privat arkiv utan lagrad autentiseringsuppgifter och ett felaktigt grennamn. Åtgärda den rapporterade raden och kör sedan Build Now igen.

Öppna Byggutlösare och markera Bygg regelbundetoch ange sedan cron-syntax som till exempel H 2 * * * för en nattlig löprunda. Den H fördelar belastningen över timmen. Omröstning SCM använder samma syntax men byggs bara när repositoryt ändras.

Välja Kör skalet från menyn Lägg till byggsteg istället för Kör Windows batch-kommando. Vilket alternativ som visas beror på operativsystemet för den styrenhet eller agent som jobbet är kopplat till, inte på din egen dator.

Lagra token eller SSH-nyckeln en gång under hantera Jenkins > Referenseroch välj den sedan från rullgardinsmenyn Inloggningsuppgifter i källan Code Ledningssektionen. Jenkins validerar det före utcheckningen, så en ogiltig autentiseringsuppgifter misslyckas med bygget direkt.

Maskininlärningsverktyg läser konsolloggar och klustrar upprepade fel, vilket separerar ett genuint kompileringsfel från en instabil agent eller en timeout. Den prioriteringen pekar dig på den enda raden som är viktig istället för att bläddra igenom en lång logg manuellt.

GitHub Copilot utarbetar batch- eller skalskriptet inuti ett byggsteg, och dess CLI kan sammanfatta en misslyckad konsollogg. Den kan inte klicka sig igenom konfigurationsformuläret, så granska varje genererat kommando innan du sparar.

Lägg till Archive artefakterna som en efterbyggande åtgärd och ge den ett mönster som **/*.class. Archived-filer lagras per byggnummer, så de överlever arbetsytan när de återanvänds eller rensas vid nästa körning.

Varje jobb lever i JENKINS_HOME/jobs/<job-name>, med formulärinställningarna i config.xml och varje körning under builds/Det räcker med att säkerhetskopiera den mappen för att flytta eller återställa jobbet.

Sammanfatta detta inlägg med: