Hoe te downloaden en te installeren Jenkins on Windows

Jenkins kan op beide worden geïnstalleerd Windows of Unix-platformen, maar deze handleiding richt zich op de Windows Alleen installatie. De Windows MSI-installatieprogramma registreert Jenkins een Windows en selecteert een 64-bits service. Java runtime voor u, waardoor dit de snelste route is naar een werkende automatiseringsserver. Controleer voordat u het installatieprogramma opent of uw computer voldoet aan de vereisten die in de volgende sectie worden vermeld.

Jenkins Vereisten en systeemvereisten

Jenkins Het systeem is licht in ruststand, maar groeit snel zodra er buildgeschiedenis, werkruimtes en plug-ins worden toegevoegd. Door de machine vanaf het begin correct te dimensioneren, voorkomt u een moeizame migratie later.

Hardwarevereisten:

Softwarevereisten:

• Jenkins draait op Java, dus een ondersteunde Java Ontwikkelingskit (JDK) of Java De Runtime Environment (JRE) moet aanwezig zijn. Jenkins releases vereisen Java 21 of hoger; Java De versies 8, 11 en 17 worden niet langer ondersteund door de nieuwste Long-Term Support-lijn.
• Een moderne webbrowser is nodig om de website te bereiken. Jenkins dashboard.
• Een account met beheerdersrechten op de Windows een machine is nodig om de registratie te voltooien. Jenkins service te halen.

Bevestig de installatie Java Controleer de versie in de opdrachtprompt voordat u verdergaat. Als de opdracht mislukt of een versie lager dan 21 meldt, installeer dan eerst een ondersteunde JDK.

:: 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)

Releasetypen

Jenkins publiceert twee release-lijnen, en de keuze bepaalt hoe vaak je upgradet.

Deze handleiding maakt gebruik van de LTS-versie, hoewel het installatieproces identiek is voor de wekelijkse versie. Zodra aan de vereisten is voldaan, kan de download beginnen.

Hoe te downloaden Jenkins?

Volg de onderstaande stappen om de te verkrijgen Windows installateur en voltooi een succesvolle installatie:

Stap 1) Ga naar https://www.jenkins.io/download/ en selecteer het platform. In ons geval, Windows.

Stap 2) Ga naar de downloadlocatie op uw computer en pak het gedownloade bestand uit. Double-klik op het uitgepakte bestand jenkins.msi bestand. Jenkins Het is ook mogelijk om het programma vanuit een WAR-bestand (Web Application Archive) uit te voeren, maar die methode wordt niet aanbevolen. Windows omdat het de serviceregistratie overslaat die normaal gesproken door het installatieprogramma wordt afgehandeld.

Let op: Windows SmartScreen kan melden dat het heeft voorkomen dat een onbekende toepassing werd gestart. Selecteer Meer infodan Loop hoe dan ook, om verder te gaan met de ondertekende Jenkins installateur.

Stap 3) In de Jenkins Instelscherm, klik Volgende.

Stap 4) Kies de locatie waar de Jenkins De instantie moet worden geïnstalleerd. De standaardlocatie bij de huidige 64-bits installatieprogramma's is C: \ Program Files \Jenkins. Noteer dit pad, want het initiële beheerderswachtwoord is hierin opgeslagen. Klik Volgende.

Stap 5) Het installatieprogramma vraagt ​​vervolgens om de aanmeldgegevens voor de service en het poortnummer. Geef een specifiek lokaal of domeinaccount op en klik op 'Inloggen'. TestreferentiesStel vervolgens de poort in en klik. Testpoort:. Haven 8080 is de standaardinstelling. Bezig met uitvoeren Jenkins Het gebruik van een serviceaccount met een specifieke naam is veiliger dan de LocalSystem-optie, die toestemming geeft. Jenkins volledige toegang tot de machine.

Stap 6) Bevestig het Java Selecteer de thuismap die het installatieprogramma detecteert, bekijk de opties voor de aangepaste installatie en klik op de Install knop. Zodra de installatie is voltooid, klikt u op Finish.

