Projemin GitHub Readme.md dosyasında Jenkins derleme durumunu göstermenin bir yolu var mı?

Jenkins sürekli entegrasyon yapılarını çalıştırmak için kullanıyorum. Her taahhütten sonra, nihayet dokümantasyon ve yayın paketleri üretmeden önce her şeyin derlenmesini ve birim ve entegrasyon testlerini yürütmesini sağlar.

Hala yapıyı bozan bir şeyi yanlışlıkla yapma riski vardır. GitHub proje sayfasını ziyaret eden kullanıcıların geçerli master'ın bu durumda olduğunu bilmesi iyi olur.

Tamam, Jenkins'i GitHub derleme durumlarını ayarlayacak şekilde ayarlayabilirsiniz. Bu, Jenkins'e her basışta derlemeler yapmak üzere yapılandırılmış GitHub eklentisi bulunduğunu varsayar.

1. GitHub'a gidin, giriş yapın, Ayarlar'a gidin , Kişisel erişim belirteçleri , Yeni belirteç oluştur'a tıklayın .

   

2. Repo: durumu kontrol edin (bunun gerekli olduğundan emin değilim, ama yaptım ve benim için çalıştı).

   

3. Simgeyi oluşturun, kopyalayın.

4. Kullanacağınız GitHub kullanıcısının bir depo ortak çalışanı (özel depolar için) olduğundan veya oluşturmak istediğiniz depolara push ve pull erişimine (kuruluş depoları için) sahip bir ekibin üyesi olduğundan emin olun.

5. Jenkins sunucunuza gidin, giriş yapın.

6. Jenkins'i Yönetin → Sistemi Yapılandır

7. GitHub Web Hook altında Jenkins'in kanca URL'lerini otomatik olarak yönetmesine izin ver'i seçin , ardından GitHub kullanıcı adınızı ve 3. adımda aldığınız OAuth jetonunu belirtin .

   

8. Kimlik Bilgilerini Test Et düğmesiyle çalıştığını doğrulayın . Ayarları kaydedin .

9. Jenkins işini bulun ve yapım sonrası adımlara GitHub taahhüdünde Yapı durumunu ayarla'yı ekleyin

   

Bu kadar. Şimdi bir test derlemesi yapın ve çalışıp çalışmadığını görmek için GitHub deposuna gidin. Tıklayın Şube inşa durumları görmek için ana depo sayfasında.

Yeşil onay işaretlerini görmelisiniz:

Bu arada Jenkins ve GitHub'ın kullanıcı arayüzü biraz değişti ve Jenkins'in şimdi doğru bir şekilde nasıl yapılandırılacağını anlamak biraz zaman aldı. Buradaki açıklama Jenkins 2.121.1 versiyonunu temel almaktadır.

Ayrıca Jenkins Job'unuzu bir webhook veya yoklama tarafından tetiklenecek şekilde yapılandırdığınızı da varsayıyorum. Çalıştırmak için attığım adımlar şunlardır:

1. Github'ı Yapılandırma: OAuth Scope ile Kişisel Erişim Jetonu Oluşturun repo:status
2. Jenkins'i yapılandırın: Configure Systemve OAuth Secret'ı GitHub Sunucusu olarak ekleyin - Secret TextOAuth Secret'ı oraya koymak için bir kimlik doğrulama yöntemi olarak kullanın .
3. Jenkins Job'unuzu yapılandırın: Derleme sonrası eylemiSet GitHub commit status olarak ekleyin . Durum Sonucunu olarak ayarlayın .One of the default messages and statuses
4. GitHub'daki sonucunuzu kontrol edin: GitHub taahhüdünüzde derleme durumunu ve derleme yürütme süresini alıp almadığınızı kontrol edin.

Github'ı Yapılandır

Jenkins'i Yapılandırma

Jenkins Job'u Yapılandırma

Sonuç

Artık taahhütlerinizin ve şubelerinizin durumunu göreceksiniz:

Yaptığım şey oldukça basit:

1. Hudson Post Görev Eklentisini Yükleme
2. Burada bir Kişisel Erişim Jetonu oluşturun: https://github.com/settings/tokens

3. Her zaman başarılı olan bir Görev Görevi Eklentisi ekleyin

   curl -XPOST -H "Authorization: token OAUTH TOKEN" https://api.github.com/repos/:organization/:repos/statuses/$(git rev-parse HEAD) -d "{
     \"state\": \"success\",
     \"target_url\": \"${BUILD_URL}\",
     \"description\": \"The build has succeeded!\"
   }"
   

4. "Derleme hata olarak işaretlendi" durumunda başarısızlık verecek bir Görev Görevi Eklentisi ekleyin

   curl -XPOST -H "Authorization: token OAUTH TOKEN" https://api.github.com/repos/:organization/:repos/statuses/$(git rev-parse HEAD) -d "{
     \"state\": \"failure\",
     \"target_url\": \"${BUILD_URL}\",
     \"description\": \"The build has failed!\"
   }"
   

5. Testlerin başında bekleyen bir çağrı da ekleyebilirsiniz

   curl -XPOST -H "Authorization: token OAUTH TOKEN" https://api.github.com/repos/:organization/:repos/statuses/$(git rev-parse HEAD) -d "{
     \"state\": \"pending\",
     \"target_url\": \"${BUILD_URL}\",
     \"description\": \"The build is pending!\"
   }"
   

