Jak pobrać i zainstalować Jenkins on Windows

Jenkins może być zainstalowany na obu Windows lub platform Unix, ale ten przewodnik skupia się na Windows tylko instalacja. Windows Rejestry instalatora MSI Jenkins jak Windows usługa i wybiera 64-bitową Java środowiska wykonawczego, co czyni go najszybszą drogą do działającego serwera automatyzacji. Przed otwarciem instalatora upewnij się, że Twój komputer spełnia wymagania wymienione w następnej sekcji.

Jenkins Wymagania wstępne i systemowe

Jenkins Jest lekki w stanie spoczynku, ale szybko rośnie wraz z gromadzeniem historii kompilacji, obszarów roboczych i wtyczek. Prawidłowe określenie rozmiaru maszyny na początku pozwala uniknąć późniejszej, bolesnej migracji.

Wymagania sprzętowe:

Wymagania programowe:

• Jenkins biegnie dalej Java, więc wspierane Java Zestaw deweloperski (JDK) lub Java Środowisko wykonawcze (JRE) musi być obecne. Aktualne Jenkins wydania wymagają Java 21 lub nowszy; Java Wersje 8, 11 i 17 nie są już objęte najnowszą linią wsparcia długoterminowego.
• Aby dotrzeć do serwisu potrzebna jest nowoczesna przeglądarka internetowa Jenkins deska rozdzielcza.
• Konto z uprawnieniami administracyjnymi na Windows do zarejestrowania potrzebna jest maszyna Jenkins service.

Potwierdź zainstalowanie Java Przed kontynuowaniem sprawdź wersję z wiersza poleceń. Jeśli polecenie się nie powiedzie lub zgłosi wersję starszą niż 21, najpierw zainstaluj obsługiwany pakiet 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)

Typy wydań

Jenkins publikuje dwie linie wydań, a wybór ten wpływa na częstotliwość przeprowadzania aktualizacji.

W tym poradniku wykorzystano wersję LTS, chociaż proces instalacji jest identyczny jak w przypadku wersji cotygodniowej. Po spełnieniu wymagań wstępnych można rozpocząć pobieranie.

Jak pobrać Jenkins?

Aby uzyskać dostęp, wykonaj poniższe kroki. Windows instalator i pomyślne zakończenie instalacji:

Krok 1) Iść do https://www.jenkins.io/download/ i wybierz platformę. W naszym przypadku, Windows.

Krok 2) Przejdź do folderu pobierania na swoim komputerze lokalnym i rozpakuj pobrany pakiet. Double-kliknij rozpakowany jenkins.msi plik. Jenkins można również uruchomić z pliku WAR (Archive aplikacji internetowej), ale ta ścieżka nie jest zalecana Windows ponieważ pomija rejestrację usługi obsługiwaną przez instalatora.

Uwaga: Windows SmartScreen może zgłosić, że uniemożliwił uruchomienie nierozpoznanej aplikacji. Wybierz Więcej informacji, następnie Uruchom mimo to, aby kontynuować podpisanie Jenkins instalator.

Krok 3) W Jenkins Ekran konfiguracji, kliknij Następna.

Krok 4) Wybierz lokalizację, w której Jenkins instancja powinna zostać zainstalowana. Domyślna lokalizacja w obecnych instalatorach 64-bitowych to C: \ Program Files \Jenkins. Zanotuj tę ścieżkę, ponieważ jest w niej zapisane początkowe hasło administratora. Kliknij Następna.

Krok 5) Instalator poprosi następnie o dane logowania do usługi i numer portu. Podaj dedykowane konto lokalne lub domenowe i kliknij Poświadczenia testowe, następnie ustaw port i kliknij Port testowy. Port 8080 jest domyślny. Działa Jenkins w ramach nazwanego konta usługi jest bezpieczniejsze niż opcja LocalSystem, która przyznaje Jenkins pełny dostęp do maszyny.

Krok 6) Potwierdź Java katalog domowy wykryty przez instalator, przejrzyj opcje instalacji niestandardowej i kliknij Zainstalować przycisk. Po zakończeniu instalacji kliknij Zakończyć.

