Comment installer le serveur d'automatisation Jenkins avec Apache sur Ubuntu 18.04

Jenkins est un serveur d’automatisation dérivé du projet Hudson. Jenkins est une application basée sur un serveur fonctionnant dans un conteneur de servlets Java, il prend en charge de nombreux systèmes de gestion de contrôle de version (SCM) tels que Git, SVN et Mercurial. Jenkins fournit des centaines de plugins pour automatiser votre projet. Jenkins, créé par Kohsuke Kawaguchi, a été publié pour la première fois en 2011 sous la licence MIT, et c’est un logiciel libre.

Dans ce tutoriel, je vais vous montrer comment installer la dernière version stable de Jenkins sur Ubuntu Server 18.04 LTS (Bionic Beaver). Nous exécuterons Jenkins sur notre propre nom de domaine, et nous installerons et configurerons Jenkins pour qu’il fonctionne sous le proxy inverse du serveur web Apache.

Prérequis

• Ubuntu 18.04
• Privilèges root

Que allons-nous faire ?

1. Installer Java
2. Installer Jenkins
3. Installer et configurer Apache2 comme proxy inverse pour Jenkins
4. Configurer le pare-feu UFW
5. Configurer Jenkins
6. Sécurité de Jenkins
7. Tests

Étape 1 - Installer Java

Jenkins est une application basée sur Java, donc nous devons installer Java OpenJDK sur le serveur. Dans cette étape, nous allons installer Java 8 à partir d’un dépôt PPA que nous ajouterons d’abord.

Installez les paquets software-properties-common, puis ajoutez le dépôt PPA Java OpenJDK.

sudo apt install software-properties-common apt-transport-https -y  
sudo add-apt-repository ppa:openjdk-r/ppa -y

Maintenant, installez Java 8 en utilisant la commande apt.

sudo apt install openjdk-8-jdk -y

Lorsque l’installation est terminée, vérifiez la version de Java installée sur le système.

java -version

Et vous obtiendrez que Java OpenJDK 1.8 est maintenant installé sur le système Ubuntu 18.04.

Remarque :

• Si vous avez plusieurs versions de Java sur votre système, changez la version Java par défaut en utilisant la commande ci-dessous.

sudo update-alternatives --config java

Étape 2 - Installer Jenkins

Jenkins fournit un dépôt Ubuntu pour les paquets d’installation et nous allons installer Jenkins à partir de ce dépôt.

Ajoutez la clé et le dépôt Jenkins au système avec la commande ci-dessous.

wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -  
echo 'deb https://pkg.jenkins.io/debian-stable binary/' | tee -a /etc/apt/sources.list

Maintenant, mettez à jour le dépôt et installez Jenkins.

sudo apt update  
sudo apt install jenkins -y

Lorsque l’installation est terminée, démarrez le service Jenkins et ajoutez-le au démarrage.

systemctl start jenkins  
systemctl enable jenkins

Jenkins est maintenant opérationnel sur le serveur Ubuntu 18.04, fonctionnant sur le port par défaut ‘8080’. Vérifiez-le en utilisant netstat comme ci-dessous.

netstat -plntu

Et vous obtiendrez le résultat ci-dessous.

Étape 3 - Installer et configurer Apache2 comme proxy inverse pour Jenkins

Dans ce tutoriel, nous allons exécuter Jenkins derrière un serveur web Apache, nous allons configurer Apache comme le proxy inverse pour Jenkins.

Tout d’abord, nous allons installer Apache et activer certains modules requis, puis nous allons créer le fichier d’hôte virtuel avec le nom de domaine jenkins.hakase-labs.io pour Jenkins. Veuillez utiliser votre propre nom de domaine ici et le remplacer dans tous les fichiers de configuration où il apparaît.

Installez le serveur web apache2 à partir du dépôt Ubuntu.

sudo apt install apache2 -y

Lorsque l’installation est terminée, activez les modules proxy et proxy_http afin que nous puissions configurer Apache comme serveur frontal/proxy inverse pour Jenkins.

a2enmod proxy  
a2enmod proxy_http

Ensuite, créez un nouveau fichier d’hôte virtuel pour Jenkins dans le répertoire sites-available.

cd /etc/apache2/sites-available/  
vim jenkins.conf

Collez la configuration de l’hôte virtuel ci-dessous.

    ServerName        jenkins.hakase-labs.io
    ProxyRequests     Off
    ProxyPreserveHost On
    AllowEncodedSlashes NoDecode
 
    
      Order deny,allow
      Allow from all
    
 
    ProxyPass         /  http://localhost:8080/ nocanon
    ProxyPassReverse  /  http://localhost:8080/
    ProxyPassReverse  /  http://jenkins.hakase-labs.io/

Enregistrez et quittez, puis activez l’hôte virtuel Jenkins avec la commande a2ensite.

