Nasıl İndirilir ve Kurulur Jenkins on Windows

Jenkins her ikisine de kurulabilir Windows veya Unix platformları, ancak bu kılavuz özellikle şunlara odaklanmaktadır: Windows Sadece kurulum. Windows MSI yükleyicisi kayıtlarını kaydeder Jenkins bir şekilde Windows hizmeti seçer ve 64 bit olanı tercih eder. Java Bu, size çalışma zamanı sağlar ve çalışan bir otomasyon sunucusuna ulaşmanın en hızlı yolunu sunar. Yükleyiciyi açmadan önce, makinenizin bir sonraki bölümde listelenen gereksinimleri karşıladığından emin olun.

Jenkins Önkoşullar ve Sistem Gereksinimleri

Jenkins Sistem bekleme durumundayken hafiftir ancak derleme geçmişi, çalışma alanları ve eklentiler biriktikçe hızla büyür. Başlangıçta makineyi doğru boyutlandırmak, daha sonra yaşanacak zahmetli geçişlerden kaçınmanızı sağlar.

Donanım gereksinimleri:

Yazılım gereksinimleri:

• Jenkins çalışır Javayani desteklenen Java Geliştirme Kiti (JDK) veya Java Çalışma Ortamı (JRE) mevcut olmalıdır. Mevcut Jenkins Yayınlar gerektirir Java 21 veya daha sonra; Java 8, 11 ve 17 numaralı sürümler en yeni Uzun Süreli Destek hattı kapsamında artık desteklenmemektedir.
• Erişmek için modern bir web tarayıcısına ihtiyaç vardır. Jenkins gösterge panosu.
• Yönetici haklarına sahip bir hesap Windows Kayıt işlemi için makineye ihtiyaç duyulmaktadır. Jenkins hizmet.

Kurulumun tamamlandığını doğrulayın. Java Devam etmeden önce Komut İstemi'nden JDK sürümünü kontrol edin. Komut başarısız olursa veya 21'in altında bir sürüm bildirirse, önce desteklenen bir JDK yükleyin.

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

Yayın türleri

Jenkins İki sürüm yayınlar ve bu seçim, ne sıklıkla güncelleme yapacağınızı etkiler.

Bu kılavuzda LTS sürümü kullanılmaktadır, ancak kurulum süreci haftalık sürüm için de aynıdır. Ön koşullar yerine getirildikten sonra indirme işlemi başlayabilir.

Nasıl indirilir Jenkins?

Aşağıdaki adımları izleyerek elde edebilirsiniz. Windows Kurulum programını çalıştırın ve başarılı bir kurulumu tamamlayın:

) 1 Adım MyCAD'de yazılım Güncelleme ye git https://www.jenkins.io/download/ ve platformu seçin. Bizim durumumuzda, Windows.

) 2 Adım Yerel bilgisayarınızdaki indirme konumuna gidin ve indirilen paketi sıkıştırılmış dosyadan çıkarın. Double-açılan dosyaya tıklayın jenkins.msi dosyası. Jenkins Ayrıca bir WAR (Web uygulaması arşivi) dosyasından da çalıştırılabilir, ancak bu yöntem önerilmez. Windows Çünkü bu, yükleyici tarafından gerçekleştirilen hizmet kaydını atlar.

Not: Windows SmartScreen, tanınmayan bir uygulamanın başlatılmasını engellediğini bildirebilir. Seçiniz Daha fazla bilgi, Daha sonra Yine de koşimzalananlarla devam etmek için Jenkins yükleyici.

) 3 Adım içinde Jenkins Kurulum ekranına tıklayın. Sonraki.

) 4 Adım Konumu seçin Jenkins Örnek yüklenmelidir. Mevcut 64 bit yükleyicilerdeki varsayılan konum şudur: C: \ Program Files \JenkinsBu yolu not edin, çünkü ilk yönetici şifresi burada saklanmaktadır. Tıklayın. Sonraki.

) 5 Adım Kurulum programı daha sonra servis oturum açma kimlik bilgilerini ve bağlantı noktası numarasını isteyecektir. Özel bir yerel veya etki alanı hesabı girin ve tıklayın. Test Kimlik BilgileriArdından bağlantı noktasını ayarlayın ve tıklayın. Test Portu. Liman 8080 Varsayılan değerdir. Çalıştırma Jenkins Adlandırılmış bir hizmet hesabı altında olmak, LocalSystem seçeneğine göre daha güvenlidir; LocalSystem seçeneği ise daha fazla güvenlik sağlar. Jenkins Makineye tam erişim.

) 6 Adım Onaylayın Java Kurulum programının algıladığı ana dizini seçin, özel kurulum seçeneklerini inceleyin ve tıklayın. kurmak Düğme. Kurulum tamamlandıktan sonra tıklayın. Bitiş.

) 7 Adım Kurulum işlemi sırasında, mevcut kurulumun sonunda yeniden başlatmanın gerekli olduğunu bildiren bir bilgi paneli görünebilir. [Reboot] düğmesine tıklayın. OK Bilgi paneli göründüğünde düğmeye basın.

