Jenkins : Tutoriel pour l’outil d’intégration continue

Si vous souhaitez que votre équipe utilise la méthode agile d’intégration continue (IC), il est recommandé d'utiliser un outil IC simple mais puissant. Jenkins est cet outil : particulièrement par le biais de plugins, ce logiciel open source vous offre de nombreuses possibilités pour rendre le processus d’intégration continue plus efficace.

Jenkins est basé sur Java et fonctionne donc sur toutes les plateformes imaginables. Le logiciel étant livré avec Winston, un middleware de servlet, aucun autre serveur, tel que Tomcat, n'est nécessaire. Pour vous aider à bien travailler avec Jenkins, laissez-nous d'abord vous expliquer comment installer et configurer correctement ce programme. Ensuite, nous vous appuierons sur un exemple pour vous montrer comment faire ses premiers pas avec un projet.

Le programme d'installation Windows vous guidera tout au long de l'installation. Il vous suffit de spécifier le répertoire d'installation souhaité et de démarrer l'installation.

Maintenant, il est temps de configurer Jenkins. L'assistant de configuration vous demandera si vous souhaitez choisir les plugins à installer ou si vous préférez utiliser le paramétrage par défaut intégrant déjà toutes les améliorations majeures. Si vous utilisez Jenkins pour la première fois, ce choix par défaut vous conviendra certainement. Et ne vous inquiétez pas : des plugins supplémentaires peuvent être facilement installés plus tard.

Créez ensuite un premier utilisateur. Si vous travaillez seul sur votre projet, vous pouvez ignorer cette étape et utiliser simplement Jenkins en tant qu'administrateur. Dans les paramètres de Jenkins, vous pourrez toujours créer ultérieurement de nouveaux utilisateurs avec des droits différents. Lors de la dernière étape de la configuration, vous avez encore la possibilité de spécifier une URL Jenkins. Le champ correspondant comporte par défaut localhost:8080. Si vous avez installé Jenkins sur un serveur (ce qui devrait être le cas dans un environnement de travail professionnel), indiquez ici le bon chemin d'accès au répertoire Jenkins. Enregistrez les données saisies et terminez la configuration.

À la page suivante, vous avez de nombreuses options de paramétrage. Vous pouvez configurer votre projet selon six catégories. Supposons que vous écriviez un programme en Java et que vous souhaitiez utiliser l'intégration continue. Commençons par la gestion du code source. Le programme donné en exemple se trouve dans un référentiel Git sur votre machine (il est également possible de connecter Jenkins à GitHub, par exemple). Veuillez indiquer le bon répertoire sous « Git ». Vous pouvez également travailler avec un dépôt Subversion.

À l'étape suivante, sélectionnez le Build Trigger. Cela déterminera dans quelles situations Jenkins devra effectuer un build. Ceci peut par exemple se faire par l’intermédiaire d’un script spécial d'un autre programme, à la suite d’un autre build, ou périodiquement à des intervalles de temps spécifiques. Vous pouvez également déclencher un build manuellement lorsque vous le souhaitez - ce que nous ferons dans notre exemple.

L'environnement de build, que Jenkins vous laissera configurer par la suite, comprend d'autres options liées aux builds : une interruption, par exemple, si le processus se bloque ? Ou l'affichage d'un horodatage (timestamp) dans la console ? Aucune option n'est obligatoire.

Enfin, il s’agit du Build lui-même : ici, vous déterminez comment votre programme doit être construit. Comme vous avez déjà intégré les connexions à Ant et Gradle via la sélection standard de plugins, vous pouvez choisir l'un de ces programmes. Il est toutefois également possible d'utiliser des commandes simples de type ligne de commande. Sélectionnez l'option pour les commandes par batch et laissez votre programme se compiler :

Après cela, Jenkins vous donne encore la possibilité d’exécuter des actions postérieures au build. Les tests sont particulièrement importants 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 supplémentaires, vous pouvez également connecter Jenkins à d'autres environnements de test. Vous pouvez même ainsi laisser Jenkins exécuter des tests automatiques. Vous pouvez également vous informer et informer les autres sur le statut du build par courrier électronique. Pour finir, sauvegardez les informations et créez votre premier job.