Comment configurer Jenkins Master et Slave sur Ubuntu

Jenkins est un serveur d’automatisation dérivé du projet Hudson. Il prend en charge de nombreux systèmes de gestion de contrôle de source (SCM) tels que Git, SVN et Mercurial. Jenkins fournit des centaines de plugins pour automatiser votre projet. Jenkins offre un support pour une architecture ‘maître/esclave’, lui permettant d’héberger un grand nombre de constructions de projets.

Comment fonctionne l’architecture ‘maître/esclave’ de Jenkins ?

L’architecture maître/esclave de Jenkins est utilisée pour des environnements de construction distribués, où la charge de travail de construction des projets est répartie sur plusieurs nœuds agents, et nous pouvons utiliser différents environnements pour chaque construction.

Dans l’architecture ‘maître/esclave’ de Jenkins, un maître se représente comme une installation Jenkins de base et gère toutes les tâches pour le système de construction. Le nœud maître Jenkins sera utilisé pour planifier des travaux, surveiller les nœuds esclaves, dispatcher les constructions aux nœuds esclaves, enregistrer et représenter le résultat de la construction, et exécuter directement les travaux de construction.

Les nœuds esclaves Jenkins sont configurés pour décharger les projets de construction du maître, et une connexion établie entre le maître et les esclaves est requise. Les nœuds esclaves Jenkins peuvent fonctionner sur divers systèmes d’exploitation comme Windows et Linux, et il n’est pas nécessaire d’installer des packages Jenkins complets dessus.

Ce tutoriel nous apprendra à configurer l’architecture maître-esclave de Jenkins en utilisant la dernière version d’Ubuntu. Nous allons apprendre à configurer le serveur maître Jenkins et à ajouter d’autres nœuds Ubuntu en tant qu’esclaves Jenkins.

Prérequis

• Serveur Ubuntu (Ubuntu 22.04 - Ubuntu 16.04) - maître - 10.0.15.10
• esclave01 - 10.0.15.21
• esclave02 - 10.0.15.22
• Privilèges root

Que allons-nous faire ?

1. Installer Jenkins Master
2. Configurer les identifiants du maître Jenkins
3. Configurer les nœuds agents esclaves
4. Ajouter de nouveaux nœuds esclaves
5. Préparer les nœuds agents esclaves pour exécuter la construction
6. Tester

Étape 1 - Installer Jenkins Master

Dans ce tutoriel, nous ne couvrirons pas l’installation de base de Jenkins. Plusieurs articles sur HowtoForge couvrent l’installation de Jenkins.

• Installer Jenkins sur Ubuntu 16.04
• Installer Jenkins sur Ubuntu 18.04
• Installer Jenkins sur Ubuntu 20.04
• Installer Jenkins sur Ubuntu 22.04
• Installer Jenkins sur CentOS 7

Voici notre serveur maître Ubuntu avec Jenkins installé dessus.

Étape 2 - Configurer les identifiants du maître Jenkins

Lorsque vous avez installé le serveur maître Jenkins, nous devons configurer le serveur maître lui-même. Par défaut, il existe différentes manières de démarrer les nœuds agents Jenkins, nous pouvons lancer les nœuds agents via SSH, un compte administratif Windows, et via Java Web Start (JNLP), choisissez la meilleure méthode en fonction de votre configuration d’environnement et de votre système d’exploitation.

Pour ce guide, nous allons lancer les nœuds agents via ssh, et nous devons configurer les identifiants Jenkins sur notre serveur maître.

Générer une clé SSH

Nous allons utiliser l’authentification par clé ssh pour configurer nos nœuds agents, donc nous devons générer la clé ssh pour l’utilisateur Jenkins et ensuite télécharger manuellement la clé sur chaque nœud serveur en utilisant ‘ssh-copy-id’.

Sur le serveur maître Jenkins, connectez-vous à l’utilisateur Jenkins et générez la clé ssh.

su - jenkins  
ssh-keygen

Et vous obtiendrez la clé privée ‘id_rsa’ et la clé publique ‘id_rsa.pub’ dans le répertoire ‘.ssh’.

Configurer les identifiants sur Jenkins

Ouvrez votre tableau de bord Jenkins et cliquez sur le menu ‘Identifiants’ à gauche.

Et cliquez sur le lien de domaine ‘global’.

Maintenant, cliquez sur ‘Ajouter des identifiants’.

Maintenant, choisissez la méthode d’authentification.

• Type : Nom d’utilisateur SSH avec clé privée
• Portée : Globale
• Nom d’utilisateur : jenkins
• Clé privée : Entrez directement et collez la clé privée ‘id_rsa’ de l’utilisateur Jenkins depuis le serveur maître.