Dosyalar artık diskte ve servis kaydedildi. Bir sonraki aşama web arayüzünün kilidini açıyor.

Engelleme Nasıl Kaldırılır Jenkins?

Tamamladıktan sonra Jenkins Kurulum aşamasında, otomatik olarak oluşturulan bir parola girene kadar kontrol cihazı kilitli kalır. Aşağıdaki adımlar, kilidi nasıl açacağınızı açıklamaktadır. Jenkins Uygulama:

) 1 Adım Kurulum işlemi tamamlandıktan sonra, bir tarayıcı sekmesi açılır ve ilk yönetici parolasını ister. Erişmek için JenkinsLütfen web tarayıcınızda aşağıdaki yola gidin.
http://localhost:8080

Yukarıdaki adres yüklenirse, kurulum başarılı olmuş ve servis çalışıyor demektir.

) 2 Adım İlk yönetici parolası şu konumda saklanır: Jenkins Kurulumun 4. adımında belirlediğiniz kurulum yolu. Varsayılan konum için C: \ Program Files \Jenkinsadlı bir dosya ilkYöneticiŞifresi altında bulunur C: \ Program Files \JenkinssırlarÖzel bir yol seçildiyse, bunun yerine o konumu kontrol edin. Aynı değer ayrıca şuraya da yazılır: jenkins.err.log içindeki dosyayı Jenkins ev dizini.

) 3 Adım Seçilen dosyayı açın ve içeriğini kopyalayın. ilkYöneticiŞifresi dosyası.

) 4 Adım Şifreyi buraya yapıştırın. Yönetici şifresi Kilidi açma alanındaki Jenkins Tarayıcınızda sayfayı açın ve tıklayın. Devam et düğmesine basın.

Kontrol cihazının kilidi açıldıktan sonra, kurulum sihirbazı eklentilere ve ilk kullanıcı hesabına geçer.

özelleştir Jenkins

Ayrıca kişiselleştirebilirsiniz Jenkins Aşağıda verilen adımları kullanarak bir ortam oluşturabilirsiniz:

) 1 Adım Tıkla Önerilen eklentileri yükleyin düğme böylece Jenkins Gerekli eklentileri indirir ve kurar.

Jenkins Yeni bir uygulama oluşturmak için gereken tüm eklentileri indirmeye ve yüklemeye başlar. Jenkins Meslekler.

Not: Seçeneği seçebilirsiniz. Yüklenecek eklentileri seçin ve yalnızca istediğiniz eklentileri seçin. Eklentiler daha sonra eklenebilir veya kaldırılabilir. Yönet Jenkins > EklentilerDolayısıyla bu tercih kalıcı değil.

) 2 Adım Önerilen tüm eklentiler yüklendikten sonra, İlk Yönetici Kullanıcısını Oluştur Panel görünecektir. Tüm alanları istediğiniz hesap bilgileriyle doldurun ve tıklayın. Kaydet ve Bitir düğmesine basın.

) 3 Adım Jenkins sonunda şunu soruyor URL Örneğin erişileceği yer. Daha sonra karışıklığı önlemek için varsayılan değeri bırakın. Başka bir uygulama zaten 8080 portunu kullanıyorsa, buraya farklı bir port girin ve ardından tıklayın. Kaydet ve Devam Et düğmesine basın.

Tebrikler! Yeni bir Jenkins Sunucu artık kuruldu. Tıklayın. Kullanmaya başla Jenkins düğmesine basın.

MKS Jenkins Örnek çalışmaya başladı, ilk işiniz için hazır. Kısa bir süre sonra... Jenkins yeni başlayanlar için eğitim Bu işin nasıl oluşturulacağını açıklıyor.

Doğrulama Nasıl Yapılır? Jenkins Hizmetin Kurulumu ve Yönetimi

Bir kez yüklenen bir kontrol paneli, sağlıklı bir kurulumun kanıtı değildir. Çünkü MSI yükleyicisi kayıt işlemini gerçekleştirir. Jenkins bir şekilde Windows Servis, yeniden başlatma işleminden sonra da çalışmaya devam etmeli ve talep üzerine sorunsuz bir şekilde yeniden başlatılmalıdır. Kurulum sihirbazı kapandıktan hemen sonra aşağıdaki kontrolleri gerçekleştirin.

