{"id":1180,"date":"2013-09-29T06:59:30","date_gmt":"2013-09-29T05:59:30","guid":{"rendered":"http:\/\/qualilogy.com\/fr\/?p=1180"},"modified":"2013-09-30T16:57:53","modified_gmt":"2013-09-30T15:57:53","slug":"migrer-jenkins-tomcat-service-windows","status":"publish","type":"post","link":"http:\/\/qualilogy.com\/fr\/migrer-jenkins-tomcat-service-windows\/","title":{"rendered":"Migrer Jenkins de Tomcat vers un service Windows"},"content":{"rendered":"

\"MigrerJenkins\"<\/a><\/p>\n

La s\u00e9rie de posts en cours porte sur la migration de SonarQube et Jenkins depuis Tomcat vers des services Windows.<\/p>\n

Nous avons d\u00e9j\u00e0 vu comment effectuer cette migration pour SonarQube<\/a>, tout en continuant de travailler avec Jenkins sous Tomcat, c’est-\u00e0-dire sans rien perdre de notre repository SonarQube, notre tableau de bord, les r\u00e9sultats d’analyse, les profils, mais \u00e9galement en gardant la possibilit\u00e9 de lancer les projets configur\u00e9s sous Jenkins<\/a>, et donc sans rien perdre des plugins install\u00e9s, dont celui pour le SonarQube Runner.<\/p>\n

Aujourd’hui, nous allons voir comment migrer\u00a0Jenkins en service Windows. Et finalement nous d\u00e9barrasser de ce bon vieux Tomcat.\u00a0<\/p>\n

Ma configuration<\/h2>\n

Tout d’abord un rappel de ma configuration depuis l\u2019article de Qualilogy :\u00a0Installation de SonarQube avec Jenkins<\/a>. En effet, je n’ai pas tout \u00e0 fait la m\u00eame configuration que vous, puisque j’ai choisi d’installer Tomcat<\/a> sur le port 8888 (vieille habitude prise pour \u00e9viter des conflits avec les logiciels qui s\u2019installent par d\u00e9faut sur le port 8080)\u00a0:<\/p>\n

\"Jenkins_Tomcat\"<\/a><\/p>\n

De m\u00eame, j’ai choisi un r\u00e9pertoire de travail sp\u00e9cifique, et nous verrons que cela aura son incidence par la suite.<\/p>\n

\"JenkinsDir\"<\/a><\/p>\n

D’ailleurs, je vous recommande d’effectuer un backup de celui-ci en pr\u00e9alable \u00e0 toute op\u00e9ration.<\/p>\n

Et \u00e9galement de stopper Tomcat afin d’\u00e9viter de nous m\u00e9langer les pinceaux entre nos diff\u00e9rentes installations de Jenkins.<\/p>\n

\"Stop_Tomcat\"<\/a><\/p>\n

Installer Jenkins en service Windows<\/h2>\n

Si nous allons sur la page d\u2019accueil de Jenkins<\/a>, nous pouvons t\u00e9l\u00e9charger celui-ci sous la forme d’un fichier .war ou d’un ex\u00e9cutable d’installation.<\/p>\n

\"Jenkins_download\"<\/a><\/p>\n

Il existe en fait 2 mani\u00e8res d\u2019installer Jenkins en tant que service Windows. La page du site Jenkins qui documente cette installation de Jenkins est la suivante : https:\/\/wiki.jenkins-ci.org\/display\/JENKINS\/Installing+Jenkins+as+a+Windows+service<\/a>. Ce n’est pas forc\u00e9ment celle que je pr\u00e9f\u00e8re mais comme il s’agit de la documentation officielle, autant suivre cette proc\u00e9dure.<\/p>\n

Pour cela, nous t\u00e9l\u00e9chargeons le fichier jenkins.war<\/strong> correspondant \u00e0 la derni\u00e8re version (1.529 dans notre exemple).\u00a0Et que je vais sauvegarder dans un r\u00e9pertoire ‘C:\\Soft\\Jenkins\\Versions\\1.529’.<\/p>\n

Une fois le t\u00e9l\u00e9chargement termin\u00e9, nous ouvrons une fen\u00eatre DOS et nous lan\u00e7ons la commande
\njava -jar jenkins.war<\/strong> :<\/p>\n

\"Jenkins_Java_Install\"<\/a><\/p>\n

Laisser d\u00e9rouler. Notez l’installation par d\u00e9faut dans un r\u00e9pertoire .jenkins cr\u00e9\u00e9 sous les dossiers personnels du user connect\u00e9. Ce n’est pas vraiment ce que je souhaite car ces dossiers ont des droits d’acc\u00e8s limit\u00e9s et m\u00eame si cela n’a pas d’impact pour une installation personnelle sur mon portable, il n’en sera pas de m\u00eame pour un Jenkins partag\u00e9 entre plusieurs utilisateurs avec des logins diff\u00e9rents.<\/p>\n

\"Jenkins_Java_Install2\"<\/a><\/p>\n

Une fois le d\u00e9ploiement du fichier .war termin\u00e9 …<\/p>\n

\"Jenkins_Java_Install3\"<\/a><\/p>\n

… lancer votre browser pr\u00e9f\u00e9r\u00e9 avec l’url\u00a0http:\/\/localhost:8080\/<\/strong> (vous comprenez pourquoi j’utilise le port 8888 pour Tomcat !).\u00a0Dans la page Jenkins qui s’affiche, clicker sur le menu ‘Manage Jenkins’.<\/p>\n

\"Jenkins_ManageJenkins\"<\/a><\/p>\n

Et dans la page suivante, rechercher le menu ‘Install as a Windows Service’.<\/p>\n

\"Jenkins_InstallService\"<\/a><\/p>\n

Cette fois, nous allons pouvoir choisir un r\u00e9pertoire d’installation :<\/p>\n

\"Jenkins_InstallService2\"<\/a><\/p>\n

Et je vais choisir d’installer Jenkins dans le r\u00e9pertoire suivant ‘C:\\Soft\\Jenkins’ avec un dossier sp\u00e9cifique \u00e0 cette version.<\/p>\n

\"Jenkins_InstallService3\"<\/a><\/p>\n

L’installation n’affiche pas de sablier, donc j’ai cru qu’elle n’\u00e9tait pas lanc\u00e9e, et j’ai\u00a0cliqu\u00e9 deux fois sur le bouton ‘Install’. Pas de probl\u00e8me : cela ne cr\u00e9e pas d’erreur ni de seconde installation, heureusement.<\/p>\n

Finalement, un message nous avertit que l’installation s’est termin\u00e9e de mani\u00e8re correcte, et nous demande si nous souhaitons lancer le nouveau service Windows de Jenkins.<\/p>\n

\"Jenkins_InstallService5\"<\/a>
\nJenkins appara\u00eet effectivement dans la fen\u00eatre des services.<\/p>\n

\"Jenkins_InstallService6\"<\/a><\/p>\n

Si nous affichons les properties de celui-ci, nous pouvons voir l’ex\u00e9cutable dans le dossier indiqu\u00e9 pr\u00e9c\u00e9demment lors de l’installation.\u00a0Par contre, l’activation du bouton ‘Start’ n’aboutit pas au r\u00e9sultat esp\u00e9r\u00e9 : Jenkins ne veut pas d\u00e9marrer.<\/p>\n

\"Jenkins_ServiceProperties\"<\/a>
\nEn fait, il s’agit du m\u00eame probl\u00e8me de login utilisateur d\u00e9j\u00e0 rencontr\u00e9 lors de l’installation de SonarQube<\/a>,<\/p>\n

Bon, il faut aller dans l\u2019onglet ‘Log On’ de la fen\u00eatre de Properties et se d\u00e9finir comme utilisateur.<\/p>\n

\"Jenkins_ServiceProperties2\"<\/a><\/p>\n

Dans cet onglet, s\u00e9lectionner ‘This account:’ puis activer le bouton ‘Browse…’.<\/p>\n

\"Jenkins_ServiceProperties3\"<\/a><\/p>\n

Ensuite, le bouton ‘Advanced’,<\/p>\n

\"Jenkins_ServiceProperties4\"<\/a><\/p>\n

puis ‘Find Now’ afin d’afficher la liste des utilisateurs existants pour cette machine.<\/p>\n

\"Jenkins_ServiceProperties6\"<\/a><\/p>\n

S\u00e9lectionner l’utilisateur avec les droits permettant de d\u00e9marrer le service Jenkins, et validez votre choix.<\/p>\n

\"Jenkins_ServiceProperties5\"<\/a><\/p>\n

Enfin, n’oubliez pas de rentrer son password.\"Jenkins_ServiceProperties7\"<\/a><\/p>\n

Nous pouvons maintenant lancer le service Jenkins sans plus d’erreur, puis \u00e0 nouveau la page Jenkins \u00e0 l’url\u00a0‘http:\/\/localhost:8080\/’. Un message nous demande un peu de patience.<\/p>\n

\"Jenkins_Restart\"<\/a><\/p>\n

Puis apr\u00e8s quelques instants :<\/p>\n

\"JenkinsNew\"<\/a><\/p>\n

Le r\u00e9f\u00e9rentiel Jenkins<\/h2>\n

Jenkins guarde sa configuration et celle des diff\u00e9rents plugins utilis\u00e9s, tous les jobs et les fichiers de build, dans un r\u00e9pertoire d\u00e9sign\u00e9 par la variable d’environnement JENKINS_HOME. Celle que nous avons param\u00e9tr\u00e9e sous Tomcat. Mais comme nous n’utilisons plus Tomcat mais Jenkins en service Windows, nous nous retrouvons avec un nouveau repository initi\u00e9 \u00e0 l’installation. Comment faire afin de r\u00e9cup\u00e9rer notre r\u00e9f\u00e9rentiel existant avec nos analyses SonarQube ?<\/p>\n

Jenkins recommande de recopier le r\u00e9pertoire existant<\/a> vers le nouveau r\u00e9pertoire. En l\u2019occurrence, vers le r\u00e9pertoire que j’ai d\u00e9sign\u00e9 lors de l’installation :\u00a0‘C:\\Soft\\Jenkins\\Versions\\1.529\\.jenkins’. Mais ce n’est pas ce que je veux : je ne souhaite pas avoir \u00e0 recopier ce r\u00e9pertoire chaque fois que je veux effectuer un upgrade de Jenkins vers une nouvelle version.<\/p>\n

Ce que je souhaite, c’est que ma nouvelle installation Jenkins soit capable de travailler avec mon repository existant.<\/p>\n

Ce qui est tout \u00e0 fait possible. Il suffit de\u00a0modifier le fichier ‘jenkins.xml<\/strong>‘ pr\u00e9sent dans le r\u00e9pertoire d’installation afin de lui indiquer, dans la toute premi\u00e8re section <service><\/strong> l’emplacement de notre r\u00e9f\u00e9rentiel existant :<\/p>\n

\"Jenkins_xml\"<\/a><\/p>\n

Il faudra faire un Restart du service Jenkins sous Windows. Le message d’attente appara\u00eet \u00e0 nouveau au d\u00e9marrage, puis apr\u00e8s quelques secondes, nous obtenons notre Jenkins tel que nous l’avions laiss\u00e9, avec sa configuration et nos analyses SonarQube.<\/p>\n

Donc en d\u00e9finitive, r\u00e9fl\u00e9chissez bien \u00e0 deux ou trois points importants :<\/p>\n