Jenkins: tutorial per lo strumento di CI

Se volete uti­liz­za­re la me­to­do­lo­gia agile Con­ti­nuous In­te­gra­tion (CI) nel vostro team, dovreste affidarvi a uno strumento di CI semplice ma potente. Jenkins è un'ottima soluzione. Questo software open source vi offre mol­tis­si­me pos­si­bi­li­tà per rendere più ef­fi­cien­te il processo di in­te­gra­zio­ne continua, so­prat­tut­to grazie ai plug-in.

Jenkins è basato su Java e può quindi essere uti­liz­za­to su tutte le piat­ta­for­me. Poiché il software viene fornito insieme a Winston, un midd­leware servlet, non c'è bisogno di server ag­giun­ti­vi, come Tomcat. Per ottenere il massimo da Jenkins, vi spie­ghe­re­mo prima di tutto come in­stal­la­re e con­fi­gu­ra­re il programma. Vi mo­stre­re­mo poi un esempio di come muovere i primi passi in un progetto.

Il programma di in­stal­la­zio­ne di Windows vi guiderà senza problemi at­tra­ver­so la procedura di in­stal­la­zio­ne. Dovete soltanto spe­ci­fi­ca­re la directory de­si­de­ra­ta e avviare l'in­stal­la­zio­ne.

Ora è il momento della con­fi­gu­ra­zio­ne di Jenkins. Durante l’in­stal­la­zio­ne guidata potete scegliere i plug-in da in­stal­la­re con Jenkins o se­le­zio­na­re un'im­po­sta­zio­ne pre­de­fi­ni­ta che ha tutte le prin­ci­pa­li esten­sio­ni già integrate. Se uti­liz­za­te Jenkins per la prima volta, questa opzione sarà sen­z'al­tro suf­fi­cien­te. Non pre­oc­cu­pa­te­vi, ulteriori plug-in possono essere in­stal­la­ti senza problemi anche in un secondo momento.

Con­ti­nua­te poi creando un primo utente. Se al­l'i­ni­zio lavorate da soli a un progetto, potete saltare questo passaggio e uti­liz­za­re Jenkins come am­mi­ni­stra­to­re. Potete creare nuovi utenti con diritti diversi nelle im­po­sta­zio­ni di Jenkins in qualunque momento. Nella fase finale di con­fi­gu­ra­zio­ne potete inoltre spe­ci­fi­ca­re un URL di Jenkins. Nel campo cor­ri­spon­den­te è già stato inserito localhost:8080. Se avete in­stal­la­to Jenkins su un server (come nel caso di un ambiente di lavoro pro­fes­sio­na­le), inserite qui il percorso corretto per la directory di Jenkins. Salvate l'in­se­ri­men­to e com­ple­ta­te la con­fi­gu­ra­zio­ne.

Nella pagina seguente verranno vi­sua­liz­za­te le numerose opzioni di im­po­sta­zio­ne di­spo­ni­bi­li. Il vostro progetto può essere con­fi­gu­ra­to in una delle sei categorie. Sup­po­nia­mo di scrivere un programma in Java e di voler uti­liz­za­re la Con­ti­nuous In­te­gra­tion. Prima di tutto ci oc­cu­pe­re­mo del Source Code Ma­na­ge­ment. Il programma uti­liz­za­to come esempio si trova in un re­po­si­to­ry git sul vostro computer (è anche possibile collegare Jenkins a GitHub). Inserite quindi la directory corretta sotto la voce "Git". Potete lavorare anche con una sot­to­ver­sio­ne.

Nel passo suc­ces­si­vo, se­le­zio­na­te Build Trigger. In questo modo de­ter­mi­na­te le si­tua­zio­ni in cui Jenkins dovrebbe avviare una build. Questo è possibile, ad esempio, at­tra­ver­so lo script speciale di un altro programma, dopo che un'altra build è stata com­ple­ta­ta o pe­rio­di­ca­men­te a de­ter­mi­na­ti in­ter­val­li di tempo. Potete attivare una build anche ma­nual­men­te non appena siete pronti, come faremo nel nostro esempio.

Il Build En­vi­ro­ment che dovete con­fi­gu­ra­re suc­ces­si­va­men­te contiene ulteriori opzioni per le build: ad esempio, il processo deve essere in­ter­rot­to se si blocca? Oppure volete loggare un timestamp nella console? Nessuna delle opzioni è ob­bli­ga­to­ria.

Dopo tutto, si tratta di­ret­ta­men­te della build: qui definite come deve essere costruito il vostro programma. Dato che nella selezione standard dei plug-in avete già integrato col­le­ga­men­ti ad Ant e Gradle, potete se­le­zio­na­re uno di questi programmi. Tuttavia, è anche possibile uti­liz­za­re semplici comandi in riga di comando. Se­le­zio­na­te l'opzione per i comandi batch e lasciate che il programma si compili:

In seguito Jenkins vi offre la pos­si­bi­li­tà di eseguire azioni una volta concluso il processo di build. So­prat­tut­to il testing gioca un ruolo im­por­tan­te: collegate Jenkins e JUnit tramite l'opzione "Publish JUnit test result report" per integrare i risultati del framework di test per Java. Con plug-in ag­giun­ti­vi potete inoltre collegare Jenkins ad altri ambienti di test ed eseguire persino test au­to­ma­ti­ci tramite il software. È inoltre possibile inviare e-mail a voi stessi e ad altri con­te­nen­ti in­for­ma­zio­ni sullo stato della build. Infine dovete soltanto salvare i dati ed ecco che avete creato il vostro primo job.