Jenkins installeren op Windows 10 is niet altijd zo eenvoudig als het lijkt. Soms verloopt de installatie soepel, maar weigert Jenkins te starten, of loop je tegen een vreemd authenticatieprobleem aan, of loopt de webinterface gewoon vast. Dat is best vervelend, maar deze problemen zijn meestal eenvoudig op te lossen als je eenmaal weet waar je moet zoeken. Deze handleiding behandelt veelvoorkomende problemen – zoals het oplossen van poortproblemen, controleren of Java correct is geconfigureerd of het oplossen van opstartfouten – want eerlijk gezegd heeft Windows er een handje van om dingen net iets ingewikkelder te maken dan nodig is. Het doel is dat Jenkins soepel draait, zodat je je builds kunt automatiseren zonder je hoofd te breken.
Hoe u veelvoorkomende Jenkins-installatieproblemen in Windows 10 kunt oplossen
Oplossing 1: Zorg ervoor dat Java correct is geïnstalleerd en geconfigureerd
Als Jenkins niet start of de webpagina niet laadt, komt dat vaak doordat Java niet goed is ingesteld. Jenkins draait in principe op Java, dus je moet de JDK geïnstalleerd hebben en de JAVA_HOME-omgevingsvariabele correct hebben ingesteld.
- Controleer of Java is geïnstalleerd: open de opdrachtprompt en typ
java -version. Als u een versienummer ziet, is dat geen probleem. Zo niet, dan moet u de nieuwste JDK installeren via de Oracle Java SE Downloads. - Na de installatie stelt u JAVA_HOME in: ga naar Configuratiescherm > Systeem > Geavanceerde systeeminstellingen > Omgevingsvariabelen. Klik onder Systeemvariabelen op Nieuw en voeg toe:
JAVA_HOME=C:\Program Files\Java\jdk-Vervang indien nodig. Zoek vervolgens de variabele Path en voeg toe
%JAVA_HOME%\bin.
Het is een beetje rommelig, maar het is vrij gebruikelijk om te melden dat Java niet wordt herkend wanneer je omgevingsvariabelen niet kloppen. Door dat te verhelpen, is Jenkins meestal weer aan de praat.
Oplossing 2: Controleer Jenkins-poortconflicten en firewallregels
Als Jenkins goed is geïnstalleerd, maar je geen toegang hebt tot http://localhost:8080, kan het zijn dat de poort geblokkeerd is of al in gebruik is. Windows kan vreemd doen met poorten, vooral als een andere app poort 8080 bezet.
- Open PowerShell als beheerder en kijk welk proces poort 8080 gebruikt:
netstat -aon | findstr :8080 - Als er iets anders op 8080 staat, kun je dat proces beëindigen of Jenkins aanpassen om een andere poort te gebruiken. Zoek hiervoor het Jenkins-configuratiebestand op
C:\Program Files\Jenkins\jenkins.xml. Open het in Kladblok en zoek de regel met -httpPort=8080. Wijzig 8080 in iets anders, bijvoorbeeld 8081. - Start de Jenkins-service opnieuw via het Services-paneel of de opdrachtregel:
sc stop jenkins && sc start jenkins
Soms blokkeert Windows Firewall het accepteren van inkomende verbindingen door Jenkins. Zorg ervoor dat Jenkins door de firewall wordt toegelaten:
- Ga naar Instellingen > Bijwerken en beveiliging > Windows-beveiliging > Firewall- en netwerkbeveiliging > Een app via firewall toestaan.
- Voeg Jenkins toe als het er niet is, of controleer of het is toegestaan op zowel privé- als openbare netwerken. Als je het niet zeker weet, schakel het dan tijdelijk in om te controleren of dat het probleem is.
Oplossing 3: Wis de browsercache of probeer een andere browser
Als Jenkins vastloopt op de startpagina of als inloggen niet werkt, is er soms gewoon een browserprobleem. Wis je cache of probeer Jenkins te openen in een andere browser, zoals Firefox, Chrome of Edge. Zorg er ook voor dat er geen proxy of VPN is die het lokale netwerkverkeer verstoort, want dat kan vreemde toegangsproblemen veroorzaken.
Optie 4: Jenkins als beheerder uitvoeren of opnieuw installeren
Als Jenkins niet wil starten of als u foutmeldingen ziet dat de toestemming is geweigerd, kan het helpen om de service als beheerder uit te voeren. Klik met de rechtermuisknop op Services, zoek Jenkins en selecteer Eigenschappen. Kies op het tabblad Aanmelden de optie Lokaal systeemaccount of vink het vakje Service toestaan te communiceren met bureaublad aan. Soms helpt het om Jenkins opnieuw te installeren met beheerdersrechten om vreemde opstartproblemen op te lossen.
Samenvatting
- Zorg ervoor dat Java correct is geïnstalleerd en dat de omgevingsvariabelen zijn ingesteld.
- Controleer op poortconflicten en wijzig indien nodig de Jenkins-poort.
- Laat Jenkins door de Windows-firewall heen of schakel het tijdelijk uit om te testen.
- Probeer een andere browser of wis de cache als de interface vreemd reageert.
- Als je nog steeds vastloopt, voer Jenkins dan uit als administrator.
Afronding
Eerlijk gezegd kan het oplossen van problemen met Jenkins op Windows 10 een behoorlijke doolhof zijn – poorten, rechten, omgevingsvariabelen, Windows-beveiligingsinstellingen…noem maar op. Maar zodra je die basis onder de knie hebt, werkt het meestal als een trein. Als er iets vreemds gebeurt, zijn het meestal oplossingen die te maken hebben met de omgeving of netwerkinstellingen in plaats van Jenkins zelf. Hopelijk helpt dit om te voorkomen dat iemand zich de haren uit het hoofd trekt. Veel succes en plezier met automatiseren!