Jenkins : Installation et
Utilisation
— Auteur : ILYAS ABBAL
Table des Matières
1. Qu'est-ce que Jenkins ?
2. Prérequis
3. Méthodes d'Installation
1. Installation via Docker
2. Installation via un Package pour Linux (Debian/Ubuntu)
3. Installation via Homebrew (Mac)
4. Installation via WAR (Windows et autres OS)
4. Configuration Initiale de Jenkins
5. Installation de Plugins Essentiels
6. Créer et Configurer un Pipeline Jenkins
7. Utilisation des Jobs Jenkins
8. Configuration des Credentials
9. Meilleures Pratiques et Astuces
10. Conclusion
Jenkins : Installation et Utilisation 1
Qu'est-ce que Jenkins ?
Jenkins est un serveur d'automatisation open-source utilisé principalement
pour l'intégration continue (CI) et la livraison continue (CD). Il permet
d'automatiser les tâches de développement logiciel, comme l'exécution de
tests, le déploiement de l'application, et bien plus encore.
Jenkins est extensible grâce à des plugins, et il prend en charge l'exécution de
tâches sur différents environnements comme Docker, Kubernetes, ou des
machines locales.
Prérequis
Avant de commencer l'installation de Jenkins, assurez-vous que vous avez les
éléments suivants :
Java 8 ou version supérieure : Jenkins nécessite Java pour fonctionner.
Accès à internet : pour télécharger Jenkins et ses plugins.
Accès administrateur sur votre machine ou serveur.
Méthodes d'Installation
1. Installation via Docker
Docker est une méthode rapide et flexible pour installer Jenkins. Si vous avez
Docker installé sur votre machine, suivez ces étapes :
Étapes :
1. Installer Docker (si ce n'est pas déjà fait) :
Guide d'installation de Docker
2. Créer un fichier [Link] :
Créez un fichier
[Link] avec ce contenu pour configurer Jenkins et Docker :
version: '3'
services:
jenkins:
image: jenkins/jenkins:lts
container_name: jenkins
Jenkins : Installation et Utilisation 2
ports:
- "8080:8080"
- "50000:50000"
volumes:
- jenkins_home:/var/jenkins_home
environment:
JENKINS_OPTS: "--httpPort=8080"
restart: always
volumes:
jenkins_home:
3. Lancer Jenkins avec Docker Compose :
Exécutez la commande suivante dans le dossier contenant le fichier
[Link] :
docker-compose up -d
Jenkins sera accessible sur [Link] .
4. Déverrouiller Jenkins :
Une fois Jenkins lancé, ouvrez votre navigateur et accédez à
. Vous devrez entrer un mot de passe pour déverrouiller
[Link]
Jenkins. Ce mot de passe se trouve en exécutant la commande suivante :
docker logs jenkins
Copiez le mot de passe généré et collez-le dans le champ de
déverrouillage.
2. Installation via un Package pour Linux (Debian/Ubuntu)
Étapes :
1. Mettre à jour votre système :
sudo apt update
sudo apt upgrade
Jenkins : Installation et Utilisation 3
2. Ajouter le dépôt Jenkins :
wget -q -O - [Link] | sud
o tee /etc/apt/[Link].d/[Link]
sudo sh -c 'echo deb [Link] $(lsb
_release -cs) main > /etc/apt/[Link].d/[Link]
t'
3. Installer Jenkins :
sudo apt update
sudo apt install jenkins
4. Démarrer Jenkins :
sudo systemctl start jenkins
sudo systemctl enable jenkins
5. Accéder à Jenkins :
Ouvrez un navigateur et accédez à
. Utilisez la même méthode que pour Docker pour
[Link]
déverrouiller Jenkins avec le mot de passe initial.
3. Installation via Homebrew (Mac)
Étapes :
1. Installer Homebrew (si ce n'est pas déjà fait) :
/bin/bash -c "$(curl -fsSL [Link]
[Link]/Homebrew/install/HEAD/[Link])"
2. Installer Jenkins :
brew install jenkins-lts
3. Démarrer Jenkins :
Jenkins : Installation et Utilisation 4
brew services start jenkins-lts
4. Accéder à Jenkins :
Accédez à
[Link] dans votre navigateur.
4. Installation via WAR (Windows et autres OS)
Étapes :
1. Télécharger le fichier WAR de Jenkins :
Téléchargez la dernière version stable de Jenkins depuis
ici.
2. Lancer Jenkins avec Java :
Exécutez la commande suivante dans le terminal (en remplaçant le chemin
par celui où vous avez téléchargé le fichier
[Link] ):
java -jar [Link]
3. Accéder à Jenkins :
Ouvrez
[Link] pour déverrouiller et configurer Jenkins.
Configuration Initiale de Jenkins
1. Déverrouiller Jenkins :
Comme mentionné précédemment, après l'installation, accédez à
[Link] et entrez le mot de passe de déverrouillage récupéré
dans les logs Docker ou dans le fichier .jenkins/secrets/initialAdminPassword
pour les installations sur Linux et autres systèmes.
2. Installation des Plugins Essentiels :
Jenkins vous guidera à travers l'installation de plugins de base. Vous
pouvez installer des plugins supplémentaires via
Manage Jenkins → Manage Plugins.
3. Créer un Utilisateur Administrateur :
Une fois les plugins installés, configurez un utilisateur administrateur pour
Jenkins : Installation et Utilisation 5
sécuriser votre instance Jenkins.
Installation de Plugins Essentiels
1. Git Plugin : Pour l'intégration avec Git.
2. Pipeline Plugin : Pour créer des pipelines Jenkins.
3. SSH Agent Plugin : Pour l'authentification SSH avec les serveurs distants.
4. Docker Plugin : Pour l'intégration avec Docker.
5. Blue Ocean Plugin : Pour une interface utilisateur moderne.
Créer et Configurer un Pipeline Jenkins
Qu'est-ce qu'un Pipeline Jenkins ?
Un Pipeline Jenkins est une définition d'un flux de travail automatisé. Il permet
de décrire une série d'étapes, telles que la construction du code, l'exécution
des tests, le déploiement, etc., sous forme de code. Il existe deux types
principaux de pipelines dans Jenkins :
Pipeline Declaratif (le plus courant) : où vous déclarez un pipeline de
manière structurée.
Pipeline Scripté : basé sur un script Groovy complet, qui offre plus de
flexibilité, mais peut être plus complexe à gérer.
Étapes pour Créer et Configurer un Pipeline Jenkins
1. Créer un Nouveau Job Jenkins
1. Accéder à Jenkins :
Connectez-vous à votre instance Jenkins via
[Link] ou l'adresse correspondante.
2. Créer un Nouveau Job :
Sur la page d'accueil de Jenkins, cliquez sur "New Item".
Donnez un nom à votre job (par exemple, MonPipeline ).
Sélectionnez Pipeline (pas Freestyle project) et cliquez sur OK.
2. Configurer le Pipeline
Jenkins : Installation et Utilisation 6
Une fois que vous avez créé votre pipeline, vous pouvez configurer son
comportement.
1. Définir l'Agent (L'environnement où le pipeline s'exécutera) :
Jenkins doit savoir où exécuter votre pipeline. Vous pouvez utiliser
agent any pour exécuter
le pipeline sur n'importe quel agent disponible.
1. Définir les Étapes :
Les étapes du pipeline sont définies dans la section
stages de votre fichier Jenkinsfile. Exemple de fichier Jenkinsfile :
pipeline {
agent any
stages {
stage('Build') {
steps {
echo 'Building the project...'
// Ajoutez ici vos étapes de build
}
}
stage('Test') {
steps {
echo 'Running tests...'
// Ajoutez ici vos étapes de tests
}
}
stage('Deploy') {
steps {
echo 'Deploying the application...'
// Ajoutez ici vos étapes de déploiement
}
}
}
}
2. Sauvegarder et Exécuter le Pipeline :
Une fois le fichier
Jenkins : Installation et Utilisation 7
Jenkinsfilecréé, vous pouvez sauvegarder et exécuter le pipeline pour voir
si tout fonctionne correctement.
Utilisation des Jobs Jenkins
Les Jobs Jenkins sont des tâches automatisées qui sont exécutées sur
Jenkins. Ils peuvent être utilisés pour des actions comme la construction du
code, le déploiement, ou même des tests automatisés.
Créer un Job
1. Allez dans la page d'accueil de Jenkins et cliquez sur "New Item".
2. Choisissez un type de job comme Freestyle project ou Pipeline.
3. Configurez le job (sources Git, étapes de build, etc.).
4. Sauvegardez et lancez le job pour voir son exécution.
Configuration des Credentials
Jenkins permet de stocker des informations sensibles comme des clés SSH,
des tokens d'accès ou des mots de passe dans des Credentials. Vous pouvez
gérer ces credentials dans "Manage Jenkins" → "Manage Credentials".
Meilleures Pratiques et Astuces
1. Utiliser des Pipelines Déclaratifs : Les pipelines déclaratifs sont plus
faciles à comprendre et à maintenir.
2. Sécuriser Jenkins : Utilisez des credentials et des rôles d'accès pour
contrôler les permissions.
3. Automatiser les Tests : Ajoutez des étapes de tests dans votre pipeline
pour garantir la qualité du code.
Conclusion
Jenkins est un outil puissant pour l'automatisation des processus de
développement logiciel. Avec les bonnes configurations et une bonne gestion
des pipelines, vous pouvez améliorer l'efficacité de vos processus CI/CD.
Jenkins : Installation et Utilisation 8