a2ensite jenkins

Redémarrez les services Apache et Jenkins.

systemctl restart apache2  
systemctl restart jenkins

L’installation et la configuration d’apache2 comme proxy inverse pour Jenkins sont terminées.

Étape 4 - Configurer le pare-feu UFW

Avant d’activer le pare-feu UFW sur le serveur Ubuntu, nous devons ajouter les ports des services de base tels que SSH, HTTP et HTTPS.

Ajoutez les services SSH, HTTP et HTTPS au pare-feu ufw.

ufw allow ssh  
ufw allow http  
ufw allow https

Maintenant, démarrez et activez le pare-feu ufw.

ufw enable

Tapez ‘y’ et appuyez sur Entrée.

Le pare-feu UFW est maintenant activé, et le port HTTP a été ajouté.

Étape 5 - Configurer Jenkins

Jenkins fonctionne sur le nom de domaine ‘ http://jenkins.hakase-labs.io ‘. Ouvrez votre navigateur web et tapez l’URL.

Vous obtiendrez l’écran qui vous demande d’entrer le mot de passe administrateur initial. Un mot de passe a déjà été généré par Jenkins, donc nous devons juste afficher et copier les résultats dans la boîte de mot de passe.

Affichez le mot de passe administrateur initial de Jenkins avec la commande cat.

cat /var/lib/jenkins/secrets/initialAdminPassword

Collez les résultats à l’écran et cliquez sur ‘Continuer’.

Maintenant, nous devrions installer quelques plugins dans Jenkins pour obtenir une bonne base pour une utilisation ultérieure. Choisissez ‘Installer les plugins suggérés’, cliquez dessus.

Installation des plugins Jenkins en cours.

Après que l’installation des plugins soit terminée, nous devons créer un nouveau mot de passe administrateur. Tapez votre nom d’utilisateur administrateur, mot de passe, email, etc. et cliquez sur ‘Enregistrer et continuer’.

Pour la configuration de l’instance, tapez le nom de domaine Jenkins ‘http://jenkins.hakase-labs.io’ et cliquez sur le bouton ‘Enregistrer et terminer’.

Maintenant, cliquez sur le bouton ‘Commencer à utiliser Jenkins’.

Et vous serez redirigé vers le tableau de bord administrateur de Jenkins.

L’installation et la configuration de Jenkins ont été complétées avec succès.

Étape 6 - Sécurité de Jenkins

Depuis le tableau de bord administrateur de Jenkins, nous devons configurer les paramètres de sécurité standard pour Jenkins, cliquez sur ‘Gérer Jenkins’ puis sur ‘Configurer la sécurité globale’.

Jenkins fournit plusieurs méthodes d’autorisation dans la section ‘Contrôle d’accès’. Nous allons utiliser la ‘Sécurité basée sur la matrice’, afin que nous puissions contrôler tous les privilèges des utilisateurs.

Ajoutez l’utilisateur ‘hakase’ dans la case ‘Utilisateur/Groupe’ et cliquez sur ajouter.

Donnez à l’utilisateur ‘hakase’ tous les privilèges en cochant toutes les options, et cliquez sur le bouton ‘Enregistrer’.

Vous serez redirigé vers le tableau de bord, et s’il y a une option de connexion, tapez simplement votre utilisateur administrateur et mot de passe.

Étape 7 - Tests

Dans cette section, nous voulons créer un travail simple pour le serveur Jenkins. Nous allons créer un travail simple pour tester Jenkins et pour découvrir la charge du serveur avec la commande top.

Depuis le tableau de bord administrateur de Jenkins, cliquez sur ‘Créer un nouveau travail’.

Tapez le nom du travail. Nous allons utiliser ‘Vérification du système’ ici, sélectionnez ‘Projet freestyle’ et cliquez sur ‘OK’.

Allez à l’onglet ‘Build’. Dans ‘Ajouter une étape de construction’, sélectionnez l’option ‘Exécuter un shell’.

Tapez la commande ci-dessous dans la boîte.

top -b -n 1 | head -n 5

Cliquez sur ‘Enregistrer’.

Maintenant, vous êtes sur la page de travail du travail ‘Vérification du système’. Cliquez sur ‘Construire maintenant’ pour exécuter le travail ‘vérification du système’.

Après que le travail ait été exécuté, vous verrez l’ ‘Historique des constructions’, cliquez sur le premier travail pour voir les résultats.

Voici les résultats du travail exécuté par Jenkins.

L’installation et la configuration de l’outil d’automatisation Jenkins avec Apache2 comme proxy inverse sur Ubuntu 18.04 ont été complétées avec succès.

Références

• https://wiki.jenkins.io/
• https://wiki.jenkins.io/Standard+Security+Setup
• https://jenkins-le-guide-complet.github.io/