GUIDE TECHNIQUE · JENKINS
Jenkins : Créer son premier Jenkinsfile
Créer un Jenkinsfile déclaratif et vérifier une pipeline Jenkins à deux stages sans secret ni déploiement.
L’ESSENTIEL EN BREF
Les étapes clés
Ce guide présente 4 étapes, de « Vérifier le contexte » à « Lancer et lire le build ».
Avant de commencer : Jenkins et agent de build opérationnels.
01 · CADRAGE
Périmètre et résultat visé
Résultat attendu : Jenkinsfile versionné.
Public concerné : Développeurs, DevOps et ingénieurs CI
Jenkins LTS récent, plugin Pipeline et agent Linux de recette.
Contrôlez les versions, les droits et les options disponibles dans votre environnement avant de suivre la procédure.
02 · AVANT DE COMMENCER
Prérequis et points de contrôle
- Jenkins et agent de build opérationnels.
- Dépôt Git de recette contenant un Jenkinsfile.
- Droits Job/Build sans administration globale.
03 · VUE D’ENSEMBLE
Comprendre l’architecture et les flux
04 · TUTORIEL
Procédure complète, étape par étape
Suivez les étapes dans l’ordre et contrôlez chaque résultat avant de poursuivre. Renseignez les paramètres adaptés à votre environnement.
ÉTAPE 1 / 4
Vérifier le contexte
Une pipeline doit s'exécuter dans un agent identifié.
- Créer un dépôt et un job Pipeline ou Multibranch de recette.
- Vérifier la disponibilité de l'agent Linux.
git status --shortÀ vérifier : Le dépôt est isolé et l'agent existe.
Point de vigilance : Ne jamais lancer un premier test sur un agent de déploiement de production.
ÉTAPE 2 / 4
Rédiger un Jenkinsfile
La syntaxe déclarative rend les stages visibles.
- Ajouter pipeline, agent et deux stages.
- Ne pas ajouter de credentials ni de déploiement.
pipeline {
agent any
stages {
stage('Verify') { steps { sh 'uname -s' } }
stage('Test') { steps { sh 'echo CI-ok' } }
}
}À vérifier : Les deux stages sont définis.
Point de vigilance : agent any dépend des agents disponibles : utiliser un label dans les parcs segmentés.
ÉTAPE 3 / 4
Contrôler la syntaxe
Une erreur de syntaxe doit être arrêtée avant exécution.
- Utiliser la validation Jenkinsfile disponible sur le contrôleur.
- Relire les commandes et l'environnement sélectionné.
# Jenkins UI : Pipeline Syntax / Declarative Directive GeneratorÀ vérifier : La structure est acceptée par Jenkins.
Point de vigilance : La validation statique n'évalue pas les autorisations d'un step shell.
ÉTAPE 4 / 4
Lancer et lire le build
La console fournit les preuves de passage.
- Exécuter un build de recette.
- Contrôler les stages, le code de retour et la sortie sans secret.
# Sortie attendue : Linux puis CI-okÀ vérifier : Le build est terminé avec succès.
Point de vigilance : Ne jamais considérer un résultat vert comme une preuve de qualité applicative suffisante.
RÉFÉRENCES TECHNIQUES
Documentation officielle
Retrouvez les prérequis, les fonctionnalités et les versions prises en charge par Jenkins. Vérifiez les commandes sur un environnement de test avant leur utilisation en production.
05 · RECETTE
Comment vérifier que tout fonctionne ?
Jenkinsfile versionné.
Les deux stages sont visibles.
Aucune donnée sensible n'est journalisée.
06 · DIAGNOSTIC
Problèmes fréquents et résolution
No node available
Cause probable : Agent absent ou saturé
Que faire : Vérifier les labels et la capacité des agents.
sh not found
Cause probable : Agent non compatible shell POSIX
Que faire : Utiliser un exécuteur adapté.
Syntax error
Cause probable : Groovy déclaratif invalide
Que faire : Examiner la ligne indiquée dans la console.
07 · QUESTIONS PRATIQUES
Questions fréquentes
Pourquoi versionner Jenkinsfile ?
Pour relire et reproduire les étapes avec le code.
Pipeline ou freestyle ?
Pipeline apporte un workflow déclaratif et traçable.
Un agent any est-il sûr ?
Seulement si la segmentation des agents correspond aux droits du job.
AUTRES TECHNOLOGIES
Guides complémentaires
VOTRE ENVIRONNEMENT
Besoin d’aller plus loin sur votre environnement ?
Automatisation, sécurité et exploitation : échangeons sur vos pratiques Jenkins.
Échanger avec ADN Consulting