Comment télécharger et installer Jenkins on Windows

Jenkins peut être installé sur l'un ou l'autre Windows ou les plateformes Unix, mais ce guide se concentre sur les Windows Installation uniquement. Windows L'installateur MSI s'enregistre Jenkins en tant que Windows service et sélectionne un 64 bits Java L'exécution est prise en charge, ce qui en fait la solution la plus rapide pour obtenir un serveur d'automatisation fonctionnel. Avant d'ouvrir le programme d'installation, vérifiez que votre machine répond aux exigences indiquées dans la section suivante.

Jenkins Prérequis et configuration système requise

Jenkins Elle est légère au repos, mais sa taille augmente rapidement avec l'accumulation de l'historique des builds, des espaces de travail et des plugins. Un dimensionnement correct de la machine dès le départ évite une migration difficile par la suite.

Matériel requis:

Configuration logicielle:

• Jenkins fonctionne sur Java, donc un support Java Kit de développement (JDK) ou Java L'environnement d'exécution (JRE) doit être présent. Actuellement Jenkins Les versions nécessitent Java 21 ou plus tard; Java Les versions 8, 11 et 17 ne sont plus prises en charge par la nouvelle ligne de support à long terme.
• Un navigateur web moderne est nécessaire pour accéder au Jenkins tableau de bord.
• Un compte disposant de droits d'administrateur sur le Windows une machine est nécessaire pour enregistrer Jenkins après-vente.

Confirmez l'installation Java Vérifiez la version depuis l'invite de commandes avant de continuer. Si la commande échoue ou renvoie une version inférieure à 21, installez d'abord un JDK compatible.

:: Check the Java version available on the machine
java -version

:: Expected output resembles the following
openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)

Types de libération

Jenkins Il publie deux lignes de version, et votre choix influence la fréquence de vos mises à jour.

Ce guide utilise la version LTS, mais la procédure d'installation est identique pour la version hebdomadaire. Une fois les prérequis installés, le téléchargement peut commencer.

Comment télécharger Jenkins?

Suivez les étapes ci-dessous pour obtenir le Windows installer et mener à bien l'installation :

Étape 1) Allez dans https://www.jenkins.io/download/ et sélectionnez la plateforme. Dans notre cas, Windows.

Étape 2) Accédez à l'emplacement de téléchargement sur votre ordinateur et décompressez le fichier téléchargé. Double-cliquez sur le fichier décompressé jenkins.msi fichier. Jenkins peut également être exécuté à partir d'un fichier WAR (Web application ARchive), mais cette méthode n'est pas recommandée sur Windows car il contourne l'enregistrement du service géré par le programme d'installation.

À noter: Windows SmartScreen peut signaler qu'il a empêché le démarrage d'une application non reconnue. Sélectionnez Plus d'info, puis Exécuter quand même, pour continuer avec le signé Jenkins installateur

Étape 3) Dans l' Jenkins Écran de configuration, cliquez Suivant.

Étape 4) Choisissez l'emplacement où le Jenkins L'instance doit être installée. L'emplacement par défaut sur les installateurs 64 bits actuels est : C: \ Program Files \JenkinsNotez ce chemin, car le mot de passe administrateur initial y est stocké. Cliquez Suivant.

Étape 5) Le programme d'installation demande ensuite les identifiants de connexion au service et le numéro de port. Fournissez un compte local ou de domaine dédié et cliquez sur Identifiants de test, puis définissez le port et cliquez Port de test. Port 8080 est la valeur par défaut. Exécution Jenkins L'utilisation d'un compte de service nommé est plus sûre que l'option LocalSystem, qui accorde Jenkins accès complet à la machine.

Étape 6) Confirmez le Java Dans le répertoire personnel détecté par le programme d'installation, examinez les options de configuration personnalisée et cliquez sur Installer bouton. Une fois l'installation terminée, cliquez sur Finition.

