Master Spcialis Qualit de Logiciel 2012/2014

Travail Pratique de Jenkins

Ralis par :
LEMACHA Jihad SLIMANI Khadija

Encadr par :
Mr. NAFIL Khalid

SOMMAIRE
Partie 1 : tlchargement ................................................................................................................................ 3 Partie 2 : Installation de jenkins ...................................................................................................................... 4 Partie 3 : Installation de plugins ...................................................................................................................... 6 Principe de linstallation de plugins............................................................................................................. 7 Quels plugins installer ?............................................................................................................................... 7 Partie 4 : configuration Jenkins ....................................................................................................................... 9 Configuration du systme ........................................................................................................................... 9 Partie 5 : Cration dun projet java ............................................................................................................... 12 Partie 6 : Un job Jenkins pour notre projet ................................................................................................... 12 1. 2. Initialisation du job ............................................................................................................................ 12 Accs au systme de gestion de versions ......................................................................................... 13

Page 2

Partie 1 : tlchargement
Avec votre navigateur, allez sur la page daccueil du produit : http://Jenkins http://Jenkins-ci.org/

Cliquez sur le lien Latest Latest and greatest. Le tlchargement ement de Jenkins.war dmarre. Une fois le tlchargement est termin, dposez le war dans C:\jenkins jenkins.

Page 3

Partie 2 : Installation de jenkins

