Lorsque vous installez Jenkins pour la première fois, l’outil vous accueille avec un assistant d’installation (Setup Wizard). Celui-ci vous demande de déverrouiller Jenkins avec le mot de passe initial, puis propose deux options :
- Installer les plugins suggérés (Install suggested plugins)
- Sélectionner manuellement les plugins à installer
Mais une fois ce choix fait ou ignoré, impossible de revoir cet écran lors des prochains démarrages. De plus, dans ce cas, vous ne pourrez créer que des jobs de type Free style. D’autres types de Jobs comme Pipline ou même Pipeline Multi-branches ne seront pas fournis.
Que faire si vous voulez rejouer le wizard, par exemple pour installer à nouveau les plugins recommandés ou réinitialiser votre Jenkins comme au premier jour ? C’est exactement ce que nous allons voir dans cet article.
Pourquoi l’assistant disparaît après la première utilisation
Jenkins ne relance pas l’assistant à chaque démarrage, car il enregistre l’état de configuration dans des fichiers internes. Parmi les plus importants :
- /var/lib/jenkins/jenkins.install.UpgradeWizard.state
- /var/lib/jenkins/jenkins.install.InstallUtil.lastExecVersion
- /var/lib/jenkins/config.xml (configuration principale)
- /var/lib/jenkins/users/ (comptes utilisateurs)
Tant que ces fichiers existent, Jenkins considère que l’installation est terminée.
Réafficher le premier écran d’installation
Attention : La manipulation ci-dessous effacera vos utilisateurs et votre configuration Jenkins actuelle. Faites toujours une sauvegarde avant de continuer.
1. Arrêter Jenkins
sudo systemctl stop jenkins
2. Sauvegarder la configuration actuelle
sudo cp /var/lib/jenkins/config.xml /var/lib/jenkins/config.xml.bak</p> <p>sudo cp -r /var/lib/jenkins/users /var/lib/jenkins/users.bak
3. Supprimer les fichiers de configuration et d’état
sudo rm /var/lib/jenkins/config.xml </p> <p>sudo rm -r /var/lib/jenkins/users sudo rm /var/lib/jenkins/jenkins.install.UpgradeWizard.state </p> <p>sudo rm /var/lib/jenkins/jenkins.install.InstallUtil.lastExecVersion
4. Redémarrer Jenkins
sudo systemctl start jenkins
5. Se reconnecter à l’interface
- Ouvrez http://localhost:8080
- Entrez le mot de passe initial contenu dans : cat /var/lib/jenkins/secrets/initialAdminPassword
- Vous retrouverez l’écran du wizard et pourrez à nouveau choisir Install suggested plugins.
Réafficher l’assistant d’installation de Jenkins est possible en supprimant certains fichiers clés (config.xml, users/, et les états du wizard). Cela permet de repartir comme si Jenkins venait tout juste d’être installé, avec la possibilité d’installer les plugins recommandés en un clic.
