Jenkins installeren op Windows 10 lijkt in eerste instantie misschien eenvoudig, maar er zijn een paar eigenaardigheden die je in de weg kunnen zitten. Als Jenkins niet goed opstart of je vreemde Java-problemen tegenkomt, ligt dat vaak aan de Java-installatie of -machtigingen. Het is niet ongebruikelijk dat Jenkins niet ontgrendeld wordt vanwege ontbrekende of verkeerd geconfigureerde Java. Of misschien werkt de service niet omdat Windows Firewall poort 8080 blokkeert. Deze handleiding behandelt daarom enkele praktische problemen, met name rondom Java en de installatie, om Jenkins optimaal te laten werken.
Jenkins installeren in Windows 10
Jenkins soepel laten werken op Windows 10 is meer dan alleen downloaden en op ‘Volgende’ klikken. Je hebt te maken met omgevingsvariabelen, poorten, gebruikersrechten en soms conflicterende beveiligingsinstellingen. Zodra het werkt, kun je builds, tests en implementaties automatiseren en je leven makkelijker maken – als je de problemen met de eerste installatie kunt overwinnen. De truc is om ervoor te zorgen dat Java correct is geconfigureerd en Jenkins de juiste rechten en instellingen heeft. Deze handleiding helpt je bij het oplossen van veelvoorkomende valkuilen en zorgt ervoor dat Jenkins zonder al te veel gedoe werkt.
Zorg ervoor dat Java correct is geïnstalleerd en geconfigureerd
Deze eerste stap is nogal cruciaal. Jenkins heeft Java nodig, maar Windows werkt niet altijd even goed met omgevingsvariabelen. Controleer of Java is geïnstalleerd door de opdrachtprompt te openen en te typen java -version. Als er een foutmelding verschijnt, moet u Java installeren. U kunt de nieuwste OpenJDK downloaden van Adoptium of de JDK van Oracle, als u dat liever hebt. Zorg er na de installatie voor dat de omgevingsvariabele JAVA_HOMEC:\Program Files\Eclipse Adoptium\jdk-17.0.3+7 naar uw JDK-map verwijst, bijvoorbeeld. Dit doet u meestal via Configuratiescherm > Systeem > Geavanceerde systeeminstellingen > Omgevingsvariabelen. Sla deze stap niet over; Jenkins kan Java gewoon niet vinden als dit niet correct is ingesteld.
Pro tip: Soms moet je na de installatie van Java je pc of in ieder geval je opdrachtprompt opnieuw opstarten om de wijzigingen te behouden. Controleer ook of java -version de verwachte informatie uit elk opdrachtpromptvenster retourneert voordat je Jenkins opstart.
Download Jenkins met een korte waarschuwing over het installatieprogramma
Ga naar de officiële downloadpagina van Jenkins en download het nieuwste Windows-installatieprogramma ( .msi).Bij sommige installaties kan het installatieprogramma beveiligingswaarschuwingen geven, afhankelijk van uw antivirusprogramma of Windows Defender. Dit is een waarschuwing. Het is meestal veilig om uit te voeren, maar controleer of u de bron vertrouwt. Dubbelklik op dit bestand om de installatie te starten.
Voer het installatieprogramma uit en regel de machtigingen
Dubbelklik op dat .msibestand en volg de aanwijzingen. Windows vraagt mogelijk om beheerdersrechten – ja, die wilt u hebben. Soms blokkeert Windows de standaard installatiemap ( C:\Program Files ) en dat veroorzaakt problemen met het opstarten van Jenkins of het openen van bestanden. Als dat gebeurt, kunt u overwegen om Jenkins ergens anders te installeren, zoals C:\Jenkins, om problemen met rechten te omzeilen. Nadat u de installatiewizard hebt doorlopen, start u uw pc opnieuw op als daarom wordt gevraagd, omdat Windows na installaties soms een vernieuwing nodig heeft om nieuwe services en omgevingsvariabelen te registreren.
Jenkins-service configureren en netwerkinstellingen controleren
Na de installatie draait Jenkins als een Windows-service, dus controleer of deze daadwerkelijk draait. Klik op Services (zoek naar “Services” in het startmenu), zoek naar Jenkins en kijk of deze draait. Soms start de service niet meteen; probeer hem handmatig opnieuw te starten. Als Jenkins weigert te laden in uw browser op http://localhost:8080, kan dit komen doordat iets anders poort 8080 bezet, of doordat uw Windows Firewall de service blokkeert. In dat geval:
- Open Windows Defender Firewall in Instellingen
- Ga naar Geavanceerde instellingen
- Controleer de inkomende regels voor regels die poort 8080 toestaan of maak een nieuwe regel om deze te openen
Nog iets om te proberen: als de Jenkins-pagina leeg is of als de verbinding wordt geweigerd, start dan PowerShell als beheerder en controleer netstat -aon | findstr 8080of poort 8080 actief is. Zo niet, dan gebruikt een ander proces deze mogelijk, of start Jenkins niet goed op.
Ontgrendel Jenkins en voltooi de installatie
Na de installatie vraagt Jenkins om een initieel beheerderswachtwoord, dat meestal in een bestand wordt weergegeven C:\Program Files (x86)\Jenkins\secrets\initialAdminPassword. Dit pad kan soms variëren als u ergens anders hebt geïnstalleerd, dus controleer uw installatiemap. Open dat bestand met Kladblok, kopieer het wachtwoord en plak het in het ontgrendelscherm van Jenkins. Als Jenkins niet start of het wachtwoord niet werkt, kan het herstarten van de Jenkins-service of uw computer soms vreemde vastlopers verhelpen.
Voor een nog soepelere installatie kunt u overwegen Jenkins als beheerder uit te voeren of de machtigingen aan te passen als u toegangsfouten tegenkomt.
Installeer plug-ins en beveilig uw installatie
De installatiewizard vraagt je om voorgestelde plug-ins te installeren – dit is een goed startpunt. Ze voegen de functionaliteiten toe die je voor de meeste projecten nodig hebt. Mogelijk wil je later nog meer plug-ins installeren, met name voor je specifieke buildtools, broncodebeheer of implementatiemethoden. Houd er rekening mee dat plug-ins soms conflicten kunnen veroorzaken of Jenkins trager kunnen maken als je het overdrijft, dus kies wat je nodig hebt.
Tips voor het installeren van Jenkins in Windows 10
- Voer het installatieprogramma uit met beheerdersrechten. Daarmee is geen sprake van valsspelen.
- Wees voorzichtig met conflicterende software of poortconflicten: netstat is uw vriend.
- Als Jenkins niet toegankelijk is of niet start, controleer dan eerst uw firewall en poortinstellingen.
- Houd je Java-runtime en Jenkins zelf up-to-date. Verouderde Java-versies veroorzaken soms willekeurige fouten.
- Maak regelmatig een back-up van uw Jenkins-configuraties, vooral als u veel gaat aanpassen.
Veelgestelde vragen
Heeft Jenkins Java nodig?
Ja, Jenkins heeft Java nodig. Zorg ervoor dat Java niet alleen geïnstalleerd is, maar ook correct is ingesteld in je omgevingsvariabelen.
Hoe kan ik Jenkins updaten na de installatie?
Jenkins geeft je meestal een melding wanneer er updates beschikbaar zijn in het dashboard. Je kunt de nieuwe updates ook handmatig downloaden .msivan de Jenkins-website en het upgrade-installatieprogramma uitvoeren. Onthoud wel dat het het beste is om eerst een back-up van je configuraties te maken, want Windows moet het upgraden natuurlijk iets ingewikkelder maken dan alleen op ‘Bijwerken’ klikken.
Kan Jenkins op andere besturingssystemen draaien?
Zeker, maar deze handleiding richt zich op Windows. Jenkins kan draaien op Linux, macOS, enz., maar het installatieproces varieert enigszins, vooral wat betreft servicebeheer en afhankelijkheden.
Waar wordt Jenkins eigenlijk voor gebruikt?
Automatiseer builds, tests en implementaties – vrijwel alles in je CI/CD-pijplijn. Het is een manier om je code te testen en te implementeren zonder al het handmatige werk.
Is Jenkins gratis?
Ja, volledig open source. Geen verborgen kosten, gewoon downloaden en gebruiken.
Afronding
Jenkins op Windows 10 laten werken vereist een paar stappen die niet altijd voor de hand liggen, zoals het instellen van omgevingsvariabelen, het beheren van machtigingen en het gebruik van poorten. Maar zodra het is ingesteld, is het een krachtige tool voor het automatiseren van je workflows. De belangrijkste obstakels zijn meestal de Java-installatie en problemen met de firewall, die met wat gepruts in de opdrachtregel kunnen worden opgelost.
Hopelijk scheelt dit iemand wat tijd met het oplossen van problemen. Houd je Java- en poortinstellingen in de gaten en vergeet niet om die eerste wachtwoordcontrole in de map ‘geheimen’ uit te voeren. Zodra Jenkins is ingesteld, is het een fluitje van een cent voor automatiseringsprojecten.