Yeni bir inşaat işi nasıl oluşturulur? Jenkins Serbest Stil Projesi
Editoryal Takım
⚡ Akıllı Özet
Jenkins Freestyle Projesi, kaynak kod indirme, derleme adımları ve derleme sonrası işlemleri tek bir yapılandırılabilir görevde bir araya getiren, tamamen Freestyle aracılığıyla oluşturulan tekrarlanabilir bir derleme işidir. Jenkins Pipeline kodu yazmaya gerek kalmadan web arayüzü.
Nedir Jenkins Serbest Stil Projesi mi?
Jenkins Serbest Stil Projesi Tekrarlanabilir bir derleme işi, komut dosyası veya işlem hattıdır ve adımlar ile derleme sonrası eylemler içerir. Birden fazla işlemi kapsayabilen geliştirilmiş bir iş veya görevdir. Derleme tetikleyicilerini yapılandırmanıza olanak tanır ve proje tabanlı güvenlik sunar. Jenkins Proje. Ayrıca, derleme adımları ve derleme sonrası işlemler oluşturmanıza yardımcı olacak eklentiler de sunmaktadır.
Bir oyunda gerçekleştirebileceğiniz eylem türleri Jenkins Derleme adımı veya derleme sonrası işlem seçenekleri oldukça sınırlıdır. Birçok standart eklenti mevcuttur. Jenkins Bu sorunun üstesinden gelmenize yardımcı olacak Freestyle Projesi.
Aşağıdaki diyagram, serbest stil işini daha geniş bir çerçeve içine yerleştiriyor. sürekli entegrasyon Kaynak kodun indirilmesinden, sonucun raporlandığı derleme sonrası işlemlere kadar uzanan bir döngü.
Oluşturmanın Ön Koşulları Jenkins Serbest Stil İşi
Aşağıdaki on adımın baştan sona sorunsuz bir şekilde işlemesi için dört şeyin yerine getirilmesi gerekiyor. Bunlardan herhangi birinin eksik olması, ilk serbest stil denemesinin mavi top yerine kırmızı topla başarısız olmasının en yaygın nedenidir.
- Bir koşu Jenkins denetleyicisi. Jenkins Varsayılan olarak 8080 numaralı bağlantı noktasından dinleme yapar. Jenkins Henüz çalışmıyor, takip edin. kurulum adım adım kılavuzu İlk.
- Derleme işlemini çalıştıran makinede bir JDK kurulu olmalıdır. Örnek kod derleniyor. Java, yani
javacBu dosya, işi yürüten denetleyici veya aracının PATH'inde bulunmalıdır. Bunu tek satırlık bir komutla doğrulayın.java -versionBaşka bir şey eklemeden önce derleme adımını uygulayın. - Git eklentisi. MKS Git Bu seçenek yalnızca Kaynak altında görünür. Code Eklenti yüklendikten sonra yönetim, şu yollarla sağlanır: Yönet Jenkins > Eklentiler.
- Erişilebilir bir depo. Herkese açık bir HTTPS URL Kimlik bilgisine gerek yoktur. Özel bir depoda saklanan bir kimlik bilgisine ihtiyaç vardır. Jenkins Öncelikle, aksi takdirde ilk kurulum sırasında ödeme işlemi başarısız olur.
Bir hesap İş/Oluştur Yeni bir tek kullanıcılı kurulumda da izin gereklidir. Jenkins Yönetici hesabında zaten bu özellik mevcut.
Yeni bir inşaat işi nasıl oluşturulur? Jenkins
Serbest stilde yapım işi son derece esnek ve kullanımı kolay bir seçenektir. Her türlü proje için kullanabilirsiniz; kurulumu kolaydır ve seçeneklerinin çoğu diğer inşaat işlerinde görünür. Aşağıda iş yaratmak için adım adım bir süreç verilmiştir. Jenkins.
Adım 1) Giriş yapın Jenkins
Bir oluşturmak için Jenkins serbest stil işi, giriş yapın Jenkins kontrol panelinizi ziyaret ederek Jenkins Kurulum yolu. Genellikle localhost üzerinde barındırılır. http://localhost:8080 Eğer varsa yüklü Jenkins başka bir yolda, uygun olanı kullanın. URL Aşağıda gösterildiği gibi kontrol panelinize erişmek için Jenkins İş yaratma örneği.
Adım 2) Yeni Öğe Oluşturun
Tıklamak "Yeni Öğe"Gösterge panelinizin sol üst köşesindeki " bağlantısına tıklayın. Aşağıdaki ekran görüntüsü bu bağlantının nerede olduğunu göstermektedir.
Adım 3) Ürün ayrıntılarını girin
Bir sonraki ekranda,
- Oluşturmak istediğiniz öğenin adını girin. Bu demo için “Merhaba dünya”yı kullanacağız.
- Serbest Stil projesini seçin
- Tamam'ı tıklayın
Adım 4) Proje ayrıntılarını girin
Test etmek istediğiniz projenin ayrıntılarını girin. Açılan yapılandırma sayfası aşağıda gösterilmiştir.
Adım 5) Depoya girin URL
Kaynak Altında Code Yönetim, Deponuzu girin URLTest deposu şu adreste bulunmaktadır: https://github.com/kriru/firstJava.git
Yerel bir depo kullanmanız da mümkündür.
GitHub deponuz özel ise, Jenkins Öncelikle GitHub ile giriş bilgilerinizi doğrulayacağız ve ancak ondan sonra GitHub deponuzdan kaynak kodunu çekeceğiz.
Adım 6) Ayarları düzenleyin
Tüm detayları verdiğinize göre, artık kodu oluşturma zamanı geldi. Ayarları aşağıdaki bölümde düzenleyin. inşa etmek Kodu istediğiniz zamanda oluşturmak için bölüm. Hatta derlemenin belirli aralıklarla, belirli zamanlarda gerçekleşmesini bile planlayabilirsiniz.
Yapım aşamasında,
- Tıklamak "Derleme adımı eklebaşlıklı bir kılavuz yayınladı
- Tıklamak "Gerçekleştirmek Windows toplu komut”ve derleme işlemi sırasında yürütmek istediğiniz komutları ekleyin.
Mevcut derleme adımlarını listeleyen açılır menü şu şekilde görünmektedir.
⚠️ Sürüm notu: son Jenkins Bu alanı etiketleyen yayınlar Adımları Oluştur ziyade İnşa etmekve Linux'ta veya macOS acenteler için eşdeğer seçenek şudur: Kabuk yürütDüğme hala aynı isimle anılıyor. Derleme adımı ekle.
Burada Java kodunu derlemek için Java komutlarını ekledim.
Aşağıdaki Windows komutlarını ekledim:
javac HelloWorld.java java HelloWorld
Bu iki satırın girildiği komut kutusu aşağıda gösterilmiştir.
Adım 7) Projeyi kaydedin
Tüm verileri girdiğinizde,
- Tıkla Uygula
- İndirim Proje.
Adım 8) Kaynak kodunu oluşturun
Şimdi, ana ekranda, kaynak kodunu oluşturmak için sol taraftaki Şimdi Oluştur düğmesine tıklayın.
Adım 9) Durumu kontrol edin
Şimdi Oluştur seçeneğine tıkladıktan sonra Çalıştırdığınız yapının durumunu Yapı Geçmişi altında görebilirsiniz.
Adım 10) Konsol çıktısına bakın
Derleme numarasını tıklayın ve ardından çalıştırdığınız derlemenin durumunu görmek için konsol çıktısını tıklayın. Aşağıda gösterildiği gibi kurulumu doğru bir şekilde yaptıysanız, başarılı bir mesaj görmelisiniz. Jenkins Yeni iş örneği oluştur.
Özetle, GitHub'da barındırılan bir HelloWorld programını çalıştırdık. Jenkins Uzak depodan kodu çeker ve sizin belirlediğiniz sıklıkta sürekli olarak derleme yapar.
Jenkins Freestyle Projesi Yapılandırma Bölümlerinin Açıklaması
Yukarıdaki kılavuz yalnızca HelloWorld örneğinin ihtiyaç duyduğu alanlara değinmektedir. Yapılandırma sayfası altı form bölümüne ayrılmıştır ve her birinin neye sahip olduğunu bilmek, kalan seçenekleri bulmayı çok daha kolaylaştırır.
| Bölüm | Ne kontrol ediyor? | Tipik ayar |
| Genel | İş tanımı, eski sürümlerin atılması, parametreler ve işin belirli bir aracı üzerinde çalışıp çalışmayacağı. | Descriptiyon artı bir yapı tutma sınırı |
| Kaynak Code Yönetim | Hangi depoya hangi kimlik bilgileri ve dal ile erişileceği | Git, bir HTTPS URL, dal */master or */main |
| Tetikleyiciler Oluşturun | Derleme işlemini otomatik olarak başlatan nedir? | GitHub'dan SCM'yi sorgulayın, periyodik olarak derleme yapın veya bir webhook kullanın. |
| Yapı Ortamı | Yapının tamamına sarmalayıcılar uygulandı. | Derleme başlamadan önce çalışma alanını silin; konsol günlüğüne zaman damgaları ekleyin. |
| Adımları Oluştur | İşlemi gerçekleştiren komutlar yukarıdan aşağıya doğru çalışır. | Gerçekleştirmek Windows Toplu komut veya Kabuk komutunu çalıştır |
| Yapı Sonrası İşlemler | Adımlar tamamlandıktan sonra, sonuç ne olursa olsun, ne olur? | ArchiTest sonuçlarını inceleyin, test raporunu yayınlayın, e-posta gönderin. |
İki alışkanlık, daha sonra yapılacak birçok hata ayıklama işleminden sizi kurtarır. Derleme adımlarını, çalışmaları gereken sırayla ekleyin, çünkü Jenkins İşlemleri yukarıdan aşağıya doğru gerçekleştirir ve ilk hatada durur. Ardından, derleme sonrası bir işlem olarak derlemenin ürettiği her şeyi arşivler, çünkü çalışma alanı bir sonraki derleme tarafından yeniden kullanılırken, arşivlenmiş yapılar derleme numarasına göre saklanır.
Serbest Stil Proje mi Yoksa İşlem Hattı mı: Hangisini Kullanmalısınız?
Freestyle, Yeni Ürün ekranındaki tek proje türü değildir ve her zaman doğru olanı da olmayabilir. Aşağıdaki tablo, Freestyle'ı diğer proje türleriyle karşılaştırmaktadır. Boru hattı işi En önemli gerçek kararları belirleyen noktalarda.
| Karşılaştırma noktası | Serbest stil projesi | Boru Hattı |
| Nasıl tanımlanır? | İşin içinde saklanan web formları config.xml kumanda üzerinde |
A JenkinsUygulama koduyla birlikte kaydedilen dosya |
| Tarihi değiştir | Düzenleyen JenkinsDeponuzun dışında | RevDiğer kaynak dosyaları gibi incelenir ve sürümlendirilir. |
| Aşamalar ve paralel çalışma | Yapım aşamalarının tek ve düz bir listesi. | Adlandırılmış aşamalar, paralel kollar ve sahne görünümü |
| Öğrenme eğrisi | Kod yazmaya gerek yok. | Bildirimsel işlem hattı sözdizimini gerektirir. |
| En uygun | Tek bir derleme, tek bir komut dosyası, tek bir zamanlanmış görev veya öğrenme Jenkins | Ortamlar genelinde çok aşamalı derleme, test ve dağıtım akışları |
Pratik bir kural: İş tek bir görevden ibaretken ve aracı henüz öğrenirken serbest stile yönelin ve işi daha sonra tek bir göreve odaklayın. CI/CD ardışık düzeni İkinci bir aşamaya geçtiğinde veya kodla birlikte incelenmesi gerektiğinde. Eşli çalışan ekipler Jenkins Yapı araçlarıyla bu noktaya genellikle hızlıca ulaşılır — bir Maven ve Selenium kurulum Bu, geçiş için yaygın bir tetikleyicidir ve aynı mantık diğer tüm durumlar için de geçerlidir. otomasyon testi Birkaç aşamada çalışan bir paket.
