1 Jenkins
Atelier 1 - Installation et configuration de
Jenkins
Objectif
La mise en place du serveur Jenkins et l’installation et la configuration des outils nécessaires
pour la construction d’un Projet (Build) Maven Jenkins.
Introduction
Jenkins est l’orchestrateur de l’usine logicielle, il est utilisé pour construire des projets dans une
grande variété de langages de programmation, y compris Java, .NET, Ruby, Groovy, Grails, PHP
etc. Jenkins prend en charge le build de projets de type Apache Maven, Apache Ant, Gradle,
Freestyle, etc.
Dans cet atelier, vous allez installer un environnement d'intégration continue basé sur Jenkins
pour la construction de projets Maven Jenkins (Jenkins et Maven) en trois phases. Pour ce faire,
vous devez tout d’abord installer un ensemble d’outils (JDK, MAVEN, GIT) nécessaires pour
automatiser le processus de construction. Ensuite, installer et configurer Jenkins sous Linux (en
tant que des packages Linux). Enfin, installer les plugins et configurer les outils dans Jenkins.
• Un complément de cet atelier “Jenkins – Installation sous Windows” présente les étapes
d’installation de Jenkins sous Windows (en tant que des fichiers WAR).
Phase-1 : Installation d’outils pour la construction de projets Maven
Les outils associés à Jenkins pour la construction de projets JAVA Maven sont : JDK, MAVEN, et
GIT :
➢ Installation de JDK 17
– Allez dans le répertoire de votre machine virtuelle Ubuntu, démarrez la machine
virtuelle (vagrant up) et ouvrez un terminal (vagrant ssh). Pour plus d'informations,
consultez le support “Installation Vagrant-Ubunto”
© 2024-2025 UP-ASI
2 Jenkins
– Tapez les commandes suivantes pour installer la OpenJDK 17 (par défaut, Ubuntu
installe la version 11) :
sudo apt update
sudo apt -y upgrade
sudo apt install openjdk-17-jdk
– Pour vérifier que le JDK 17 est bien installé, exécutez la commande suivante :
– Pour que les applications Java puissent trouver la machine virtuelle Java de manière
précise, il est nécessaire de configurer la variable d'environnement "JAVA_HOME".
1. Ouvrir le fichier de configuration système /etc/environment :
2. Ajouter la variable d’environnement suivante dans le fichier /etc/environment :
JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64/"
3. Appliquer les modifications en utilisant la commande suivante :
source /etc/environment
4. Utiliser la commande suivante pour vérifier que JAVA_HOME a été configuré
correctement :
echo $JAVA_HOME
© 2024-2025 UP-ASI
3 Jenkins
➢ Installation de MAVEN
– Pour procéder à l'installation de Maven, veuillez ouvrir votre terminal et exécuter
les commandes suivantes de manière consécutive :
sudo apt install maven -y
M2_HOME="opt/apache-maven-3.6.3"
PATH="$M2_HOME/bin:$PATH"
export PATH
– Pour vérifier que le Maven est bien installé, exécuter la commande suivante :
– Ouvrir le fichier de configuration système /etc/environment et définir la variable
d’environnement de Maven “M2_HOME” :
M2_HOME="opt/apache-maven-3.6.3"
➢ Installation de GIT
– Pour pouvoir utiliser Git avec Jenkins, vous devez installer Git sur votre machine virtuelle
(VM). Aucune configuration de Git dans Jenkins ne sera nécessaire.
sudo apt install git
© 2024-2025 UP-ASI
4 Jenkins
– Pour vérifier que le Git est bien installé, exécuter la commande suivante :
git –-version
Phase-2 : Installation et configuration de Jenkins
– En exécutant les commandes suivantes en ordre, vous installez, configurez et démarrez
Jenkins sur votre système Ubuntu, prêt à être utilisé pour l'intégration continue et
l'automatisation des tâches de développement.
1. Ajouter la clé Jenkins : Cette commande télécharge une clé de sécurité pour Jenkins et
la rend utilisable par le système.
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key |
sudo apt-key add –
2. Ajouter la source Jenkins : Cette commande configure le système pour télécharger les
paquets Jenkins depuis un emplacement spécifique sur le web.
sudo sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ >
/etc/apt/sources.list.d/jenkins.list'
3. Récupérer une autre clé : Cette commande obtient une clé de sécurité supplémentaire
nécessaire pour Jenkins.
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys
5BA31D57EF5975CA
4. Mettre à jour la liste des paquets : Cette commande actualise la liste des logiciels
disponibles pour installation, y compris Jenkins.
sudo apt update
5. Installer Jenkins : Cette commande installe Jenkins et ses composants associés.
sudo apt install Jenkins
6. Démarrer Jenkins : Cette commande démarre Jenkins en tant que service.
sudo systemctl start Jenkins
© 2024-2025 UP-ASI
5 Jenkins
7. Activer le démarrage automatique de Jenkins : Cette commande configure Jenkins
pour qu'il démarre automatiquement lorsque le système démarre.
sudo systemctl enable jenkins
– Pour vérifier l’installation de Jenkins, vous pouvez lancer la commande suivante :
sudo systemctl status jenkins
– Pour accéder à Jenkins, vous devez obtenir l'adresse IP de la machine virtuelle en utilisant la
commande suivante : ip addr show
© 2024-2025 UP-ASI
6 Jenkins
– Lors de l'installation de Jenkins, un fichier contenant le mot de passe initial d'administration
est généré et stocké sur le système. Vous devez accéder à ce mot de passe pour débloquer
Jenkins.
– Pour afficher le mot de passe, utilisez la commande suivante :
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
– Installer les plugins suggérés
© 2024-2025 UP-ASI
7 Jenkins
– Vous n'êtes pas obligé de créer de nouveaux utilisateurs, vous pouvez continuer à utiliser
l'utilisateur "admin".
– Pour personnaliser le numéro de port de Jenkins, vous pouvez simplement le modifier dans
cette fenêtre. Vous avez la possibilité de choisir de maintenir le port 8080 ou d'en sélectionner
un autre selon vos préférences.
– Vous pouvez changer le mot de passe de "admin" à "jenkins" par exemple :
– Jenkins offre une interface web conviviale et intuitive, permettant un accès direct à toutes les
configurations disponibles et fournissant des informations complètes sur tous les jobs.
© 2024-2025 UP-ASI
8 Jenkins
Phase-3 : Installation de plugins et configuration d’outils dans Jenkins
– Pour installer des plugins, il vous suffit d'accéder à la fenêtre de "Plugins".
– Pour créer votre chaîne d'intégration continue, vous allez installer les plugins suivants dans
Jenkins (Installez ces plugins sans redémarrer, puis redémarrez Jenkins à la fin) :
○ Git plugin (normalement déjà installé, mais vérifier)
○ Maven Integration
○ Sonargraph Integration
○ SonarQube Scanner
© 2024-2025 UP-ASI
9 Jenkins
– Après avoir installé les plugins, vous devez redémarrer Jenkins :
sudo systemctl restart jenkins
– Pour configurer les outils, vous devez accéder à la fenêtre "Tools"
– Faites référence au JDK déjà installé sur votre VM et enregistrez cette configuration :
© 2024-2025 UP-ASI
10 Jenkins
– Faites référence au Maven déjà installé sur votre VM et enregistrez cette configuration :
– Rien à configurer
Conclusion
On est bien arrivé au bout de cet atelier, on a pu donc voir comment on met en place un
environnement d’intégration continue. Vous pourrez suivre ces étapes pour installer et
configurer le serveur Jenkins. Pour construire des projets Maven, vous devez installer les outils
nécessaires (JDK, Maven et Git) et les associer à Jenkins. Des plugins indispensables pour la
gestion de builds sont aussi à installer sous le serveur Jenkins.
Vous pourrez trouver une liste exhaustive de plugins à installer sous Jenkins ici.
© 2024-2025 UP-ASI
