Lancement et premier accès à l'interface Jenkins

Le grand saut : démarrer Jenkins et découvrir son interface

Une fois que vous avez choisi votre méthode d'installation (Docker, WAR, ou autre) et que Jenkins est théoriquement installé, l'étape suivante est son premier lancement effectif et la prise de contact initiale avec son interface utilisateur web. C'est un moment excitant où vous allez enfin voir votre serveur Jenkins prendre vie ! Ce processus est guidé et relativement simple, mais il comporte quelques étapes clés qu'il est important de comprendre pour un démarrage en douceur.

Que vous ayez utilisé Docker ou la méthode du fichier WAR, Jenkins, lors de son premier démarrage, effectue une série d'initialisations. Il prépare son répertoire de base (JENKINS_HOME), génère des configurations initiales et, surtout, sécurise l'accès initial avec un mot de passe administrateur temporaire.

Lancement de Jenkins et déverrouillage initial

Si vous avez utilisé Docker :

• La commande docker run ... que vous avez exécutée devrait avoir démarré le conteneur Jenkins. Vous pouvez vérifier l'état du conteneur avec docker ps.
• Les logs du conteneur (accessibles via docker logs ) sont particulièrement importants lors du premier démarrage. C'est là que Jenkins affichera le mot de passe administrateur initial.

Si vous avez utilisé le fichier WAR (avec java -jar jenkins.war) :

• La console (terminal) où vous avez lancé la commande affichera de nombreuses lignes de log. Jenkins indiquera clairement qu'il démarre et, après un certain temps, il affichera le mot de passe administrateur initial.

Si vous avez déployé le WAR sur un serveur d'applications (ex: Tomcat) :

• Vous devrez consulter les logs de votre serveur d'applications (par exemple, catalina.out pour Tomcat) pour trouver le mot de passe administrateur initial.

Le message clé à rechercher dans les logs :

Quel que soit le mode de lancement, Jenkins affichera un message similaire à celui-ci :

*************************************************************
*************************************************************
*************************************************************

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

THIS_IS_YOUR_INITIAL_ADMIN_PASSWORD

This may also be found at: /var/jenkins_home/secrets/initialAdminPassword

*************************************************************
*************************************************************
*************************************************************

Le chemin /var/jenkins_home/secrets/initialAdminPassword (ou un chemin similaire dépendant de votre configuration de JENKINS_HOME) est l'endroit où ce mot de passe est également stocké sur le système de fichiers de Jenkins. Si vous utilisez Docker avec un volume mappé, vous pourrez accéder à ce fichier depuis votre machine hôte dans le répertoire du volume.

Premier accès à l'interface web et déverrouillage

Une fois Jenkins démarré et le mot de passe initial identifié :

1. Ouvrez votre navigateur web : Lancez votre navigateur préféré (Chrome, Firefox, Edge, etc.).
2. Accédez à l'URL de Jenkins : Tapez l'adresse où Jenkins est accessible. Par défaut, si vous avez mappé le port 8080, ce sera : http://localhost:8080 (ou l'adresse IP de votre serveur si Jenkins est sur une autre machine).
3. Page "Unlock Jenkins" (Déverrouiller Jenkins) : Vous devriez voir une page vous demandant de déverrouiller Jenkins. Elle vous demandera de saisir le mot de passe administrateur initial que vous venez de récupérer dans les logs ou dans le fichier initialAdminPassword.



(Note : Remplacez /path/to/unlock-jenkins-page-example.png par une image représentative si possible, ou décrivez simplement la page.)

4. Saisissez le mot de passe : Copiez-collez le long mot de passe alphanumérique dans le champ prévu à cet effet et cliquez sur "Continue" (Continuer).

Si le mot de passe est correct, vous passerez à l'étape suivante de la configuration : la personnalisation de Jenkins avec les plugins. Ce premier accès sécurisé garantit que seul un utilisateur autorisé peut effectuer la configuration initiale de votre instance Jenkins.

Et après ? La suite de la configuration

Après avoir déverrouillé Jenkins, l'assistant de configuration initiale vous guidera à travers deux étapes importantes :

1. Installation des plugins : Jenkins vous proposera d'installer un ensemble de plugins suggérés (généralement un bon point de départ) ou de sélectionner manuellement les plugins que vous souhaitez installer.
2. Création du premier utilisateur administrateur : Vous serez invité à créer votre propre compte administrateur avec un nom d'utilisateur et un mot de passe. Ce compte remplacera l'utilisation du mot de passe initial temporaire.

Ces étapes seront détaillées dans la section suivante sur la "Configuration post-installation". Pour l'instant, félicitations ! Vous avez réussi à lancer Jenkins et à effectuer le premier accès à son interface. C'est une étape majeure dans votre parcours d'apprentissage de cet outil puissant.

Que faire en cas de problème ?

• Vérifiez les logs : Les logs de Jenkins (console de lancement, logs Docker, logs du serveur d'applications) sont votre meilleure source d'information.
• Vérifiez l'adresse et le port : Assurez-vous d'utiliser la bonne URL et le bon port dans votre navigateur.
• Problèmes de pare-feu : Si Jenkins est sur une autre machine ou dans une VM, vérifiez que le pare-feu autorise les connexions sur le port utilisé par Jenkins.
• Ressources système : Un manque de mémoire ou d'espace disque peut empêcher Jenkins de démarrer correctement.