Comment installer Jenkins sur Ubuntu 22.04

Jenkins est un outil d’automatisation open-source pour l’intégration continue/livraison continue (CI/CD). Il est entièrement écrit en Java avec le support de plus de 1000 plugins pour construire, déployer et automatiser votre projet. Jenkins est devenu l’un des principaux outils d’automatisation qui accélèrent votre processus de développement grâce à l’automatisation. Jenkins intègre des processus du cycle de vie du développement tels que la construction, la documentation, le test, l’emballage, la mise en scène, le déploiement, l’analyse statique, et bien plus encore.

Jenkins prend en charge plusieurs outils de contrôle de version tels que Git, Subversion, Mercurial, CVS, Perforce et RTC. De plus, il peut exécuter Apache Ant, Apache Maven, des scripts shell et des commandes batch Windows. Jenkins bénéficie d’un fort soutien communautaire avec une documentation extensive et un wiki, ce qui en fait l’un des outils d’automatisation CI/CD les plus utilisés. De plus, il offre de nombreux outils, langages et tâches d’automatisation pour automatiser votre processus de développement et de déploiement.

Dans ce tutoriel, vous apprendrez comment installer Jenkins sur le dernier Ubuntu 22.04. Ce tutoriel couvre également comment configurer Apache2 en tant que proxy inverse pour Jenkins avec une connexion SSL activée. À la fin, vous apprendrez également comment créer le premier projet de construction Jenkins pour exécuter des scripts ou des commandes shell.

Prérequis

• Un serveur Ubuntu 20.04
• Un utilisateur non-root avec des privilèges d’administrateur root.

Installation de Java

Dans cette première étape, vous allez installer Java OpenJDK et JRE sur votre système Ubuntu. La dernière version de Jenkins nécessite Java v11, et maintenant vous allez l’installer sur votre système.

Avant de commencer à installer des paquets, exécutez la commande apt ci-dessous pour mettre à jour et rafraîchir votre dépôt Ubuntu.

sudo apt update

Maintenant, installez Java OpenJDK 11 en utilisant la commande suivante.

sudo apt install openjdk-11-jre

Entrez Y pour confirmer et appuyez sur ENTER pour commencer l’installation. Maintenant, l’installation de Java OpenJDK va commencer.

Après l’installation, exécutez la commande java ci-dessous pour vérifier et valider la version de java.

java --version

Dans la capture d’écran suivante, vous pouvez voir que Java OpenJDK 11 est installé sur la machine Ubuntu 22.04.

Installation de Jenkins

Vous avez maintenant installé Java sur votre système Ubuntu, maintenant vous allez commencer à installer Jenkins sur la machine Ubuntu 22.04.

Il existe plusieurs façons d’installer Jenkins, la façon la plus simple est d’utiliser le paquet Jenkins pré-construit fourni par le dépôt officiel de Jenkins. Et pour ce faire, vous devrez ajouter le dépôt Jenkins à votre système Ubuntu.

Exécutez la commande ci-dessous pour ajouter la clé GPG pour le dépôt jenkins.

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \  
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

Après cela, ajoutez le dépôt Jenkins à votre système en utilisant la commande ci-dessous.

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \  
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \  
  /etc/apt/sources.list.d/jenkins.list > /dev/null

Maintenant, exécutez la commande apt ci-dessous pour mettre à jour et rafraîchir tous vos dépôts système.

sudo apt update

Dans la capture d’écran ci-dessous, vous pouvez voir que le dépôt Jenkins a été ajouté.

Ensuite, vous pouvez installer Jenkins en utilisant la commande apt ci-dessous.

sudo apt install jenkins

Entrez Y pour confirmer l’installation et appuyez sur ENTER pour continuer. L’installation de Jenkins va maintenant commencer.

Après l’installation, exécutez la commande suivante pour démarrer et activer le service Jenkins.

sudo systemctl start jenkins  
sudo systemctl enable jenkins

Maintenant, vérifiez le service Jenkins en utilisant la commande ci-dessous.

sudo systemctl status jenkins

