Jenkins : Tutoriel pour l’outil d’in­té­gra­tion continue

Si vous souhaitez que votre équipe utilise la méthode agile d’in­té­gra­tion continue (IC), il est re­com­mandé d'uti­li­ser un outil IC simple mais puissant. Jenkins est cet outil : par­ti­cu­liè­re­ment par le biais de plugins, ce logiciel open source vous offre de nom­breuses pos­si­bi­li­tés pour rendre le processus d’in­té­gra­tion continue plus efficace.

Jenkins est basé sur Java et fonc­tionne donc sur toutes les pla­te­formes ima­gi­nables. Le logiciel étant livré avec Winston, un midd­le­ware de servlet, aucun autre serveur, tel que Tomcat, n'est né­ces­saire. Pour vous aider à bien tra­vail­ler avec Jenkins, laissez-nous d'abord vous expliquer comment installer et con­fi­gu­rer cor­rec­te­ment ce programme. Ensuite, nous vous ap­puie­rons sur un exemple pour vous montrer comment faire ses premiers pas avec un projet.

Le programme d'ins­tal­la­tion Windows vous guidera tout au long de l'ins­tal­la­tion. Il vous suffit de spécifier le ré­per­toire d'ins­tal­la­tion souhaité et de démarrer l'ins­tal­la­tion.

Main­te­nant, il est temps de con­fi­gu­rer Jenkins. L'as­sis­tant de con­fi­gu­ra­tion vous demandera si vous souhaitez choisir les plugins à installer ou si vous préférez utiliser le pa­ra­mé­trage par défaut intégrant déjà toutes les amé­lio­ra­tions majeures. Si vous utilisez Jenkins pour la première fois, ce choix par défaut vous con­vien­dra cer­tai­ne­ment. Et ne vous inquiétez pas : des plugins sup­plé­men­taires peuvent être fa­ci­le­ment installés plus tard.

Créez ensuite un premier uti­li­sa­teur. Si vous tra­vail­lez seul sur votre projet, vous pouvez ignorer cette étape et utiliser sim­ple­ment Jenkins en tant qu'ad­mi­nis­tra­teur. Dans les pa­ra­mètres de Jenkins, vous pourrez toujours créer ul­té­rieu­re­ment de nouveaux uti­li­sa­teurs avec des droits dif­fé­rents. Lors de la dernière étape de la con­fi­gu­ra­tion, vous avez encore la pos­si­bi­lité de spécifier une URL Jenkins. Le champ cor­res­pon­dant comporte par défaut localhost:8080. Si vous avez installé Jenkins sur un serveur (ce qui devrait être le cas dans un en­vi­ron­ne­ment de travail pro­fes­sion­nel), indiquez ici le bon chemin d'accès au ré­per­toire Jenkins. En­re­gis­trez les données saisies et terminez la con­fi­gu­ra­tion.

À la page suivante, vous avez de nom­breuses options de pa­ra­mé­trage. Vous pouvez con­fi­gu­rer votre projet selon six ca­té­go­ries. Supposons que vous écriviez un programme en Java et que vous sou­hai­tiez utiliser l'in­té­gra­tion continue. Com­men­çons par la gestion du code source. Le programme donné en exemple se trouve dans un ré­fé­ren­tiel Git sur votre machine (il est également possible de connecter Jenkins à GitHub, par exemple). Veuillez indiquer le bon ré­per­toire sous « Git ». Vous pouvez également tra­vail­ler avec un dépôt Sub­ver­sion.

À l'étape suivante, sé­lec­tion­nez le Build Trigger. Cela dé­ter­mi­nera dans quelles si­tua­tions Jenkins devra effectuer un build. Ceci peut par exemple se faire par l’in­ter­mé­diaire d’un script spécial d'un autre programme, à la suite d’un autre build, ou pé­rio­di­que­ment à des in­ter­valles de temps spé­ci­fiques. Vous pouvez également dé­clen­cher un build ma­nuel­le­ment lorsque vous le souhaitez - ce que nous ferons dans notre exemple.

L'en­vi­ron­ne­ment de build, que Jenkins vous laissera con­fi­gu­rer par la suite, comprend d'autres options liées aux builds : une in­ter­rup­tion, par exemple, si le processus se bloque ? Ou l'af­fi­chage d'un ho­ro­da­tage (timestamp) dans la console ? Aucune option n'est obli­ga­toire.

Enfin, il s’agit du Build lui-même : ici, vous dé­ter­mi­nez comment votre programme doit être construit. Comme vous avez déjà intégré les con­nexions à Ant et Gradle via la sélection standard de plugins, vous pouvez choisir l'un de ces pro­grammes. Il est toutefois également possible d'uti­li­ser des commandes simples de type ligne de commande. Sé­lec­tion­nez l'option pour les commandes par batch et laissez votre programme se compiler :

Après cela, Jenkins vous donne encore la pos­si­bi­lité d’exécuter des actions pos­té­rieures au build. Les tests sont par­ti­cu­liè­re­ment im­por­tants ici : connectez Jenkins à JUnit avec l’option « Publish JUnit test result report » pour intégrer les résultats du framework de test Java. Par ailleurs : Avec des plugins sup­plé­men­taires, vous pouvez également connecter Jenkins à d'autres en­vi­ron­ne­ments de test. Vous pouvez même ainsi laisser Jenkins exécuter des tests au­to­ma­tiques. Vous pouvez également vous informer et informer les autres sur le statut du build par courrier élec­tro­nique. Pour finir, sau­ve­gar­dez les in­for­ma­tions et créez votre premier job.