Comment installer le serveur d'automatisation Jenkins avec Apache sur Ubuntu 16.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 de Jenkins sur Ubuntu Server 16.04. Nous exécuterons Jenkins sur notre propre nom de domaine, et nous allons installer et configurer Jenkins pour qu’il fonctionne sous le serveur web Apache avec le proxy inverse pour Jenkins.

Prérequis

Ubuntu Server 16.04 - 64 bits
Droits root

Étape 1 - Installer Java OpenJDK 7

Jenkins est basé sur Java, donc nous devons installer Java OpenJDK version 7 sur le serveur. Dans cette étape, nous allons installer Java 7 à partir d’un dépôt PPA que nous allons ajouter en premier.

Par défaut, Ubuntu 16.04 est livré sans le paquet python-software-properties pour gérer les dépôts PPA, donc nous devons d’abord installer ce paquet. Installez python-software-properties avec la commande apt.

apt-get install python-software-properties

Ensuite, ajoutez le dépôt PPA Java au serveur.

add-apt-repository ppa:openjdk-r/ppa  
Just Press ENTER

Mettez à jour le dépôt Ubuntu et installez Java OpenJDK avec la commande apt.

apt-get update  
apt-get install openjdk-7-jdk

Vérifiez l’installation en tapant la commande ci-dessous :

java -version

et vous obtiendrez la version de Java qui est installée sur le serveur.

Installer Java 7 openJDK sur Ubuntu 16.04

É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

Mettez à jour le dépôt et installez Jenkins.

apt-get update  
apt-get install jenkins

Lorsque l’installation est terminée, démarrez Jenkins avec cette commande systemctl.

systemctl start jenkins

Vérifiez que Jenkins fonctionne en vérifiant le port par défaut utilisé par Jenkins (port 8080). Je vais le vérifier avec la commande netstat ci-dessous :

netstat -plntu

Jenkins est installé et fonctionne sur le port 8080.

Jenkins a été installé sur le port 8080

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

Dans ce tutoriel, nous allons exécuter Jenkins derrière un serveur web Apache, nous allons configurer Apache comme proxy inverse pour Jenkins. Tout d’abord, j’installerai Apache et activerai certains modules requis, puis je créerai le fichier d’hôte virtuel avec le nom de domaine my.jenkins.id 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.

apt-get install apache2

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 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        my.jenkins.id  
    ProxyRequests     Off  
    ProxyPreserveHost On  
    AllowEncodedSlashes NoDecode  
   
      
      Order deny,allow  
      Allow from all  
      
   
    ProxyPass         /  http://localhost:8080/ nocanon  
    ProxyPassReverse  /  http://localhost:8080/  
    ProxyPassReverse  /  http://my.jenkins.id/

Enregistrez le fichier. Ensuite, activez l’hôte virtuel Jenkins avec la commande a2ensite.

a2ensite jenkins

Redémarrez Apache et Jenkins.

systemctl restart apache2  
systemctl restart jenkins

Vérifiez que les ports 80 et 8000 sont utilisés par Jenkins et Apache.

netstat -plntu

Vérifiez qu'Apache et Jenkins fonctionnent

Étape 4 - Configurer Jenkins

Jenkins fonctionne sur le nom de domaine ‘my.jenkins.id’. 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  
   
a1789d1561bf413c938122c599cf65c9

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

Installation et configuration de Jenkins

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.

Installer les plugins jenkins

Installation des plugins Jenkins en cours.

Les plugins Jenkins sont installés

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

Créer un compte administrateur Jenkins

Cliquez sur démarrer et commencez à utiliser Jenkins. Vous serez redirigé vers le tableau de bord administrateur de Jenkins.

Être redirigé vers le tableau de bord administrateur

L’installation et la configuration de Jenkins se sont terminées avec succès.

Le tableau de bord administrateur de Jenkins

Étape 5 - 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‘.

Paramètres de sécurité globale de Jenkins

Jenkins fournit plusieurs méthodes d’autorisation dans la section ‘Contrôle d’accès‘. Je sélectionne ‘Sécurité basée sur une matrice‘ pour pouvoir contrôler tous les privilèges des utilisateurs. Activez l’utilisateur administrateur dans la case ‘Utilisateur/Groupe‘ et cliquez sur ajouter. Donnez à l’administrateur tous les privilèges en cochant toutes les options, et donnez à l’anonyme juste des permissions de lecture. Maintenant, cliquez sur ‘Enregistrer‘.

Configurer les permissions de Jenkins

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 6 - Tester un travail d’automatisation simple

Dans cette section, je veux juste tester un travail simple pour le serveur Jenkins. Je vais 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‘.

Créer un nouveau travail dans Jenkins

Entrez le nom du travail, j’utiliserai ‘Vérification du système’ ici, sélectionnez ‘Projet freestyle‘ et cliquez sur ‘OK‘.

Configurer un nouveau travail Jenkins

Allez à l’onglet ‘Construire‘. 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‘.

Démarrer un travail Jenkins

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

Après l’exécution du travail, 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.

Construire et exécuter un travail Jenkins

L’installation de Jenkins avec le serveur web Apache sur Ubuntu 16.04 a été complétée avec succès.