Dplacez-vous dans le e rpertoire dinstallation avec linvite de commande ( (ms-dos) et lancez la commande: java -jar jar Jenkins.war Ce script initialise le processus de construction en continue et dmarre le conteneur de servlet.

Le serveur Jenkins est dmarr. Jenkins a cr dans le rpertoire de lutilisateur (USER_HOME) un rpe rpertoire .Jenkins, qui sera associ par la suite la variable HOME.Jenkins.

Test dinstallation

Page 4

Maintenant que nous avons install Jenkins, et que nous savons y accder, faisons un rapide tour de linterface dadministration, avant de commencer installer les plugins qui seront plus tard utiliss pour la mise en Intgration Continue dun projet java. Tout dabord, si nous pointons notre navigateur vers le port 8080 de notre serveur dintgration (dans notre cas, http://localhost:8080/ http://localhost:8080 mais rien ne vous empche dutiliser un nom de machine comme http://jenkins:8080/), http://jenkins:8080/), nous arrivons sur la page daccueil de Jenkins :

On peut ici noter quelques premiers lments : En haut gauche, le menu principal, partir duquel nous pourrons administrer Jenkins, ajouter des utilisateurs, Juste en dessous, toujours gauche, la file dattente de construction, qui, terme, in indiquera les projets en attente ou en cours de construction, Enfin, on trouve au milieu de lcran un lien nous invitant crer un job puisquon nen a aucun.

Page 5

Partie 3 : Installation de plugins

Une grande richesse de Jenkins est son systme de plugins, ainsi que le grand nombre de plugins existant. Pour accder aux crans de gestion des plugins : Administrer Jenkins Gestion des plugins, qui devrait vous mener http://localhost:8080/pluginManager/. Ici, vous aurez sous les yeux la liste des plugins installs (quelques plugins sont fournis avec Jenkins, et, donc, dj installs, mme si ce nest pas par vous), pour lesquels une mise jour est disponible :

Longlet nomm Disponibles est celui qui donne la liste des plugins disponibles, plus ou moins rangs par catgories comme vous pouvez le constater, la liste est longue ; et la parcourir rapidement peut vous donner une ide des possibilits relles relle dune plate-forme forme dIntgration Continue telle que Jenkins.

Page 6

Principe de linstallation de plugins

Gnralement, linstallation de nouveaux plugins va se faire via le second onglet vu plus haut : cochez les plugins installer puis validez via le bouton en bas de la liste liste. Mais nous avons tendance privilgier, pour ce type dopration, linterface en ligne de commandes : a a limmense avantage dtre scriptable (autrement dit, une fois que la liste des plugins est connue et la liste des commandes correspondantes correspondantes saisie, il ne reste plus qu la rejouer chaque installation dune plate-forme plate Jenkins et celles-ci ci sont toujours installes avec peu prs les mme plugins).

Quels plugins installer ?

Considrant la taille de la liste de plugins disponibles, disponibles, il va vous falloir effectuer un peu de tri, pour ninstaller que ceux eux qui vous sont ncessaires. ncessaires Catgoriser les plugins nest pas forcment vident, mais essayons ; nous dirions quon peut les regrouper en quatre ensembles : Les plugins qui sont plus en rapport avec la plate-forme forme Jenkins en elle elle-mme quavec vos projets : le suivi de sa configuration, la gestion des constructions, lenvoi de mails de reporting

Page 7

Les plugins qui permettent daccder au code-source de votre projet : SVN, Git, CVS, Les plugins qui effectuent les analyses sur votre projet : tests unitaires, couverture de code, respect des normes de codage,

Et, enfin, les plugins qui permettent de publier les rsultats des analyses : trac de graphes, mise disposition de rapports HTML,

Page 8

Partie 4 : configuration Jenkins

Maintenant que notre plate-forme dIntgration Continue Jenkins est installe, avec lensemble des plugins dont nous aurons besoin pour nos projets java, il ne nous reste plus qu la configurer, avant de pouvoir passer la mise en IC dun projet java.

Configuration du systme
Deux tapes au minimum : Informer Jenkins de votre installation de Maven. Informer Jenkins de votre installation du Jdk.

Survolez et cliquez sur le lien Jenkins > Administrer Jenkins > Configurer le systme ; qui vous permettra de configurer les paramtres gnraux de la plate-forme :

Comme vous pouvez le constater, la liste doptions offertes est dj relativement longue, puisquelle ne tient gnralement pas sur un seul cran :

Page 9

Cliquez sur [Ajouter JDK ] et sur [Ajouter Maven], dcochez [Install Automatically Automatically] et remplissez les champs.

Cliquez sur Enregistrer. La partie configuration minimale est termine.

Page 10

Notez la possibilit dinformer du serveur Subversion ainsi que informations pour notification mail.

Page 11

Partie 5 : Cration dun projet java

Nous ous travaillerons avec un mini-projet mini java dexemple, avec SVN comme systme de gestion de versions, lURL suivante : https://subversion.assembla.com/svn/depotjenkins/trunk . Note : ce projet tant en pleine phase de dveloppement, cest le trunk que nous placerons en Intgration Continue ; mais il va de soit quau fur et mesure que de nouvelles branches seront cres, nous ajouterons de nouveaux jobs notre plate-forme plate dIC, correspondant celles celles-ci.

Partie 6 : Un job Jenkins pour notre projet

Maintenant que nous avons un projet java, , sur son systme de gestion de versions, passons sa mise en Intgration Continue sous Jenkins. Aprs lauthentification, nous allons crer un nouveau Job sur Jenkins. Pour faire, rendez rendez-vous sur le menu gauche, et cliquez sur Nouveau Job .

1. Initialisation du job
Jenkins vous affiche donc linterface de cration du nouveau Job. Il faut donc y renseigner le nom du Job ainsi que son type. Nous ous allons choisir Construire un projet free free-style comme type.

Page 12

2. Accs au systme de gestion de versions

Par la suite, on passe la configuration du Job. Dans la configuration minimale, on peut contrler quelques proprits des builds tel que lexcution simultane de plusieurs builds, suppression danciens builds, dsactivation des builds sur le projet et spcifier que le build a des paramtres.

Aprs, on passe la configuration de la liaison de Jenkins avec loutil de versionning qui contient notre projet. Dans notre cas, nous allons connecter notre Job au dpt cr sur Assembla via SVN.

Page 13

On configure ensuite les actions qui vont dclencher le build automatiquement. On peut donc spcifier soit un dclenchement suite dautres projets, et l on spcifie la liste des projets, soit on dfinit que le build sera fait priodiquement ou bien suite une scrutation de loutil de versionning et on spcifie la priode.

Enfin, on peut rajouter une tape au build tl que lappel de Ant ou lexcution dun script Shell. Puis on spcifie laction effectuer aprs le build. Dans notre cas, nous avons choisi de notifier un ensemble dutilisateurs via e-mail mail lorsque le build est instable.

Page 14

On valide la configuration.

Maintenant, il est ncessaire essaire de lancer un premier build pour ramener le projet depuis le dpt vers Jenkins. Pour faire, cliquez sur Lancer un build au menu gauche.

Dans notre cas, on a eu 3 builds. Le premier tant fait parce que le dpt de SVN contient des changements. Le 2me est un build automatique qui seffectue toutes les deux minutes, et le 3me est le build manuel que nous avons fait. fait

Si on accde lespace de travail de notre Job, nous allons y trouver les projets qui se trouvent dans le dpt de SVN.

Page 15

Si on clique sur un build dans la lhistorique des bluids, nous obtenons des informations concernant celui-ci, ci, savoir N du build et sa date de droulement, sa version correspondante au dpt SVN, les changements qui ont eu lieu ainsi que lutilisateur Jenkins Jenkins qui la lanc.

Pour avoir plus de dtails sur le droulement du build, on peut consulter la console de sortie travers le menu gauche. La console de notre build indique quil sest sest pass avec succs, ainsi que son rpertoire de construction, version, son dpt et lutilisateur qui la dclench.

On peut avoir une vision statistique sur le droulement des builds en cliquant sur tendence dans lhistorique des builds. Ainsi, on obtient les builds effectus, leurs dures et les dates de droulement.

Page 16

Page 17