Bu eklenti çalışmalıdır: https://wiki.jenkins-ci.org/display/JENKINS/Embeddable+Build+Status+Plugin

README.mdDosyanıza böyle rozetler ekleyebilmeniz gerekir :

İşlem Durumu API'sı " Repo Durumları API'sını " görmenizi sağlar .

Ve 26 Nisan 2013'ten bu yana , GitHub repo şube sayfanızda derleme durumunu görebilirsiniz :

Bu, GitHub proje sayfasını ziyaret ederek, yalnızca Jenkins'e sahip olmak yerine bu durumları görmenin başka bir yolu olduğu anlamına gelir.

30 Nisan 2013'ten itibaren, taahhüt durumları için API bitiş noktası, şube ve etiket adlarının yanı sıra taahhüt SHA'larına da izin verecek şekilde genişletildi .

Ayrıca size README.md'de gönderebileceğiniz bir rozet url'si verecek ve buna benzeyen bu eklenti de var.

https://wiki.jenkins-ci.org/display/JENKINS/Embeddable+Build+Status+Plugin

Bilgisayarınızda Githubyüklü bir eklenti varsa Jenkins, bunu şu şekilde yapabilirsiniz Post build actions:

README.md'inize aşağıdaki satırı ekleyin ve her iki URL'yi de jenkins projenize göre değiştirin.

[![Build Status](https://jenkins../..project/lastBuild/buildStatus)](https://jenkins../..project/lastBuild/)

Jenkins ve GitHub'ın korumalı şubesinin kurulmasıyla ilgili. Jenkins 2.6 kullanıyorum ve bunlar bunu yapmak için yaptığım adımlar:

Deponuzun GitHub web sayfasında:

1. Ayarlar> Dallar'a gidin.
2. Dalları koru'nun altında, Aşağı açılan dal seç menüsünü tıklayın ve Korumalı dal olarak ayarlamak istediğiniz dalı seçin.
3. Seçenekleri gerektiği gibi etkinleştirin.

Jenkins Sunucusunda: (Git ve GitHub Eklentisinin kurulu olduğundan emin olun)

1. Jenkins'i Yönet> Sistemi Yapılandır'a gidin.
2. GitHub altında, API URL'sini https://api.github.com olarak ayarlayın . Bu varsayılan değer olsa da.
3. Kimlik Bilgileri için oluşturulan simgenizi seçin. Henüz bir jeton oluşturmadıysanız, Gelişmiş ... 'e tıklayın, ardından Ek eylemler'de, giriş ve şifrenizi jetona dönüştürebilir ve kimlik bilgileriniz olarak kullanabilirsiniz.

Ayrıca, Jenkins'inizin kullandığı GitHub hesabının depo için bir ortak çalışan olduğundan emin olun. Yazma izni seviyesiyle ayarladım.

Bu yardımcı olur umarım.

Alex'in talimatlarını takip ettim ve işe yaradı.

Ancak, GitHub Enterprise için sunucuyu Jenkins'e eklerken API URL'sini değiştirmeniz gerekir.

Örneğin, şirketiniz creditcard.com ise URL'niz

https://github.creditcard.com/api/v3/

Jently sizin günceller Github durumunu işlemek ne yazık ki uygulamaya henüz, (yukarıda @vonc tarafından açıklandığı gibi) Repo Durum API

Düzenle:

Artık bu yaklaşımı kullanmıyorum, lütfen diğer cevaplardan birini kullanın.

Güncelleme: özel durumumuz için ne yaptım? (Yukarıdaki cevaplar harikaydı - teşekkürler!)

Derleme sunucumuz internette olmadığından derleme durumunu github'daki gh-pages dalına yayınlayacak bir komut dosyamız var.

• İnşa damgası başarısız
• Yapı pullarının başarısı
• Proje ana proje sonrasında sonuçları yayınlamak için çalışır -> yapı durumu, API belgeleri, test raporları ve test kapsamı.

GitHub görüntüleri önbelleğe alır, bu nedenle derleme durumu görüntüsü için kısa bir önbellek zaman aşımı talimatı veren .htaccess dosyası oluşturduk.

Bunu build-status görüntüsüyle dizine koyun:

ExpiresByType image/png "access plus 2 minutes"

İşte derleme betiği. Gh -sayfalarına yayın yapan hedef '--publish.site.dry.run'

400'den az yapılandırma satırı ile:

• Çekleri derleyin
• birim ve entegrasyon testleri
• Test raporları
• Kod Kapsamı Raporları
• API Dokümanları
• Github'da Yayınlama

. . ve bu komut dosyası Jenkins'in içinde veya dışında çalıştırılabilir, böylece:

• Geliştiriciler bu komut dosyasını yürütmeden önce çalıştırarak başkalarını etkileyen kırık bir yapının olasılığını azaltır.
• Bir arızanın yerel olarak çoğaltılması kolaydır.

Sonuçlar:

Proje ana sayfası , en son API Dokümanları, test sonuçları ve test kapsamı ile birlikte her derlemeden sonra güncellenen derleme durumuna sahiptir.