Dans la capture d’écran suivante, le service Jenkins est actif et en cours d’exécution. Il fonctionne sur localhost avec le port par défaut 8080. De plus, Jenkins est maintenant activé, ce qui signifie qu’il sera exécuté automatiquement au démarrage du système.

Configuration d’Apache2 en tant que Proxy Inverse

À ce stade, Jenkins est opérationnel à l’adresse par défaut localhost avec le port 8080. Maintenant, vous allez installer et configurer le serveur web Apache2 en tant que proxy inverse pour Jenkins.

Le serveur web Apache2 fonctionnera devant le service Jenkins et ouvrira les ports HTTP et HTTPS standards pour l’accès client.

Exécutez la commande apt ci-dessous pour installer le paquet apache2 sur votre système.

sudo apt install apache2

Entrez Y pour confirmer l’installation et appuyez sur ENTER pour continuer.

Maintenant, après l’installation, exécutez la commande ci-dessous pour activer certains modules apache2 nécessaires à la configuration du proxy inverse.

sudo a2enmod ssl rewrite headers proxy proxy_http

Vous verrez maintenant la sortie comme dans la capture d’écran suivante.

Ensuite, créez une nouvelle configuration d’hôte virtuel /etc/apache2/sites-available/jenkins.conf en utilisant l’éditeur nano.

sudo nano /etc/apache2/sites-available/jenkins.conf

Ajoutez la configuration suivante au fichier. Et assurez-vous de changer le nom de domaine et le chemin des certificats SSL.

  
    ServerAdmin  webmaster@localhost  
    Redirect permanent / https://jenkins.howtoforge.local/  
  
  
  
    SSLEngine On  
    SSLCertificateFile /etc/letsencrypt/live/jenkins.howtoforge.local/fullchain.pem  
    SSLCertificateKeyFile /etc/letsencrypt/live/jenkins.howtoforge.local/privkey.pem  
    ServerAdmin  webmaster@localhost  
    ProxyRequests     Off  
    ProxyPreserveHost On  
    AllowEncodedSlashes NoDecode  
      
        Order deny,allow  
        Allow from all  
      
    ProxyPass         /  http://localhost:8080/ nocanon  
    ProxyPassReverse  /  http://localhost:8080/  
    ProxyPassReverse  /  http://jenkins.howtoforge.local/  
    RequestHeader set X-Forwarded-Proto "https"  
    RequestHeader set X-Forwarded-Port "443"  

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ensuite, exécutez la commande suivante pour activer la configuration de l’hôte virtuel jenkins.conf.

sudo a2ensite jenkins.conf

Après cela, vérifiez et validez toutes vos configurations Apache2 en utilisant la commande ci-dessous.

sudo apachectl configtest

Assurez-vous d’obtenir le message de sortie tel que “ Syntax OK “, ce qui signifie que toutes vos configurations Apache2 sont correctes.

Enfin, exécutez la commande ci-dessous pour redémarrer le service Apache2 et appliquer les nouvelles modifications à votre configuration Apache2.

sudo systemctl restart apache2

Maintenant, le serveur web Apache2 est opérationnel avec la configuration de proxy inverse pour Jenkins.

Démarrer l’installation de Jenkins

À ce stade, vous êtes prêt à commencer l’installation et la configuration de Jenkins depuis votre navigateur web. Mais avant de commencer à configurer Jenkins, vous devrez obtenir et récupérer le mot de passe d’initialisation pour Jenkins.

Le mot de passe d’initialisation pour Jenkins est disponible dans le fichier /var/lib/jenkins/secrets/initialAdminPassword. Ce fichier contient le mot de passe secret généré pour initialiser votre installation de Jenkins.

Exécutez la commande ci-dessous pour vérifier et obtenir le mot de passe initial de jenkins.

ls /var/lib/jenkins/secrets/initialAdminPassword  
cat /var/lib/jenkins/secrets/initialAdminPassword

Dans la capture d’écran ci-dessous, vous pouvez voir une chaîne aléatoire générée par Jenkins. Vous pouvez avoir un secret aléatoire différent.