Krok 7) Podczas procesu instalacji może pojawić się panel informacyjny informujący o konieczności ponownego uruchomienia komputera po zakończeniu bieżącej instalacji. Kliknij OK przycisk, gdy pojawi się panel informacyjny.

Pliki są już na dysku, a usługa zarejestrowana. Następny etap odblokowuje interfejs sieciowy.

Jak odblokować Jenkins?

Po zakończeniu Jenkins W fazie instalacji kontroler jest zablokowany do momentu podania automatycznie wygenerowanego hasła. Poniższe kroki wyjaśniają, jak odblokować Jenkins Aplikacja:

Krok 1) Po zakończeniu procesu instalacji otworzy się karta przeglądarki i pojawi się prośba o podanie początkowego hasła administratora. Aby uzyskać dostęp Jenkins, przejdź do następującej ścieżki w swojej przeglądarce internetowej.
http://localhost:8080

Jeżeli powyższy adres zostanie załadowany, instalacja przebiegła pomyślnie i usługa działa.

Krok 2) Początkowe hasło administratora jest przechowywane pod Jenkins ścieżka instalacji ustawiona w kroku 4 instalacji. W przypadku domyślnej lokalizacji C: \ Program Files \Jenkins, plik o nazwie początkowe hasło administratora znajduje się pod C: \ Program Files \Jenkins\tajnikiJeśli wybrano ścieżkę niestandardową, należy sprawdzić tę lokalizację. Ta sama wartość jest również zapisywana w jenkins.err.log Plik w Jenkins katalog domowy.

Krok 3) Otwórz zaznaczony plik i skopiuj jego zawartość początkowe hasło administratora plik.

Krok 4) Wklej hasło do Hasło administratora pole na odblokowaniu Jenkins stronę w przeglądarce i kliknij KONTUNUUJ przycisk.

Po odblokowaniu kontrolera kreator konfiguracji przechodzi do wtyczek i pierwszego konta użytkownika.

Dostosuj Jenkins

Możesz także dostosować swój Jenkins środowisko, korzystając z poniższych kroków:

Krok 1) Kliknij ikonę Zainstaluj sugerowane wtyczki przycisk, aby Jenkins pobiera i instaluje niezbędne wtyczki.

Jenkins rozpoczyna pobieranie i instalację wszystkich wtyczek potrzebnych do tworzenia nowych Jenkins Oferty pracy.

Uwaga: Możesz wybrać opcję Wybierz wtyczki do zainstalowania i wybierz tylko te wtyczki, które chcesz. Wtyczki można dodać lub usunąć później. zarządzanie Jenkins > Wtyczki, więc ten wybór nie jest trwały.

Krok 2) Po zainstalowaniu wszystkich sugerowanych wtyczek Utwórz pierwszego użytkownika administratora Pojawi się panel. Wypełnij wszystkie pola żądanymi danymi konta i kliknij Zapisz i zakończ przycisk.

Krok 3) Jenkins w końcu prosi o URL gdzie zostanie osiągnięta instancja. Pozostaw wartość domyślną, aby uniknąć pomyłek w przyszłości. Jeśli inna aplikacja już korzysta z portu 8080, wprowadź tutaj inny port, a następnie kliknij Zapisz i kontynuuj przycisk.

Gratulacje! Nowy Jenkins Serwer jest teraz zainstalowany. Kliknij Zacząć używać Jenkins przycisk.

Jenkins instancja jest uruchomiona i gotowa do pierwszego zadania. Krótki Jenkins poradnik dla początkujących wyjaśnia jak utworzyć to zadanie.

Jak zweryfikować Jenkins Instalacja i zarządzanie usługą

Jednokrotne załadowanie pulpitu nawigacyjnego nie jest dowodem na prawidłową instalację. Ponieważ instalator MSI rejestruje Jenkins jak Windows Usługa musi przetrwać ponowne uruchomienie i bezproblemowo uruchomić się ponownie na żądanie. Wykonaj poniższe kontrole natychmiast po zamknięciu kreatora konfiguracji.