Étape 7) Pendant l'installation, un panneau d'information peut s'afficher pour vous indiquer qu'un redémarrage est nécessaire à la fin de l'installation. Cliquez sur le bouton. OK bouton lorsque le panneau d'informations apparaît.

Les fichiers sont désormais sur le disque et le service est enregistré. L'étape suivante consiste à débloquer l'interface web.

Comment débloquer Jenkins?

Après avoir terminé le Jenkins Lors de l'installation, le contrôleur est verrouillé jusqu'à ce que vous fournissiez un mot de passe généré automatiquement. Les étapes ci-dessous expliquent comment le déverrouiller. Jenkins demande:

Étape 1) Une fois l'installation terminée, un onglet s'ouvre dans votre navigateur et vous demande le mot de passe administrateur initial. Pour accéder à Jenkins, accédez au chemin suivant dans votre navigateur Web.
http://localhost:8080

Si l'adresse ci-dessus se charge, l'installation a réussi et le service est en cours d'exécution.

Étape 2) Le mot de passe administrateur initial est stocké sous le répertoire suivant : Jenkins Chemin d'installation que vous avez défini à l'étape 4 de l'installation. Pour l'emplacement par défaut C: \ Program Files \Jenkins, un fichier appelé mot de passeadministrateur initial se trouve sous C: \ Program Files \JenkinssecretsSi un chemin personnalisé a été sélectionné, vérifiez plutôt cet emplacement. La même valeur est également écrite dans le jenkins.err.log déposer dans le Jenkins répertoire personnel.

Étape 3) Ouvrez le fichier mis en surbrillance et copiez son contenu. mot de passeadministrateur initial fichier.

Étape 4) Collez le mot de passe dans le Mot de passe administrateur champ sur le déverrouillage Jenkins la page dans votre navigateur et cliquez sur Continuer .

Une fois la manette déverrouillée, l'assistant d'installation passe aux plugins et au premier compte utilisateur.

Personnaliser Jenkins

Vous pouvez également personnaliser votre Jenkins environnement en suivant les étapes ci-dessous :

Étape 1) Cliquez sur Installer les plugins suggérés bouton pour que Jenkins récupère et installe les plugins essentiels.

Jenkins commence à télécharger et à installer tous les plugins nécessaires à la création de nouveaux Jenkins emplois.

À noter: Vous pouvez choisir l'option Sélectionnez les plugins à installer et sélectionnez uniquement les plugins que vous souhaitez. Vous pourrez ajouter ou supprimer des plugins ultérieurement. Gérer Jenkins > Plugins, ce choix n'est donc pas définitif.

Étape 2) Une fois tous les plugins suggérés installés, le Créer un premier utilisateur administrateur Le panneau s'affiche. Remplissez tous les champs avec les informations de compte souhaitées et cliquez sur le bouton. Enregistrer et terminer .

Étape 3) Jenkins finit par demander le URL où l'instance sera atteinte. Conservez la valeur par défaut pour éviter toute confusion ultérieure. Si une autre application utilise déjà le port 8080, indiquez un autre port ici, puis cliquez sur le bouton. Sauvegarder et continuer .

Félicitations ! Un nouveau Jenkins Le serveur est maintenant installé. Cliquez sur Commencer à utiliser Jenkins .

Le Jenkins L'instance est opérationnelle et prête pour votre première tâche. Un court Jenkins tutoriel pour débutants explique comment créer cet emploi.

Comment vérifier le Jenkins Installation et gestion du service

Un tableau de bord qui se charge une seule fois ne prouve pas le bon fonctionnement de l'installation. En effet, le programme d'installation MSI enregistre… Jenkins en tant que Windows Le service doit pouvoir redémarrer correctement après un redémarrage. Veuillez effectuer les vérifications ci-dessous immédiatement après la fermeture de l'assistant d'installation.