Copiez le mot de passe secret initial dans vos notes, cela sera utilisé plus tard pour configurer Jenkins.

Ouvrez votre navigateur web et visitez l’URL d’installation pour votre installation de Jenkins (par exemple https://jenkins.howtoforge.local).

Sur la première page, vous serez invité à entrer le mot de passe d’initialisation pour Jenkins. Collez votre mot de passe secret pour initialiser l’installation et la configuration de Jenkins, puis cliquez sur Continuer.

Maintenant, cliquez sur le bouton “ Installer les plugins suggérés “ pour commencer la configuration de Jenkins avec des plugins supplémentaires. Cette option est bonne pour les débutants, cela installera automatiquement certains plugins Jenkins qui peuvent être nécessaires pour votre projet.

Maintenant, l’installation des plugins Jenkins va commencer et démarrer.

Après que le processus d’installation soit terminé, vous serez maintenant invité à créer un nouvel utilisateur admin pour Jenkins.

Entrez le nouvel utilisateur admin, le mot de passe, l’adresse e-mail et le nom complet pour votre installation de Jenkins et cliquez sur le bouton Enregistrer et Continuer.

Pour l’URL d’installation de Jenkins, entrez votre domaine Jenkins et cliquez sur Enregistrer et Terminer.

Et maintenant, vous obtiendrez la page suivante. Cliquez sur le bouton Redémarrer pour redémarrer le service Jenkins et appliquer les nouvelles configurations.

Une fois Jenkins redémarré, visitez à nouveau le nom de domaine de votre URL d’installation Jenkins et maintenant vous obtiendrez la page de connexion de Jenkins.

Entrez votre utilisateur admin et mot de passe pour Jenkins et cliquez sur Se connecter.

Une fois connecté, vous obtiendrez le tableau de bord Jenkins suivant.

Vous avez maintenant installé et configuré avec succès Jenkins sur le dernier Ubuntu 22.04 avec Apache2 en tant que proxy inverse pour votre déploiement.

Création de la première construction Jenkins

Après avoir installé et configuré Jenkins avec succès, vous allez maintenant créer une nouvelle première construction Jenkins depuis le tableau de bord Jenkins.

Sur le tableau de bord Jenkins, cliquez sur le menu Nouvel Élément pour créer un nouveau projet de construction Jenkins.

Entrez le nom du projet et sélectionnez le type de projet, puis cliquez sur OK. Dans cette démo, le nom du projet est “première construction” avec le type de projet “ Projet Freestyle “.

Dans la “ section générale “, saisissez la description de votre construction.

Maintenant, passez à l’onglet “ Construire “ et choisissez la construction comme “ Exécuter un shell “ et saisissez la commande suivante comme commande de construction.

echo "Ceci est une construction de test sur jenkins"

Ce projet ne fera qu’afficher un message “Ceci est une construction de test sur jenkins” dans la sortie de construction Jenkins.

Maintenant, cliquez sur le bouton Enregistrer.

Maintenant, dans les détails du projet “ première construction “, cliquez sur le menu “ Construire Maintenant “ pour démarrer et exécuter la construction Jenkins.

Après que le processus soit terminé, vous pouvez voir la section d’historique de construction dans le menu inférieur comme dans la capture d’écran suivante.

Cliquez sur le numéro de construction pour obtenir les détails de l’opération de construction qui a été complétée.

Maintenant, cliquez sur le menu “ Sortie de Console “ et vous obtiendrez la sortie de votre première construction Jenkins, qui est le message “ Ceci est une construction de test sur jenkins “. Et la construction Jenkins est un succès.

Conclusion

Félicitations ! Vous avez maintenant installé avec succès Jenkins sur le dernier serveur Ubuntu 22.04 avec Apache2 en tant que proxy inverse avec une connexion sécurisée HTTPS activée. De plus, vous avez appris l’initialisation et la configuration de base de Jenkins, et vous avez également créé le premier projet de construction simple en utilisant Jenkins.