maven with jenkins maven documentation
Aquest tutorial explicarà tot sobre Jenkins i la integració de Maven amb Jenkins. També aprendreu a crear documentació per al projecte mitjançant Maven:
Coneixerem què és Jenkins, Maven Jenkins Integration, avantatges de Jenkins, com configurar Java i Maven a Jenkins, com crear una feina Jenkins amb diferents paràmetres, informes de resultats d'execució de Jenkins amb complements TestNG, com passar Maven ordres en forma d'objectius a Jenkins, documentació de Maven per a projectes, etc. en detall.
=> Mireu aquí les sèries de formació Maven Simple.
els millors llocs per veure l'anime en línia gratuïtament
Què aprendreu:
Què és Jenkins?
Jenkins és una eina d'integració contínua que té una importància immensa en el món del desenvolupament i proves de programari. És de codi obert i independent de la plataforma. En el nostre dia a dia, ens ocupem de marcs d'automatització que inclouen diversos centenars de casos de prova.
Fins ara, hem vist que per executar els nostres scripts des del projecte Maven cal executar les ordres de Maven des del símbol del sistema o obrir directament Eclipse i activar els scripts.
Per tant, estem desencadenant manualment els casos de prova per a l’execució. Per automatitzar aquest procés, hem de programar feines que executin els nostres casos de prova en un moment concret i que també ens ocupem d'alguns paràmetres importants. Tot aquest procés s’automatitza amb l’ajut de Jenkins.
Així, en realitat, si tenim al voltant de 800 casos de prova que s’han d’executar a les tres de la matinada, es pot fer fàcilment sense necessitar cap intervenció manual amb l’ajut de les feines de Jenkin.
A més, hi ha escenaris en què s’han d’executar casos automatitzats de proves de fum o seny després que hi hagi algun registre de codi des del costat del desenvolupament a l’entorn. Jenkins se n'ocupa automàticament de tots.
Jenkins té el registre de totes les modificacions fetes en dipòsits com SVN o Git. Jenkins es pot instal·lar i configurar fàcilment al nostre sistema. A més, es pot configurar en més d'una màquina virtual si cal activar les versions d'una manera distribuïda. A més, proporciona accés mitjançant enllaços a totes les versions recents.
Jenkins té funcions com la integració amb TestNG amb l'ajuda de connectors, notificacions per correu electrònic sobre l'estat de compilació que fan que sigui més popular d'utilitzar avui en dia. Els problemes i els errors es detecten i es resolen molt aviat.
La majoria de les tasques d'integració es realitzen automàticament, estalviant recursos i permetent que el programari es publiqui en qualsevol moment sense problemes.
A l’entorn Agile, tenim analistes de negocis, desenvolupadors i verificadors que treballen junts. Com a resultat, pot haver-hi un cas que un analista empresarial (una persona no tècnica) pugui necessitar veure i controlar com és el resultat de l'execució.
En aquests casos, és possible que no necessiti obrir un Eclipse ni configurar i executar ordres Maven per activar els scripts. Pot executar els casos de prova amb l'ajut de Jenkins i obtenir els resultats de l'execució.
Estem a la pàgina inicial de Jenkins amb el nom de la feina com Projecte . Si una empresa vol veure els resultats de l'execució, cal fer clic al nom del treball i es redirigirà a la pàgina següent.
Llavors Construeix ara Cal fer clic a l'esquerra de la pantalla. Per tant, només hem d’obrir l’URL de Jenkins (https: // localhost: 8080 / jenkins).
Tot i que els casos de prova es desencadenen mitjançant Jenkins, només és l'entorn específic que es proporciona a Jenkins on s'executen els casos de prova. És un escenari habitual que, si estem executant els nostres casos de prova fora de Jenkins, es produeixen errors a causa de la versió de les nostres eines o llenguatge o pots no alineats amb el que se suposa que funciona.
Per exemple, la versió de Java o la nostra versió de Maven s'han actualitzat o actualitzat. Tot això es pot evitar si utilitzem les feines de Jenkin per a la nostra execució.
Per tant, Jenkins té importants contribucions en el nostre marc de proves mantenint una configuració centralitzada en totes les ubicacions geogràfiques.
Avantatges de Jenkins
A continuació s’enumeren els avantatges de Jenkins:
- Jenkins és un portàtil de codi obert, independent de la plataforma.
- Es pot instal·lar i configurar fàcilment. Es pot utilitzar amb facilitat.
- Jenkins ha automatitzat els elements d’integració i no es produeixen molts dels problemes d’integració, cosa que augmenta l’eficiència i la productivitat dels desenvolupadors.
- La seva documentació es descriu bé i facilita l’aprenentatge.
- Jenkins va ser desenvolupat pels desenvolupadors tenint en compte les funcions que els desenvolupadors realment necessiten per treballar.
- Té un gran nombre de connectors. Tots aquests connectors fan que Jenkins sigui més potent i popular entre els desenvolupadors.
- Jenkins ajuda els entorns allotjats al núvol.
- Té una gran comunitat d’usuaris de fàcil accés. Treballen en comentaris i base tàctil regularment.
- Jenkins proporciona ajuda per provar l'automatització de les maneres següents:
- Característica de la programació d'execució de proves: Els professionals de la prova poden programar l'execució dels casos de prova i utilitzar el seu temps per a altres tasques.
- Informe de resultats de proves personalitzats: Jenkins dóna detalls sobre el patró de resultats. Les representacions gràfiques i els detalls dels resultats de l'execució reflecteixen el nombre total de casos de prova, els temps d'execució i altra informació important.
- Funciona correctament amb els processos d’integració contínua: El temps de proves es redueix amb Jenkins.
Camí de Java i Maven situat a Jenkins
Primer de tot, hem d’instal·lar Java i Maven a les nostres màquines. Un cop siguem a la pàgina de destinació de Jenkins, inicialment no hi haurà feina.
Ara feu clic a Gestiona Jenkins enllaç des de l'esquerra de la pantalla.
A continuació, feu clic a Configuracions d'eines globals . Aquí hem de fer les configuracions de Java i Maven. Per a la configuració de Java, feu clic a Instal·lacions de JDK botó.
Aquí hem de donar Nom i JAVA_HOME ruta o això es pot atendre comprovant Instal·leu-la automàticament casella de selecció.
A continuació, hem de passar a la secció Maven i fer clic a Instal·lacions de Maven botó.
Aquí hem de donar Nom i MAVEN_HOME o això es pot tenir en compte comprovant el fitxer Instal·leu-la automàticament casella de selecció.
Després de realitzar aquestes operacions, feu clic a Desa a la part inferior de la pàgina.
Crea un treball de Jenkins
A continuació, hem de generar una feina per activar els scripts del nostre projecte Maven. Feu clic al botó Article nou enllaç des de l'esquerra de la pantalla.
Introduïu un Nom de l'ítem i seleccioneu el fitxer Projecte d’estil lliure i feu clic a D'acord.
Ens dirigirà a la pàgina de configuració del treball. Aquí hem de proporcionar tota la informació específica del nostre projecte. Al principi, hem de proporcionar la font del codi del nostre projecte.
Gestió del codi font Jenkins
A la Gestió del codi font secció, generalment seleccionem una de les seccions GitHub o bé Subversió i proporcioneu els enllaços corresponents. Jenkins n'obtindrà automàticament el codi.
Tanmateix, si el nostre codi està present al nostre sistema local, hem de fer clic a Advanced botó sota el botó General secció , i després comprova Utilitzeu espai de treball personalitzat .
Hem de situar el nostre projecte Maven dins del .jenkins i doneu la ruta del fitxer pom que resideix dins del projecte Maven a partir de $ {JENKINS_HOME}.
D'aquesta manera, Jenkins aconsegueix el codi font del projecte.
Jenkins no només és utilitzat pels provadors per provocar l'execució de la prova, sinó que també és utilitzat àmpliament pels desenvolupadors per al seu treball. Algunes d'aquestes opcions es proporcionen a la secció Entorn de construcció secció.
A continuació, hem de passar a la secció Construeix i seleccionar Invoca l'objectiu Maven de nivell superior opcions del menú desplegable.
Llavors Invoca objectius Maven de nivell superior s’ampliarà la secció. Aquí Versió Maven es completarà prèviament des de la versió de Maven que hem definit a Configuració d'eines globals .
A Objectius, hem de proporcionar l'ordre Maven per activar l'execució. mvn test –PRegressió. A Jenkins, podem ometre el terme mvn i la resta de l'ordre és suficient.
Fer clic a Desa i hem creat amb èxit una feina.
Només un resum del que hem comentat fins ara:
- Ubicació del nostre codi (ja sigui Git, Subversions o des d’un directori local).
- Ordre Maven per activar l'execució.
El nostre treball es crearà i serà visible a la pàgina de destinació de Jenkins:
Feu clic al botó Construeix ara des de l'esquerra de la pantalla. Hi haurà un Construeix la història secció a l'esquerra de la pantalla visible després de finalitzar la construcció. El número de compilació serà visiblement seguit de # juntament amb el segell de temps . Ara aneu a Sortida de la consola .
Els resultats de l'execució:
TestNG Jenkins Integration for Execution Results Report
Per obtenir informació detallada sobre els resultats de l'execució de la prova, aneu al projecte Maven a Eclipse i aneu al fitxer objectiu i després a la carpeta informes segurs carpeta. Hi ha un index.html arxiu dins dels informes surefire. Obteniu la ubicació del fitxer i obriu-lo al navegador.
testng-results.xml El fitxer i el connector d'informes TestNG són necessaris per obtenir resultats a Jenkins.
Fer clic a Gestiona Jenkins enllaç des de l'esquerra de la pantalla de Jenkins. A continuació, feu clic a Gestiona els connectors enllaç.
com obrir fitxers bin Windows 10
Instal·leu el fitxer Connector de resultats TestNG .
Un cop fet, actualitzarem el treball que hem creat des de Configura enllaç des de l'esquerra de la pantalla. A continuació, aneu a Accions post-compilació secció i seleccioneu Publica els resultats de TestNG des del menú desplegable.
testng-results.xml El fitxer del nostre projecte Maven s'omple automàticament al fitxer Patró d’informes XML TestNG camp per defecte. A continuació, feu clic a Desa.
Programació de feines a Jenkins
Aneu a Construeix desencadenants secció per programar els temps de compilació.
Si seleccionem Construeix periòdicament , llavors tindrem el Horari secció visible. Aquí hem d'esmentar cinc paràmetres per programar la feina, tal com es mostra a continuació.
- MINUTS en una hora
- HORES en un dia
- DAYMONTH dia d’un mes
- MES en un any
- DAYWEEK dia de la setmana
Per programar els scripts a les 8:00 del matí, hem d’especificar com es mostra a continuació:
Ara tornarem a activar la compilació per verificar els resultats de TestNG. Aneu a la pàgina de destinació de Jenkins i feu clic a la feina. Ara tindrem un Resultats TestNG enllaç a la pantalla de la nostra feina.
En cas que l'execució no tingui cap error, el fitxer Últim resultat de la prova l'enllaç no mostrarà cap error. Feu clic a l'enllaç Resultats de TestNG per obtenir més informació sobre els resultats.
Podem fer clic al botó construir # número per obtenir més detalls sobre els resultats.
Per comprovar el nostre codi, hauríem de fer clic a Espai de treball enllaç a l'esquerra de la pantalla. D’aquesta manera, Jenkins i Maven poden treballar junts.
Documentació Maven per al projecte
Podem crear documentació per al nostre projecte amb l’ajut de Maven. Com es va comentar anteriorment, Maven comprèn tres cicles de vida, és a dir, net, lloc i predeterminat.
A la tasca de suprimir qualsevol error i eliminar els artefactes de la versió anterior es té en compte net cicle. Mentre que per defecte s'encarrega del procés de desplegament total, el lloc El cicle de vida és per crear la documentació del projecte.
Es considera una bona pràctica fer net abans que el lloc tingui una documentació actualitzada.
Aneu a la carpeta del projecte i executeu l'ordre següent des del símbol del sistema.
mvn site
S'iniciarà el procés de construcció del projecte. Després de l'èxit de la construcció, la documentació del projecte es generarà com es mostra a continuació.
En fer clic al fitxer index.html, podem tenir documentació detallada del projecte que consisteix principalment en la informació de compilació i projecte, sobre el projecte, integració contínua, dependències, llista de correu, llicències, etc.
Secció de preguntes freqüents
Q # 1) Com funciona Jenkins amb Maven?
Resposta: Jenkins funciona bé amb Maven seguint certes condicions prèvies. Hem d’establir camins Java i Maven a Jenkins. A continuació, hem de crear les feines de Jenkins amb tots els paràmetres, incloses les accions de publicació de la compilació, la programació de les compilacions, etc.
Q # 2) Què són Maven i Jenkins?
Resposta: Maven és una eina de gestió i construcció de projectes desenvolupada a Java. Jenkins és una eina d'integració contínua que és de codi obert. Tant Maven com Jenkins són àmpliament utilitzats en la indústria actualment.
P # 3) Quin és l'objectiu de Maven a Jenkins?
Resposta: Proporcionem les ordres de Maven a la secció Objectius de Jenkins. Aquest és un pas clau en crear una feina de Jenkins.
Q # 4) Per què fem servir Maven?
Resposta: Maven és una eina de gestió i construcció de projectes impulsada per un fitxer pom.xml. Ha fet que el procés de construcció sigui senzill, fàcil i coherent.
P # 5) Maven és una eina CI?
Resposta: No, Maven no és una eina d’integració contínua. És una eina de compilació que té més funcions que Ant. Jenkins és una eina d'integració contínua.
P # 6) Què és pom xml a Maven?
Resposta: Project Object Model o pom és un fitxer XML que forma el nucli de Maven. Conté la llista de dependències, configuracions, perfils del projecte, etc.
Q # 7) Podem integrar TestNG i Jenkins amb Maven?
Resposta: Sí, podem integrar TestNG i Jenkins amb Maven. Tot això s’aconsegueix amb l’ajuda de connectors.
Preguntes d'entrevistes de seleni durant 7 anys d'experiència
Q # 8) Quines són les tres construccions del cicle vital de Maven?
Resposta: A continuació es detallen les tres versions estàndard del cicle Maven.
- Per defecte
- Net
- Lloc
P # 9) Com definir els paràmetres XML de Jenkins?
Resposta: A Jenkins, aneu a la secció Construeix del treball i feu clic a Avançat. Fitxer de configuració l'opció hi serà visible. S'ha d'especificar la ubicació de settings.xml.
Q # 10) Com puc establir variables ambientals a Jenkins?
Resposta: Les variables ambientals de Jenkins es poden establir a partir de Configura pantalla. A la Construeix secció, seleccioneu Injecteu variables d'entorn . Allà hem de proporcionar la variable d'entorn, com ara el patró VARIABLE_NAME = VALUE.
Conclusió
Esperem que una gran part de Maven, com la seva integració amb Jenkins, els connectors TestNG perquè Jenkins mostri els resultats, la creació de llocs de treball a Jenkins, Java i Maven configurats a Jenkins, ara s’haurien d’entendre fàcilment les configuracions globals de Jenkins.
A més, aquí s’il·lustra detalladament els mecanismes de planificació de Jenkins, les seves accions posteriors a la compilació, la manera com Jenkins tracta el codi que resideix a Git o a qualsevol altre dipòsit o localment. Practiqueu cada pas un per un i la fusió de Maven Jenkins serà clara. També hem explorat la documentació de Maven per a projectes.
Jenkins, una eina d'integració contínua, té un ús real per a desenvolupadors, verificadors, analistes de negocis, etc. en un món àgil. Cada organització mira per utilitzar i adaptar processos d’integració contínua de tant en tant.
=> Visiteu aquí per veure la sèrie de formació Maven per a tothom.
Lectura recomanada
- Què és Maven: tutorial de Maven per a principiants
- Complements de Gradle Vs Maven i Maven
- Tutorial Jenkins CI: Què és la integració contínua de Jenkins
- Jenkins Jobs: configuració de SCM, compilació de treballs i sondeig de SCM
- Connectors Jenkins: SCM, analitzadors i instal·lació de connectors
- Integració de Maven amb TestNg mitjançant el connector Maven Surefire
- Jenkins Security: habilitant la matriu de seguretat i seguretat del projecte
- Configuració de Maven amb Eclipse Java IDE