Stap 7) Tijdens het installatieproces kan er een informatievenster verschijnen met de melding dat een herstart vereist is na afloop van de installatie. Klik op de OK knop wanneer het informatiepaneel verschijnt.

De bestanden staan ​​nu op de schijf en de service is geregistreerd. De volgende stap is het ontgrendelen van de webinterface.

Hoe te deblokkeren? Jenkins?

Na het voltooien van de Jenkins Tijdens de installatie is de controller vergrendeld totdat u een automatisch gegenereerd wachtwoord invoert. De onderstaande stappen leggen uit hoe u de controller kunt ontgrendelen. Jenkins toepassing:

Stap 1) Nadat het installatieproces is voltooid, wordt een browsertabblad geopend waarin om het initiële beheerderswachtwoord wordt gevraagd. Om toegang te krijgen tot JenkinsGa in uw webbrowser naar het volgende pad.
http://localhost:8080

Als het bovenstaande adres laadt, is de installatie geslaagd en draait de service.

Stap 2) Het initiële beheerderswachtwoord wordt opgeslagen onder de Jenkins installatiepad dat u in stap 4 van de installatie hebt ingesteld. Voor de standaardlocatie C: \ Program Files \Jenkinseen bestand genaamd initiëleAdminWachtwoord is te vinden onder C: \ Program Files \Jenkins\geheimenAls er een aangepast pad is geselecteerd, controleer dan die locatie. Dezelfde waarde wordt ook naar de geschreven. jenkins.err.log bestand in de Jenkins thuismap.

Stap 3) Open het gemarkeerde bestand en kopieer de inhoud ervan. initiëleAdminWachtwoord bestand.

Stap 4) Plak het wachtwoord in het veld. Administrator wachtwoord veld op de Ontgrendelen Jenkins open de pagina in uw browser en klik op de Doorgaan knop.

Nadat de controller is ontgrendeld, gaat de installatiewizard verder met de plug-ins en het eerste gebruikersaccount.

Personaliseer Jenkins

U kunt ook uw Jenkins Gebruik de onderstaande stappen om de omgeving te configureren:

Stap 1) Klik op de Installeer voorgestelde plug-ins knop zodat Jenkins Haalt de benodigde plug-ins op en installeert ze.

Jenkins Het downloaden en installeren van alle benodigde plug-ins begint om nieuwe bestanden te maken. Jenkins banen.

Let op: U kunt de optie kiezen Selecteer de plug-ins die u wilt installeren en kies alleen de plug-ins die je wilt. Plug-ins kunnen later worden toegevoegd of verwijderd. Beheren Jenkins > Plug-insDeze keuze is dus niet permanent.

Stap 2) Nadat alle voorgestelde plug-ins zijn geïnstalleerd, Maak de eerste beheerdersgebruiker aan. Er verschijnt een paneel. Vul alle velden in met de gewenste accountgegevens en klik op de knop. Opslaan en voltooien knop.

Stap 3) Jenkins vraagt ​​uiteindelijk om de URL waar de instantie bereikbaar zal zijn. Laat de standaardwaarde staan ​​om latere verwarring te voorkomen. Als een andere applicatie poort 8080 al gebruikt, geef dan hier een andere poort op en klik vervolgens op de knop. Opslaan en doorgaan knop.

Gefeliciteerd! Een nieuwe Jenkins De server is nu geïnstalleerd. Klik op de Start gebruiken Jenkins knop.

De Jenkins De instantie is operationeel en klaar voor uw eerste taak. Een korte Jenkins tutorial voor beginners legt uit hoe je die baan kunt creëren.

Hoe te verifiëren Jenkins Installatie en beheer van de service

Een dashboard dat slechts één keer laadt, is geen bewijs van een succesvolle installatie. Omdat het MSI-installatieprogramma registreert... Jenkins een Windows De service moet een herstart overleven en op verzoek probleemloos opnieuw kunnen worden opgestart. Voer de onderstaande controles direct uit nadat de installatiewizard is afgesloten.

