{"id":121,"date":"2011-12-26T17:28:03","date_gmt":"2011-12-26T16:28:03","guid":{"rendered":"http:\/\/dev.qualilogy.com\/fr\/?p=121"},"modified":"2013-01-08T17:11:06","modified_gmt":"2013-01-08T16:11:06","slug":"jenkins-installation","status":"publish","type":"post","link":"http:\/\/qualilogy.com\/fr\/jenkins-installation\/","title":{"rendered":"Jenkins &#8211; Installation"},"content":{"rendered":"<p>Ce post a pour objectif de pr\u00e9senter l&rsquo;installation de Jenkins. Ce sera l&rsquo;opportunit\u00e9 de d\u00e9tailler la r\u00e9solution de quelques probl\u00e8mes sp\u00e9cifiques \u00e0 notre environnement. <!--more--><\/p>\n<h3><span style=\"text-decoration: underline\">Installation de Jenkins<\/span><\/h3>\n<p>Il existe plusieurs mani\u00e8res d&rsquo;installer Jenkins. En fonction de notre <a title=\"Sonar - Environnement\" href=\"http:\/\/qualilogy.com\/fr\/sonar-notre-environnement\/\" target=\"_blank\">environnement<\/a>, nous avons choisi de t\u00e9l\u00e9charger depuis le <a title=\"Site Jenkins\" href=\"http:\/\/jenkins-ci.org\/\" target=\"_blank\">site Jenkins<\/a> un fichier <strong>jenkins.war<\/strong>.<\/p>\n<p>Comme pour l&rsquo;<a title=\"Sonar - Installation\" href=\"http:\/\/qualilogy.com\/fr\/sonar-installation\" target=\"_blank\">installation de Sonar<\/a>, il nous suffit de copier ce fichier sous <strong>C:\\Program Files (x86)\\Apache Software Foundation\\Tomcat 7.0\\webapps<\/strong>, de (re-)d\u00e9marrer Tomcat, puis de lancer Jenkins depuis son url et &#8230;<\/p>\n<p>Rien. Mon navigateur tourne, tourne, tourne&#8230; J&rsquo;ai beau arr\u00eater et relancer Tomcat, plus rien ne marche. M\u00eame Sonar qui \u00e9tait accessible pr\u00e9c\u00e9demment ne veut plus se lancer.<\/p>\n<p>En regardant dans le r\u00e9pertoire <strong>..\\Apache Software Foundation\\Tomcat 7.0\\logs<\/strong>, on remarque alors un fichier tomcat7-stderr.xx.log (xx \u00e9tant la date du jour) et si on ouvre celui-ci, un (ou plusieurs) message(s) <strong>java.lang.OutOfMemoryError: PermGen space<\/strong>.<\/p>\n<p>Il nous faut mettre \u00e0 jour notre configuration Tomcat, de la mani\u00e8re suivante:<\/p>\n<ul>\n<li>Lancer Tomcat7w.exe.<\/li>\n<li>Dans l&rsquo;onglet Java, entrer l&rsquo;option suivante <strong>-XX:MaxPermSize=256m<\/strong>.<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-529\" title=\"Tomcat_Properties2\" src=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Tomcat_Properties2.jpg\" alt=\"\" width=\"417\" height=\"397\" \/><br \/>\n<a href=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Jenkins_Menu.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"alignright size-full wp-image-531\" title=\"Jenkins_Menu\" src=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Jenkins_Menu.jpg\" alt=\"\" width=\"187\" height=\"172\" \/><\/a>Nous pouvons maintenant relancer Tomcat et acc\u00e9der \u00e0 Jenkins. Remarquez mon interface en espagnol : le langage est param\u00e9tr\u00e9 automatiquement en fonction de la variable correspondante du browser.<\/p>\n<p>Bien. La premi\u00e8re chose \u00e0 faire est de jeter un coup d&rsquo;oeil sur la configuration de Jenkins, en activant le menu d&rsquo;administration (&lsquo;Administrar Jenkins&rsquo; dans mon cas).<\/p>\n<h3><span style=\"text-decoration: underline\">Configuration de Jenkins<\/span><\/h3>\n<p>Dans la page d&rsquo;administration, un message nous pr\u00e9vient que Tomcat n&rsquo;est pas compatible UTF-8. Nul besoin d&rsquo;entrer dans les d\u00e9tails, un lien <a title=\"Jenkins i18n\" href=\"https:\/\/wiki.jenkins-ci.org\/display\/JENKINS\/Tomcat#Tomcat-i18n\" target=\"_blank\"><strong>Tomcat i18n<\/strong><\/a> nous am\u00e8ne directement sur la page d&rsquo;aide correspondante du site web de Jenkins, o\u00f9 nous d\u00e9couvrons comment rem\u00e9dier \u00e0 ce probl\u00e8me:<\/p>\n<ul>\n<li>Dans le r\u00e9pertoire <strong>..\\Apache Software Foundation\\Tomcat 7.0\\conf<\/strong>, rechercher le fichier <strong>server.xml<\/strong>.<\/li>\n<\/ul>\n<ul>\n<li>Dans ce fichier, rechercher la section <strong>Connector<\/strong> et ins\u00e9rer l&rsquo;attribut suivant : <strong>URIEncoding=\u00a0\u00bbUTF-8&Prime;<\/strong>. Voici \u00e0 quoi cela ressemble dans mon fichier:<a href=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Tomcat_Connector.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-534\" title=\"Tomcat_Connector\" src=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Tomcat_Connector.jpg\" alt=\"\" width=\"369\" height=\"72\" \/><\/a><\/li>\n<\/ul>\n<p>Stop\/Start du service Tomcat et de retour dans la page d&rsquo;administration de Jenkins, le message d&rsquo;erreur a disparu.<\/p>\n<p><a href=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Jenkins_Conf1.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"alignright size-full wp-image-544\" title=\"Jenkins_Conf1\" src=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Jenkins_Conf1.jpg\" alt=\"\" width=\"311\" height=\"54\" \/><\/a>Allons voir maintenant les param\u00e8tres de configuration: la premi\u00e8re chose que nous remarquons, c&rsquo;est que Jenkins s&rsquo;est install\u00e9 dans un r\u00e9pertoire C:\\.jenkins. Oops, ce n&rsquo;est pas exactement ce que je souhaite. Je pr\u00e9f\u00e8re centraliser mon environnement d&rsquo;analyse sur un disque dur r\u00e9serv\u00e9 \u00e0 cet effet. Voyons comment modifier la localisation du &lsquo;repository&rsquo; Jenkins.<\/p>\n<p>Il nous faut pour cela sp\u00e9cifier la variable <strong>JENKINS_HOME<\/strong>. Deux mani\u00e8re de proc\u00e9der, pour une installation telle que la n\u00f4tre. La premi\u00e8re est incorrecte, mais je la pr\u00e9cise n\u00e9anmoins car cette information n&rsquo;est pas facile \u00e0 rencontrer:<\/p>\n<ul>\n<li>Dans le r\u00e9pertoire <strong>\\Apache Software Foundation\\Tomcat 7.0\\webapps\\jenkins\\WEB-INF<\/strong>, localiser le fichier <strong>web.xml<\/strong> qui constitue le point d&rsquo;entr\u00e9e de notre application Jenkins.<\/li>\n<li>Dans ce fichier, ins\u00e9rer la section suivante, afin de d\u00e9clarer la variable <strong>JENKINS_HOME<\/strong> comme pointant sur un r\u00e9pertoire F:\\Jenkins.<a href=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Jenkins_Conf2.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-546\" title=\"Jenkins_Conf2\" src=\"http:\/\/qualilogy.com\/wp-content\/uploads\/2011\/12\/Jenkins_Conf2.jpg\" alt=\"\" width=\"433\" height=\"92\" \/><\/a>A \u00e9viter compl\u00e8tement car ce fichier &#8211; et donc notre modification &#8211; sera \u00e9cras\u00e9 en cas d&rsquo;installation d&rsquo;un nouveau jenkins.war, lors d&rsquo;un upgrade de version par exemple. Donc, sauf \u00e0 vouloir r\u00e9aliser cette modification \u00e0 chaque nouvelle installation, mieux vaut proc\u00e9der ainsi:<\/li>\n<\/ul>\n<ul>\n<li>Dans le r\u00e9pertoire <strong>\\Apache Software Foundation\\Tomcat 7.0\\conf<\/strong>, localiser le fichier <strong>context.xml<\/strong> et ins\u00e9rer la ligne suivante:<\/li>\n<\/ul>\n<p style=\"text-align: left;padding-left: 60px\"><strong>&lt;Environment name=\u00a0\u00bbJENKINS_HOME\u00a0\u00bb value=\u00a0\u00bbC:\/SRC\/Jenkins\/\u00a0\u00bb type=\u00a0\u00bbjava.lang.String\u00a0\u00bb\/&gt;<\/strong><\/p>\n<p style=\"text-align: left\">Cette fois-ci, nous d\u00e9clarons notre &lsquo;repository&rsquo; sur C:\\SRC\\Jenkins, directement au niveau de Tomcat et non plus au sein de la webapp Jenkins.<\/p>\n<p style=\"text-align: left\">Il est recommand\u00e9 de bien choisir cet emplacement avant d&rsquo;installer le plugin Sonar ou de commencer \u00e0 travailler avec Jenkins. En effet, si vous modifier le &lsquo;home&rsquo; de Jenkins, celui-ci cr\u00e9e un nouvel environnement et vous perdrez votre configuration existante (sauf \u00e0 d\u00e9placer votre repository actuel vers le nouvel emplacement).<\/p>\n<p>Le <a title=\"Sonar - Plugin Jenkins\" href=\"http:\/\/qualilogy.com\/fr\/sonar-jenkins-plugin\">prochain post<\/a> portera sur l&rsquo;installation du plugin Jenkins pour Sonar.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Ce post a pour objectif de pr\u00e9senter l&rsquo;installation de Jenkins. Ce sera l&rsquo;opportunit\u00e9 de d\u00e9tailler la r\u00e9solution de quelques probl\u00e8mes sp\u00e9cifiques \u00e0 notre environnement.<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[],"class_list":["post-121","post","type-post","status-publish","format-standard","hentry","category-sonar-installation"],"_links":{"self":[{"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/posts\/121"}],"collection":[{"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/comments?post=121"}],"version-history":[{"count":3,"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/posts\/121\/revisions"}],"predecessor-version":[{"id":269,"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/posts\/121\/revisions\/269"}],"wp:attachment":[{"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/media?parent=121"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/categories?post=121"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/qualilogy.com\/fr\/wp-json\/wp\/v2\/tags?post=121"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}