1. Hizmetin varlığını doğrulayın. Basın Win + Ryazın services.mscve Enter tuşuna basın. "..." adlı girişi bulun. Jenkins ve durumun şu şekilde olduğunu onaylayın: Koşu ve başlangıç ​​türü şöyledir: Otomatik.
2. Kullanılan hesabı kontrol edin. özelliklerini aç Jenkins hizmet ve değerlendirme Açık Oturum Sekme. Yerel denemelerin ötesindeki her şey için LocalSystem yerine özel bir hizmet hesabı tercih edilir.
3. Dinleme portunu doğrulayın. koşmak netstat -ano | findstr :8080 Komut İstemi'nden. Bir LISTENING girdisi şunu doğrular: Jenkins Limanı elinde tutuyor.
4. Sürüm başlığını okuyun. Şurada oturum açın: http://localhost:8080 Kontrol panelinin sağ alt köşesindeki sürüm numarasını okuyun. İndirdiğiniz sürümle karşılaştırın.
5. Bir kez yeniden başlatın. Yeniden Windows ve hiçbir şeyi manuel olarak başlatmadan tekrar kontrol paneline göz atın. Sayfa yüklenirse, hizmet gerçekten otomatiktir.

Bu hizmet, grafiksel konsoldan daha hızlı olan ve dağıtım komut dosyaları içinde iyi çalışan, yönetici ayrıcalıklarıyla açılmış bir Komut İstemi penceresinden de kontrol edilebilir:

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

💡 İpucu: Sessiz kurulum cihazı kabul eder INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME, ve SERVICE_PASSWORD Özellik geçersiz kılmaları olarak. Geçirmediğiniz her şey varsayılan değerine geri döner ve sessiz modda, bir hizmet hesabı sağlanmadığı sürece hizmet LocalSystem olarak çalışır.

Bu kontrollerden herhangi birinin başarısız olması durumunda, nedenleri genellikle tahmin edilebilir, bu da bir sonraki bölümde gösterilecektir.

ortak Jenkins Kurulum Hataları Windows ve Bunları Nasıl Düzeltebilirsiniz

En başarısız olanlar Windows montaj tracAz sayıda nedene geri dönelim: desteklenmeyen bir durum Java Çalışma zamanı, meşgul bir port veya hizmet olarak oturum açma hakkına sahip olmayan bir hizmet hesabı gibi durumlar sorun yaratabilir. Her biri farklı bir belirti gösterir, bu nedenle mesaj dikkatlice okunduktan sonra çözüm genellikle hızlıdır.

• Geçersiz hizmet oturum açma kimlik bilgileri: Kurulum programı işlem sırasında hesabı reddediyor. Test Kimlik Bilgileri adım. Aç secpol.mscgenişletin Yerel Politikalar > Kullanıcı Hakları Atamasıaçık Hizmet olarak oturum açınHesabı ekleyin ve ardından kimlik doğrulama testini tekrar deneyin.
• 8080 numaralı bağlantı noktası zaten kullanımda: MKS Test Portu Düğme kırmızıya döner çünkü başka bir uygulama, genellikle yerel bir Tomcat veya geliştirme sunucusu, zaten bu bağlantı noktasını kullanmaktadır. 8081 gibi boş bir bağlantı noktası seçin veya çakışan işlemi durdurun. netstat -ano.
• Desteklenmiyor veya eksik Java: Kurulum programı önceden dolduramaz. Java Ana dizine yönlendirmeyin, aksi takdirde servis başlar ve hemen durur. 64 bit JDK 21 veya daha yeni bir sürümünü kurun, ardından yükleyiciyi ana dizinine yönlendirin.
• SmartScreen, yükleyiciyi engelliyor: Windows Tanınmayan bir uygulama bildiriyor. Seçin Daha fazla bilgi, Daha sonra Yine de koşDosyanın resmi kaynaktan geldiğini doğruladıktan sonra Jenkins indirme sayfası.
• initialAdminPassword dosyası bulunamadı: Özel bir kurulum dizini seçildi. İçerisine bakın. secrets o dizinin klasöründen şifreyi okuyun veya şifreyi oradan okuyun. jenkins.err.log içinde Jenkins ev dizini.

bir Zamanlar Jenkins Sistem güvenilir bir şekilde çalışıyorsa, bir sonraki doğal adım onu ​​bir kaynak deposuna ve bir derleme hattına bağlamaktır. Bu konuda adım adım kılavuzlar mevcuttur. Jenkins GitHub entegrasyonu ve CI/CD ardışık düzeni Bu kurulum etrafında sürekli entegrasyonun nasıl oluşturulduğunu açıklayın.

SSS