Options d'installation : focus sur Docker (recommandé pour débuter) et WAR

Choisir sa méthode d'installation Jenkins : flexibilité et simplicité

Une fois les prérequis système vérifiés, l'étape suivante consiste à choisir la méthode d'installation de Jenkins la plus adaptée à votre situation et à vos compétences. Jenkins, fidèle à sa flexibilité, propose plusieurs voies pour sa mise en place. Dans ce chapitre, nous allons nous concentrer sur deux des approches les plus populaires et pertinentes, en particulier pour ceux qui découvrent l'outil : l'installation via Docker et l'installation à l'aide du fichier WAR (Web Application Archive). Nous mettrons un accent particulier sur Docker, qui est souvent recommandé pour sa simplicité et sa rapidité de mise en oeuvre, surtout pour un premier contact.

D'autres options existent, comme les paquets natifs pour certaines distributions Linux (.deb pour Debian/Ubuntu, .rpm pour CentOS/RHEL) ou l'installeur Windows, mais Docker et le WAR offrent une excellente couverture pour la majorité des cas d'usage, notamment pour l'apprentissage et le développement.

Installation avec Docker : la voie rapide et isolée (recommandée pour débuter)

L'utilisation de Docker pour installer Jenkins est devenue extrêmement populaire, et ce, pour de bonnes raisons. Docker permet d'exécuter des applications dans des conteneurs isolés, ce qui simplifie grandement la gestion des dépendances et assure une portabilité accrue.

Pourquoi choisir Docker pour Jenkins ?

• Simplicité : Le lancement d'une instance Jenkins se résume souvent à une seule commande Docker.
• Isolation : Jenkins et ses dépendances (comme Java) sont encapsulés dans le conteneur, évitant les conflits avec d'autres logiciels sur votre machine hôte.
• Portabilité : Un conteneur Jenkins fonctionnera de la même manière sur n'importe quelle machine où Docker est installé (Linux, macOS, Windows).
• Gestion des versions : Il est facile de tester différentes versions de Jenkins en changeant simplement le tag de l'image Docker.
• Nettoyage facile : Supprimer une instance Jenkins et ses données associées (si configuré avec des volumes Docker) est simple.

Comment procéder (conceptuellement) ?

1. Installer Docker : Assurez-vous que Docker Desktop (pour Windows/macOS) ou Docker Engine (pour Linux) est installé et fonctionnel sur votre système.
2. Récupérer l'image Jenkins officielle : Jenkins publie des images officielles sur Docker Hub. La plus courante est jenkins/jenkins:lts pour la version Long-Term Support. La commande serait typiquement :

   docker pull jenkins/jenkins:lts

3. Lancer le conteneur Jenkins : Vous utiliserez la commande docker run. Il est crucial de mapper des ports (pour accéder à l'interface web de Jenkins) et de gérer la persistance des données de Jenkins (le répertoire JENKINS_HOME) à l'aide de volumes Docker. Sans volume, toutes vos configurations seraient perdues à l'arrêt du conteneur. Exemple de commande de base :

   docker run -d -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts

   • -d : exécute en mode détaché (arrière-plan).
   • -p 8080:8080 : mappe le port 8080 du conteneur au port 8080 de votre machine hôte (pour l'interface web).
   • -p 50000:50000 : mappe le port 50000 (pour la communication avec les agents JNLP).
   • -v jenkins_home:/var/jenkins_home : crée un volume nommé jenkins_home (ou utilise un chemin sur votre machine) et le monte sur /var/jenkins_home dans le conteneur, où Jenkins stocke ses données.
4. Accéder à Jenkins : Ouvrez votre navigateur et allez à http://localhost:8080.

Cette méthode est particulièrement attrayante car elle abstrait la gestion de l'installation de Java et d'autres dépendances système. La documentation officielle de Jenkins sur Docker Hub fournit des instructions détaillées et des options de configuration avancées.

Installation avec le fichier WAR : l'approche traditionnelle

L'installation de Jenkins via son fichier WAR (Web Application Archive) est la méthode plus traditionnelle. Un fichier .war est une archive contenant une application web Java complète, prête à être déployée dans un conteneur de servlets Java (comme Apache Tomcat, Jetty, GlassFish) ou simplement exécutée avec Java directement.

Pourquoi choisir le fichier WAR ?

• Flexibilité de l'environnement : Vous pouvez choisir le serveur d'applications Java que vous connaissez le mieux ou qui est déjà en place dans votre infrastructure.
• Contrôle plus fin : Vous avez un contrôle plus direct sur la configuration de l'environnement Java et du serveur d'applications.
• Pas de dépendance à Docker : Si vous n'utilisez pas Docker ou si votre environnement ne le permet pas facilement.

Comment procéder (conceptuellement) ?

1. Installer Java : Assurez-vous d'avoir une version compatible du JDK installée et configurée correctement (variable d'environnement JAVA_HOME définie, java dans le PATH).
2. Télécharger le fichier Jenkins WAR : Rendez-vous sur le site officiel de Jenkins (jenkins.io) et téléchargez la dernière version stable (LTS recommandée) du fichier jenkins.war.
3. Exécuter Jenkins :
   • Méthode simple (avec le serveur Jetty embarqué) : Ouvrez un terminal, naviguez jusqu'au répertoire où vous avez téléchargé jenkins.war, et exécutez la commande :

     java -jar jenkins.war --httpPort=8080

     Jenkins démarrera en utilisant un serveur web Jetty embarqué. Par défaut, il écoutera sur le port 8080. Vous pouvez changer le port avec l'option --httpPort. Les données de Jenkins (JENKINS_HOME) seront stockées par défaut dans un répertoire .jenkins dans le dossier personnel de l'utilisateur qui a lancé la commande.
   • Déploiement sur un serveur d'applications existant : Si vous avez un serveur comme Apache Tomcat, vous pouvez déployer le fichier jenkins.war en le copiant dans le répertoire webapps de Tomcat. Le serveur d'applications se chargera de le déployer et de le rendre accessible. La configuration de JENKINS_HOME peut nécessiter des ajustements via les variables d'environnement ou les options de démarrage du serveur.
4. Accéder à Jenkins : Ouvrez votre navigateur et allez à http://localhost:8080 (ou le port que vous avez configuré).

Cette méthode demande une gestion manuelle de l'environnement Java mais reste une option solide et éprouvée. La documentation de Jenkins fournit des guides spécifiques pour le déploiement sur différents serveurs d'applications.

Quelle méthode choisir pour bien démarrer ?

Pour les débutants, l'approche Docker est fortement recommandée en raison de sa simplicité d'installation, de sa gestion aisée des dépendances et de la facilité avec laquelle on peut démarrer et arrêter l'environnement. Elle permet de se concentrer rapidement sur l'apprentissage de Jenkins lui-même sans se soucier des détails de l'installation de Java ou de la configuration d'un serveur d'applications.

L'installation via le fichier WAR est une excellente alternative si vous avez déjà une infrastructure Java en place, si vous préférez avoir un contrôle plus direct sur l'environnement, ou si Docker n'est pas une option pour vous. Elle reste une méthode robuste et largement utilisée dans de nombreux contextes professionnels.

Quel que soit votre choix, l'étape suivante sera le premier lancement et la configuration initiale de Jenkins, que nous aborderons dans la section suivante. L'important est de choisir la méthode avec laquelle vous êtes le plus à l'aise pour commencer votre exploration de Jenkins.