Cliquez sur ‘OK’.

Et les identifiants Jenkins avec la méthode de clé d’authentification ssh ont été créés.

Étape 3 - Configurer les nœuds esclaves

Maintenant, nous allons configurer les serveurs de nœuds esclaves en installant java sur ces serveurs et en créant un nouvel utilisateur Jenkins.

Installer Java

Installez les packages ‘software-properties-common’ et ajoutez le dépôt PPA java.

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

Maintenant, installez java OpenJDK en utilisant la commande apt ci-dessous.

sudo apt install openjdk-8-jdk -y

Après l’installation, vérifiez la version de java installée.

java -version

Et vous obtiendrez Java OpenJDK 1.8 installé sur le système.

Ajouter un nouvel utilisateur Jenkins

Ajoutez maintenant l’utilisateur ‘Jenkins’ à tous les nœuds agents.

Exécutez la commande ci-dessous.

useradd -m -s /bin/bash jenkins  
passwd Jenkins

L’utilisateur ‘Jenkins’ pour les nœuds agents a été créé.

Copier la clé SSH du maître vers l’esclave

Ensuite, nous devons télécharger la clé ‘id_rsa.pub’ du maître vers les nœuds serveurs esclaves. Nous devons télécharger sur chaque nœud serveur en utilisant la commande ‘ssh-copy-id’ comme ci-dessous.

ssh-copy-id [email protected]  
ssh-copy-id [email protected]

Tapez le mot de passe de l’utilisateur Jenkins.

La clé ssh ‘id_rsa.pub’ a été téléchargée sur tous les nœuds agents.

Étape 4 - Ajouter de nouveaux nœuds esclaves

Sur le tableau de bord Jenkins, cliquez sur le menu ‘Gérer Jenkins’, puis cliquez sur ‘Gérer les nœuds’.

Cliquez sur ‘Nouveau nœud’.

Tapez le nom du nœud ‘slave01’, choisissez ‘agent permanent’, et cliquez sur ‘OK’.

Maintenant, tapez les détails d’information du nœud.

• Description : serveur agent nœud slave01
• Répertoire racine distant : /home/jenkins
• Étiquettes : slave01
• Méthode de lancement : Lancer l’agent esclave via SSH, tapez l’adresse IP de l’hôte ‘10.0.15.21’, choisissez l’authentification en utilisant les identifiants ‘Jenkins’.

Maintenant, cliquez sur le bouton ‘Enregistrer’ et attendez que le serveur maître se connecte à tous les nœuds agents et lance les services de l’agent.

Voici les résultats lorsque le serveur maître est connecté à tous les nœuds agents.

Les nœuds esclaves Jenkins ont été ajoutés au serveur maître.

Étape 5 - Préparer les nœuds agents esclaves pour exécuter la construction

Dans cette étape, nous allons configurer le maître Jenkins pour exécuter la construction sur les nœuds agents esclaves.

Cliquez sur le menu ‘Gérer Jenkins’ puis cliquez sur ‘Configurer le système’.

Maintenant, allez à la section ‘Configurations des esclaves’ et définissez tout ce dont vous avez besoin comme indiqué ci-dessous.

Plus d’infos sur les ‘Configurations des esclaves’ sur le lien.

Cliquez sur le bouton ‘Enregistrer’ et maintenant nous sommes prêts à exécuter la construction sur les nœuds agents esclaves.

Étape 6 - Tester

Maintenant, nous voulons créer une nouvelle construction simple pour Jenkins et exécuter la construction sur les deux nœuds agents ‘slave01’ et ‘slave02’.

Sur le tableau de bord Jenkins, cliquez sur le menu ‘Nouvel élément’.

Tapez le nom de l’élément, choisissez le projet freestyle, et cliquez sur ‘OK’.

Dans la section générale, tapez la description du travail et cochez l’option ‘Restreindre où ce projet peut être exécuté’.

Dans l’ ‘Expression d’étiquette’, spécifiez le nœud tel que ‘slave01’.

Passez à la section de construction et choisissez l’option ‘Exécuter le shell’, tapez la commande comme ci-dessous.

top -b -n 1 | head -n 10 && hostname

Cliquez sur le bouton ‘Enregistrer’, et vous serez redirigé vers la page du travail.

Cliquez sur ‘Construire maintenant’ pour construire le projet, puis cliquez sur l’élément dans la section ‘Historique des constructions’.

Et voici mon résultat.

Construction sur le nœud agent ‘slave01’.

Construction sur le nœud agent ‘slave02’.

L’installation et la configuration de l’architecture maître/esclave de Jenkins et des constructions distribuées de Jenkins ont été complétées avec succès.

Références

• https://wiki.jenkins.io/