Jenkins auf Windows 11 installieren: Eine Schritt-für-Schritt-Anleitung
Hier ist ein ausführliches Tutorial, wie du Jenkins auf Windows 11 installierst.
Jenkins ist eines der populärsten Open-Source-Automatisierungstools für Continuous Integration und Continuous Delivery (CI/CD). In dieser Anleitung lernst du, wie du Jenkins als Windows-Dienst installierst und konfigurierst.
1. Voraussetzungen
Bevor du mit der Installation beginnst, müssen zwei Dinge sichergestellt sein:
- Java JDK ist installiert: Jenkins basiert auf Java. Aktuell werden Java 17 oder Java 21 empfohlen.
- Hardware: Mindestens 1 GB RAM und 10 GB freier Festplattenspeicher.
Java-Version prüfen:
Öffne die Eingabeaufforderung (CMD) und gib folgenden Befehl ein:
java -version
Falls Java nicht installiert ist, lade das JDK 17 (z. B. von Oracle oder Eclipse Temurin) herunter und installiere es.
2. Jenkins herunterladen
- Gehe auf die offizielle Jenkins-Website: jenkins.io/download.
- Suche den Abschnitt Windows.
- Lade die
.msi-Datei für die LTS-Version (Long Term Support) herunter. Diese ist stabiler für den produktiven Einsatz oder zum Lernen.
3. Jenkins Installation
- Mache einen Doppelklick auf die heruntergeladene
.msi-Datei. - Klicke auf Next.
- Destination Folder: Wähle den Installationspfad (Standard:
C:\Program Files\Jenkins) und klicke auf Next. - Service Logon Credentials:
- Wähle "Run service as LocalSystem" (dies ist für lokale Testumgebungen am einfachsten).
- Hinweis: In Firmenumgebungen wird oft ein spezifischer Benutzeraccount verwendet.
- Port Selection:
- Standardmäßig ist Port 8080 eingetragen.
- Klicke auf Test Port, um sicherzustellen, dass er frei ist (ein grüner Haken sollte erscheinen). Klicke dann auf Next.
- Java Home Directory:
- Der Installer versucht, den Pfad zu deinem Java JDK automatisch zu finden (z. B.
C:\Program Files\Eclipse Adoptium\jdk-17...). - Falls das Feld leer ist, wähle den Pfad manuell aus. Klicke auf Next.
- Der Installer versucht, den Pfad zu deinem Java JDK automatisch zu finden (z. B.
- Custom Setup: Klicke einfach auf Next und anschließend auf Install.
- Bestätige die Windows-Sicherheitsabfrage mit "Ja" und klicke am Ende auf Finish.
4. Jenkins entsperren (Initial Setup)
Nach der Installation öffnet sich dein Browser automatisch unter http://localhost:8080. Falls nicht, öffne ihn manuell.
- Du siehst die Seite "Unlock Jenkins".
- Um das Administrator-Passwort zu finden, gehe zu folgendem Pfad auf deiner Festplatte:
C:\ProgramData\Jenkins\.jenkins\secrets\initialAdminPassword(Hinweis: Der Ordner "ProgramData" ist standardmäßig versteckt. Du kannst den Pfad einfach oben in die Adresszeile des Explorers kopieren). - Öffne die Datei mit dem Editor (Notepad), kopiere den Code und füge ihn im Browser ein. Klicke auf Continue.
5. Plugins und Admin-Benutzer
- Plugins installieren: Wähle die Option "Install suggested plugins". Jenkins lädt nun automatisch die wichtigsten Tools (Git, Pipeline, etc.) herunter. Das kann ein paar Minuten dauern.
- Admin User erstellen:
- Gib einen Benutzernamen, ein Passwort und eine E-Mail-Adresse ein.
- Klicke auf Save and Finish.
- Instance Configuration: Hier wird die URL bestätigt (normalerweise
http://localhost:8080). Klicke auf Save and Finish.
6. Abschluss
Klicke auf "Start using Jenkins". Du befindest dich nun auf dem Dashboard und Jenkins ist bereit für deinen ersten Job!
Tipps für Windows-Nutzer:
- Dienst verwalten: Du kannst Jenkins über die Windows-App "Dienste" (services.msc) starten, stoppen oder neu starten (suche nach dem Dienst "Jenkins").
- Firewall: Falls du von einem anderen PC im Netzwerk auf Jenkins zugreifen möchtest, musst du den Port 8080 in der Windows-Firewall freigeben.
Viel Erfolg bei deiner Automatisierung!