1. Controleer of de service bestaat. Media Win + Rtype services.mscen druk op Enter. Zoek de vermelding met de naam Jenkins en bevestig dat de status luidt Hardlopen en het opstarttype luidt Automatisch.
2. Controleer het gebruikte account. Open de eigenschappen van de Jenkins service en beoordeling Inloggen tab. Een speciaal serviceaccount heeft de voorkeur boven LocalSystem voor alles wat verder gaat dan lokaal experimenteren.
3. Controleer de luisterpoort. lopen netstat -ano | findstr :8080 vanuit de opdrachtprompt. Een LISTENING-vermelding bevestigt dat Jenkins bezit de haven.
4. Lees de versiebanner. Meld u aan bij http://localhost:8080 Lees het versienummer in de rechterbenedenhoek van het dashboard. Vergelijk dit met de versie die je hebt gedownload.
5. Eén keer opnieuw opstarten. Herstart Windows Ga vervolgens opnieuw naar het dashboard zonder handmatig iets te starten. Als de pagina laadt, werkt de service volledig automatisch.

De service kan ook worden beheerd vanuit een opdrachtprompt met beheerdersrechten, wat sneller is dan de grafische console en goed werkt binnen implementatiescripts:

:: 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"

💡Tip: De stille installateur accepteert INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAMEen SERVICE_PASSWORD als eigenschapsoverrides. Alles wat u niet doorgeeft, valt terug op de standaardwaarde, en in de stille modus draait de service als LocalSystem, tenzij een serviceaccount is opgegeven.

Als een van deze controles mislukt, zijn de oorzaken meestal voorspelbaar, zoals in het volgende hoofdstuk wordt aangetoond.

Veelgestelde Jenkins Installatiefouten op Windows en hoe je ze kunt oplossen

De meesten mislukten Windows installaties trace terug naar een kleine reeks oorzaken: een niet-onderbouwde Java Een runtimefout, een bezette poort of een serviceaccount dat niet de juiste rechten heeft om als service in te loggen. Elk van deze problemen veroorzaakt een specifiek symptoom, waardoor de oplossing meestal snel is zodra het bericht zorgvuldig is gelezen.

• Ongeldige aanmeldgegevens voor de service: De installateur wijst het account af tijdens de installatie. Testreferenties stap. Openen secpol.msc, uitbreiden Lokaal beleid > Toewijzing van gebruikersrechten, Open Meld u aan als een serviceVoeg het account toe en probeer vervolgens de inloggegevenstest opnieuw.
• Poort 8080 is al in gebruik: De Testpoort: De knop wordt rood omdat een andere applicatie, vaak een lokale Tomcat of een ontwikkelserver, de poort al bezet houdt. Kies een vrije poort, zoals 8081, of stop het conflicterende proces dat is geïdentificeerd door netstat -ano.
• Niet ondersteund of ontbreekt Java: De installateur kan de gegevens niet vooraf invullen. Java Als de installatie niet in de thuismap van de 64-bits JDK 21 of later plaatsvindt, start de service wel, maar stopt deze direct weer. Installeer vervolgens een 64-bits JDK 21 of later en laat het installatieprogramma de thuismap van de 64-bits JDK gebruiken.
• SmartScreen blokkeert het installatieprogramma: Windows meldt een niet-herkende toepassing. Selecteer Meer infodan Loop hoe dan ookNadat was bevestigd dat het bestand van de officiële instantie afkomstig was, Jenkins downloadpagina.
• Het bestand initialAdminPassword is niet gevonden: Er is een aangepaste installatiemap gekozen. Kijk in de map. secrets map van die directory, of lees het wachtwoord uit jenkins.err.log in de Jenkins thuismap.

Eens Jenkins Als het betrouwbaar werkt, is de logische volgende stap het koppelen aan een broncode-repository en een build-pipeline. De handleidingen op Jenkins GitHub-integratie en CI/CD-pijplijn Leg uit hoe continue integratie rondom deze installatie is opgebouwd.

Veelgestelde vragen