1. Sprawdź, czy usługa istnieje. Naciśnij przycisk Win + Rtyp services.msci naciśnij Enter. Znajdź wpis o nazwie Jenkins i potwierdź, że status jest taki Bieganie a typ uruchomienia brzmi automatycznie.
2. Sprawdź używane konto. Otwórz właściwości Jenkins serwis i przegląd Logowanie się Karta. W przypadku wszystkiego, co wykracza poza eksperymenty lokalne, preferowane jest dedykowane konto usługi zamiast konta LocalSystem.
3. Sprawdź port nasłuchujący. Uruchom netstat -ano | findstr :8080 z wiersza poleceń. Wpis LISTENING potwierdza, że Jenkins trzyma port.
4. Przeczytaj wersję banerową. Zaloguj się na http://localhost:8080 i odczytaj numer wersji w prawym dolnym rogu pulpitu. Porównaj go z pobraną wersją.
5. Zrestartuj raz. restart Windows i ponownie przejdź do pulpitu nawigacyjnego bez konieczności ręcznego uruchamiania. Jeśli strona się załaduje, usługa będzie działać całkowicie automatycznie.

Usługą można sterować również z poziomu rozbudowanego wiersza poleceń, który jest szybszy od konsoli graficznej i dobrze sprawdza się w skryptach wdrażania:

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

💡 Wskazówka: Cichy instalator akceptuje INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME, SERVICE_PASSWORD jako nadpisanie właściwości. Wszystko, czego nie przekażesz, wraca do wartości domyślnej, a w trybie cichym usługa działa jako LocalSystem, chyba że zostanie podane konto usługi.

Jeśli którakolwiek z tych kontroli się nie powiedzie, przyczyny są zwykle łatwe do przewidzenia, co zostanie pokazane w następnej sekcji.

wspólny Jenkins Błędy instalacji na Windows i jak je naprawić

Większość nie powiodła się Windows instalacji tracwracamy do małego zestawu przyczyn: nieuzasadnionego Java środowisko wykonawcze, zajęty port lub konto usługi, które nie ma uprawnień do logowania się jako usługa. Każdy z nich powoduje inny objaw, więc rozwiązanie jest zazwyczaj szybkie po uważnym przeczytaniu komunikatu.

• Nieprawidłowe dane logowania do usługi: Instalator odrzuca konto podczas Poświadczenia testowe krok. Otwórz secpol.msc, rozwiń Zasady lokalne > Przypisywanie praw użytkownika, otwarty Zaloguj się jako usługai dodaj konto. Następnie spróbuj ponownie przeprowadzić test uwierzytelniania.
• Port 8080 jest już w użyciu: Port testowy Przycisk zmienia kolor na czerwony, ponieważ inna aplikacja, często lokalny Tomcat lub serwer programistyczny, już posiada ten port. Wybierz wolny port, taki jak 8081, lub zatrzymaj proces powodujący konflikt zidentyfikowany przez netstat -ano.
• Nieobsługiwane lub brakujące Java: Instalator nie może wstępnie wypełnić Java katalog domowy lub usługa uruchomi się i natychmiast zatrzyma. Zainstaluj 64-bitowy JDK 21 lub nowszy, a następnie wskaż instalatorowi jego katalog domowy.
• SmartScreen blokuje instalator: Windows zgłasza nierozpoznaną aplikację. Wybierz Więcej informacji, następnie Uruchom mimo topo potwierdzeniu, że plik pochodzi od urzędnika Jenkins strona pobierania.
• Nie znaleziono pliku initialAdminPassword: Wybrano niestandardowy katalog instalacyjny. Zajrzyj do środka secrets folder tego katalogu lub odczytaj hasło z jenkins.err.log Jenkins katalog domowy.

Pewnego razu Jenkins działa niezawodnie, naturalnym kolejnym krokiem jest połączenie go z repozytorium źródłowym i procesem kompilacji. Przewodniki po Jenkins Integracja z GitHub i Potok CI/CD Wyjaśnij, w jaki sposób integracja ciągła jest realizowana w tej instalacji.

FAQ