maven with jenkins maven documentation
Denna handledning kommer att förklara allt om Jenkins & Integration of Maven med Jenkins. Du lär dig också att skapa dokumentation för projektet med Maven:
Vi kommer att lära känna vad som är Jenkins, Maven Jenkins Integration, fördelarna med Jenkins, hur man ställer in Java och Maven i Jenkins, hur man skapar Jenkins-jobb med olika parametrar, resultatresultatrapporter om Jenkins med TestNG-plugins, hur man skickar Maven kommandon i form av mål i Jenkins, Maven-dokumentation för projekt osv i detalj.
=> Se upp den enkla Maven-träningsserien här.
hur man skriver ut en matris i omvänd ordning
Vad du kommer att lära dig:
Vad är Jenkins?
Jenkins är ett kontinuerligt integrationsverktyg som har oerhört stor betydelse för testning och utveckling av programvara. Det är öppen källkod och plattformsoberoende. I vårt dagliga arbete hanterar vi automatiseringsramar som består av flera hundra testfall.
Hittills har vi sett att för att köra våra skript från Maven-projektet måste vi antingen köra Maven-kommandon från kommandotolken eller direkt öppna Eclipse och utlösa skript.
Så vi utlöser testfallet manuellt för körning. För att automatisera denna process måste vi schemalägga jobb som ska köra våra testfall vid en viss tidpunkt och även ta hand om några viktiga parametrar. Hela processen automatiseras med hjälp av Jenkins.
I verkligheten, om vi har cirka 800 testfall som behöver utföras klockan tre på morgonen, kan det göras enkelt utan att manuellt behöver ingripa med hjälp av Jenkin-jobb.
Det finns också scenarier när automatiserade Smoke- eller Sanity-testfall måste utföras efter att det har gjorts någon kodincheckning från utvecklingssidan i miljön. Alla dessa sköts automatiskt av Jenkins.
Jenkins har loggen över alla modifieringar som gjorts i förvar som SVN eller Git. Jenkins kan enkelt installeras i vårt system och konfigureras. Det kan också ställas in på mer än en virtuell maskin om bygg måste aktiveras på ett distribuerat sätt. Dessutom ger det åtkomst via länkar till alla de senaste byggnaderna.
Jenkins har funktioner som integration med TestNG med hjälp av plugins, e-postmeddelanden om byggstatus som gör det mer populärt att använda nuförtiden. Problem och buggar fastnar och löses mycket tidigt.
En majoritet av integrationsuppgifterna utförs automatiskt, vilket sparar resurser och gör det möjligt för programvaran att släppas när som helst utan problem.
I Agile-miljön har vi affärsanalytiker, utvecklare och testare som arbetar tillsammans. Som ett resultat kan det finnas ett fall som en affärsanalytiker (en icke-teknisk person) kan behöva se och övervaka hur exekveringsresultatet är.
I sådana fall behöver han kanske inte öppna en förmörkelse eller ställa in och köra Maven-kommandon för att utlösa skript. Han kan utföra testfallet med hjälp av Jenkins och få resultat av utförandet.
Vi är på Jenkins hemsida med ett jobbnamn som Projekt . Om ett företag vill se resultaten av utförandet måste jobbnamnet klickas och det omdirigeras till nedanstående sida.
Sedan Bygg nu till vänster på skärmen måste klicka. Således behöver vi bara öppna Jenkins URL (https: // localhost: 8080 / jenkins).
Medan testfall utlöses via Jenkins är det bara den specifika miljön som tillhandahålls i Jenkins där testfallet utförs. Det är ett vanligt scenario att om vi utför våra testfall utanför Jenkins, misslyckas de på grund av versionen av våra verktyg eller språk eller burkar som inte är anpassade till en vad den ska fungera.
Till exempel, Java-versionen eller vår Maven-version uppdaterades eller nedgraderades. Alla dessa kan undvikas om vi använder Jenkins jobb för vårt utförande.
Således har Jenkins stora bidrag i vårt testramverk genom att upprätthålla en central uppsättning över alla geografiska platser.
Fördelar med Jenkins
Fördelarna med Jenkins listas nedan:
- Jenkins är en öppen källkod, plattformsoberoende och bärbar.
- Den kan enkelt installeras och konfigureras. Den kan användas med lätthet.
- Jenkins har automatiserat integrationsartiklarna och så många av integrationsproblemen uppstår inte, vilket ökar effektiviteten och produktiviteten hos utvecklare.
- Dokumentationen beskrivs väl och gör det bekvämt att lära sig det.
- Jenkins utvecklades av utvecklarna genom att komma ihåg de funktioner som utvecklarna faktiskt behöver i arbetet.
- Den har ett stort antal plugins. Alla dessa plugins gör Jenkins mer kraftfull och populär bland utvecklarna.
- Jenkins hjälper de miljöer som finns på molnet.
- Det har en stor grupp användare som är lättillgängliga. De arbetar på återkopplingar och berör basen regelbundet.
- Jenkins ger hjälp för att testa automatisering på följande sätt:
- Funktion av schemaläggning av testkörning: Testpersonal kan schemalägga sina testfall för utförande och använda sin tid för andra uppgifter.
- Anpassad testresultatrapport: Jenkins ger detaljer om resultatmönstret. De grafiska representationerna och detaljerna i utförandets resultat återspeglar det totala antalet testfall, körningstider och annan viktig information.
- Fungerar ordentligt med de kontinuerliga integrationsprocesserna: Testtiden minskas med Jenkins.
Java Och Maven Path Set I Jenkins
Först och främst måste vi ha Java och Maven installerade i våra maskiner. När vi väl är på Jenkins målsida kommer det ursprungligen inga jobb.
Klicka nu på Hantera Jenkins länk från vänster på skärmen.
Klicka sedan på Globala verktygskonfigurationer . Här måste vi göra konfigurationerna för Java och Maven. För Java-installation, klicka på JDK-installationer knapp.
Här måste vi antingen ge namn och JAVA_HOME väg eller detta kan hanteras genom att kontrollera Installera automatiskt kryssruta.
Därefter måste vi flytta till avsnittet Maven och klicka på Maven Installations knapp.
Här måste vi antingen ge namn och MAVEN_HOME sökvägen eller detta kan hanteras genom att markera Installera automatiskt kryssruta.
När du har utfört dessa åtgärder klickar du på Spara på botten av sidan.
Skapa ett Jenkins-jobb
Därefter måste vi skapa ett jobb för att utlösa skript för vårt Maven-projekt. Klicka på Nytt föremål länk från vänster på skärmen.
Ange en Föremålsnamn och välj Freestyle-projekt klicka sedan på OK.
Vi navigeras till jobbkonfigurationssidan. Här måste vi tillhandahålla all information som är specifik för vårt projekt. Först måste vi ange källan till vår projektkod.
Jenkins källkodshantering
I Källkodshantering avsnittet väljer vi i allmänhet antingen från GitHub eller Omstörtning och tillhandahålla motsvarande länkar. Jenkins hämtar automatiskt koden därifrån.
Men om vår kod finns i vårt lokala system måste vi klicka på Avancerad knappen under allmän sektion och kolla sedan Använd anpassad arbetsyta .
Vi måste placera vårt Maven-projekt inuti .jenkins mappen och ange sökvägen till pom-filen som finns i Maven-projektet från och med $ {JENKINS_HOME}.
På detta sätt får Jenkins tag på projektets källkod.
Jenkins används inte bara av testare för att utlösa testkörningen utan används också i stor utsträckning av utvecklare för sitt arbete. Några av dessa alternativ finns under Bygg miljö sektion.
Därefter måste vi gå till avsnittet Bygg och välj Åkalla Maven-mål på toppnivå alternativ från rullgardinsmenyn.
Sedan Åkalla Maven-mål på högsta nivå avsnitt kommer att utökas. Här Maven-version kommer att fyllas i från den Maven-version som vi har definierat i Global verktygskonfiguration .
Under mål måste vi tillhandahålla kommandot Maven för att utlösa körningen. mvn test –PRegression. I Jenkins kan vi utelämna termen mvn och resten av kommandot är tillräckligt.
Klicka på Spara och vi har framgångsrikt skapat ett jobb.
Bara en sammanfattning av vad vi har diskuterat hittills:
- Plats för vår kod (antingen Git, Subversions eller från en lokal katalog).
- Maven-kommando för att utföra körning.
Vårt jobb skapas och kommer att visas på Jenkins målsida:
Klicka på Bygg nu från vänster på skärmen. Det kommer vara en Bygg historia avsnittet till vänster på skärmen synligt efter att byggnaden är klar. De bygga nummer kommer att följas synligt av # tillsammans med tidsstämpel . Navigera nu till Konsolutgång .
Resultaten av utförandet:
TestNG Jenkins Integration For Execution Results Report
För detaljer om testkörningens resultat, navigera till Maven-projektet i Eclipse, gå till mål mappen och sedan till säkerhetsrapporter mapp. Där är en index.html fil inuti säkerhetsrapporterna. Få platsen för filen och öppna den i webbläsaren.
testng-resultat.xml fil och TestNG rapporterar plugin krävs för resultat i Jenkins.
Klicka på Hantera Jenkins länk från vänster på skärmen Jenkins. Klicka sedan på Hantera plugins länk.
vänster koppling vs vänster yttre koppling
Installera TestNG Resultat-plugin .
När du är klar uppdaterar vi jobbet vi skapat från Konfigurera länk från vänster på skärmen. Navigera sedan till Åtgärder efter byggnaden avsnittet och välj Publicera TestNG-resultat från rullgardinsmenyn.
testng-resultat.xml filen i vårt Maven-projekt fylls automatiskt i TestNG XML-rapportmönster fält som standard. Klicka sedan på Spara.
Jobbplanering i Jenkins
Navigera till Bygg utlösare avsnitt för schemaläggning av byggtider.
Om vi väljer Bygg med jämna mellanrum , då kommer vi att ha Schema avsnitt synligt. Här måste vi nämna fem parametrar för att schemalägga jobbet enligt nedan.
- MINUTER på en timme
- TIMMAR på en dag
- DAYMONTH dag på en månad
- MÅNAD om ett år
- DAGSVECKA veckodag
För att schemalägga skript klockan 08:00 på morgonen måste vi ange enligt nedan:
Nu ska vi utlösa byggnaden igen för att verifiera TestNG-resultaten. Gå till målsidan för Jenkins och klicka på jobbet. Vi ska nu ha en TestNG-resultat länk inuti vår jobbskärm.
Om utförandet inte har några fel, Senaste testresultatet länken visar inga fel. Klicka på länken TestNG-resultat för att få mer information om resultaten.
Vi kan klicka på bygga # nummer för mer information om resultaten.
För att kontrollera vår kod bör vi klicka på Arbetsyta länk till vänster på skärmen. På detta sätt kan Jenkins och Maven arbeta tillsammans.
Maven-dokumentation för projekt
Vi kan skapa dokumentation för vårt projekt med hjälp av Maven. Som diskuterats tidigare består Maven av tre livscykler, dvs ren, plats och standard.
Uppgiften att ta bort eventuella fel och ta bort artefakterna från den tidigare versionen tas hand om i rena cykel. Medan standard ansvarar för den totala driftsättningsprocessen, webbplats livscykel är för att skapa projektdokumentationen.
Det anses vara en bra praxis att göra ren före webbplatsen så att vi har en uppdaterad dokumentation.
Navigera till projektmappen och kör följande kommando från kommandotolken.
mvn site Processen med att bygga projektet startar. Efter framgången med byggnaden ska projektdokumentationen genereras enligt nedan.
När vi klickar på index.html-filen kan vi ha detaljerad dokumentation av projektet som huvudsakligen består av bygg- och projektinformation, om projektet, kontinuerlig integration, beroenden, adresslista, licenser och så vidare.
FAQs avsnitt
F # 1) Hur fungerar Jenkins med Maven?
Svar: Jenkins fungerar bra med Maven genom att följa vissa förutsättningar. Vi måste ställa in Java- och Maven-vägar i Jenkins. Då måste vi skapa Jenkins-jobb med alla parametrar inklusive Post Build Actions, schemalägga builds och så vidare.
F # 2) Vad är Maven och Jenkins?
Svar: Maven är ett projektledning och bygger verktyg utvecklat i Java. Jenkins är ett kontinuerligt integrationsverktyg som är öppen källkod. Både Maven och Jenkins används ofta i branschen idag.
F # 3) Vad är Maven-målet i Jenkins?
Svar: Vi tillhandahåller Maven-kommandona i målsektionen i Jenkins. Detta är ett viktigt steg när du skapar ett Jenkins-jobb.
F # 4) Varför använder vi Maven?
Svar: Maven är ett projektlednings- och byggverktyg som drivs av en pom.xml-fil. Det har gjort byggprocessen enkel, enkel och konsekvent.
F # 5) Är Maven ett CI-verktyg?
Svar: Nej, Maven är inte ett kontinuerligt integrationsverktyg. Det är ett byggverktyg som har fler funktioner än Ant. Jenkins är ett kontinuerligt integrationsverktyg.
F # 6) Vad är pom xml i Maven?
Svar: Project Object Model eller pom är en xml-fil som utgör kärnan i Maven. Den innehåller listan över projektberoenden, konfigurationer, profiler och så vidare.
F # 7) Kan vi integrera TestNG och Jenkins med Maven?
Svar: Ja, vi kan integrera TestNG och Jenkins med Maven. Alla dessa uppnås med hjälp av plugins.
vänster inre koppling vs vänster yttre anslutning
F # 8) Vilka är de tre byggnaderna i Maven livscykel?
Svar: De tre standardbyggnaderna i Maven-cykeln listas nedan.
- Standard
- Rena
- Webbplats
F # 9) Hur ställer jag in Xenk-inställningar för Jenkins?
Svar: I Jenkins, gå till avsnittet Bygg i jobbet och klicka sedan på Avancerad. Inställningsfil alternativet kommer att synas där. Platsen för inställningarna. Xml ska anges där.
F # 10) Hur ställer jag in miljövariabler i Jenkins?
Svar: Miljövariablerna i Jenkins kan ställas in från Konfigurera skärm. I Bygga avsnitt, välj Injicera miljövariabler . Där måste vi tillhandahålla miljövariabeln som VARIABLE_NAME = VALUE mönster.
Slutsats
Vi hoppas att en stor del av Maven gillar dess integration med Jenkins, TestNG-plugins för Jenkins för att visa resultat, skapande av jobb på Jenkins, Java och Maven som inrättats i Jenkins, globala konfigurationer på Jenkins bör lätt förstås nu.
Dessutom har Jenkins byggt schemaläggningsmekanismer, dess efterbyggnadsåtgärder, hur Jenkins hanterar koden som finns i Git, eller något annat förvar eller lokalt har illustrerats i detalj här. Öva varje steg en efter en och Maven Jenkins fusion blir tydlig. Vi har också undersökt Maven-dokumentation för projekt.
Jenkins, ett kontinuerligt integrationsverktyg, har en verklig användning för utvecklare, testare, affärsanalytiker och så vidare i en smidig värld. Varje organisation ser upp för att använda och anpassa kontinuerliga integrationsprocesser då och då.
=> Besök här för att se Maven Training Series för alla.
Rekommenderad läsning
- Vad är Maven - Maven-handledning för nybörjare
- Gradle Vs Maven And Maven Plugins
- Jenkins CI-handledning - Vad är Jenkins kontinuerlig integration
- Jenkins-jobb: Konfigurera SCM, bygga jobb och polla SCM
- Jenkins Plugins: SCM, analysatorer och installation av plugins
- Integration av Maven med TestNg med hjälp av Maven Surefire Plugin
- Jenkins Security: Aktiverar säkerhet och projektsäkerhetsmatris
- Konfigurera Maven med Eclipse Java IDE