1. Confirmez l'existence du service. Presse Win + R, Le type services.msc, puis appuyez sur Entrée. Repérez l'entrée nommée Jenkins et confirmer que le statut est le suivant Fonctionnement et le type de démarrage se lit Automatique.
2. Vérifiez le compte utilisé. Ouvrez les propriétés de Jenkins service et avis connecter Un compte de service dédié est préférable à LocalSystem pour toute opération dépassant le cadre d'expérimentations locales.
3. Vérifiez le port d'écoute. Courir netstat -ano | findstr :8080 à partir de l'invite de commandes. Une entrée LISTING confirme que Jenkins détient le port.
4. Lisez la bannière de version. Connectez-vous à http://localhost:8080 Lisez ensuite le numéro de version situé en bas à droite du tableau de bord. Comparez-le avec celui de la version que vous avez téléchargée.
5. Redémarrez une fois. Recommencer Windows Accédez ensuite au tableau de bord sans rien lancer manuellement. Si la page se charge, le service est bien automatique.

Le service peut également être contrôlé depuis une invite de commandes avec privilèges élevés, ce qui est plus rapide que la console graphique et fonctionne bien dans les scripts de déploiement :

:: Stop, start, and query the Jenkins Windows service
net stop "Jenkins"
net start "Jenkins"
sc query "Jenkins"

:: Install Jenkins silently on a fleet of machines
msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^
  INSTALLDIR="D:\Jenkins" ^
  PORT=8080 ^
  /L*v "C:\logs\jenkins-install.txt"

Astuce : Le programme d'installation silencieux accepte INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME et SERVICE_PASSWORD Les propriétés peuvent être modifiées. Toute valeur non spécifiée prend sa valeur par défaut, et en mode silencieux, le service s'exécute en tant que LocalSystem sauf si un compte de service est fourni.

Si l'un de ces contrôles échoue, les causes sont généralement prévisibles, comme le montre la section suivante.

Commun Jenkins Erreurs d'installation sur Windows et comment les réparer

La plupart ont échoué Windows installations tracnous revenons à un petit ensemble de causes : un non-supporté Java Il peut s'agir d'une erreur d'exécution, d'un port occupé ou d'un compte de service ne disposant pas des droits nécessaires pour se connecter en tant que service. Chaque problème engendre un symptôme distinct ; la résolution est donc généralement rapide une fois le message d'erreur lu attentivement.

• Informations d'identification de connexion au service non valides : Le programme d'installation rejette le compte pendant l'installation. Identifiants de test étape. Ouvrir secpol.msc, développer Politiques locales > Attribution des droits d'utilisateur, ouvert Connectez-vous en tant que serviceAjoutez ensuite le compte. Puis, réessayez le test d'authentification.
• Le port 8080 est déjà utilisé : Le Port de test Le bouton devient rouge car une autre application, souvent un serveur Tomcat local ou un serveur de développement, utilise déjà le port. Choisissez un port libre comme le 8081, ou arrêtez le processus en conflit identifié par netstat -ano.
• Non pris en charge ou manquant Java: L'installateur ne peut pas préremplir le Java Sinon, le service démarre et s'arrête immédiatement. Installez un JDK 21 ou une version ultérieure 64 bits, puis indiquez à l'installateur son répertoire d'installation.
• SmartScreen bloque le programme d'installation : Windows Signale une application non reconnue. Sélectionner Plus d'info, puis Exécuter quand même, après avoir confirmé que le fichier provenait de l'officiel Jenkins page de téléchargement.
• Fichier initialAdminPassword introuvable : Un répertoire d'installation personnalisé a été sélectionné. Consultez le contenu du répertoire d'installation. secrets dossier de ce répertoire, ou lire le mot de passe depuis jenkins.err.log dans le Jenkins répertoire personnel.

Une fois Jenkins Une fois le système opérationnel, l'étape suivante logique consiste à le connecter à un dépôt de code source et à un pipeline de compilation. Les tutoriels sur Jenkins Intégration GitHub et la Pipeline CI / CD Expliquez comment l'intégration continue est mise en place autour de cette installation.

FAQ