Dış hizmet için dal ilkesi yapılandırma

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Dal ilkeleri, tüm çekme istekleri için gereksinimler kurarak, repoda yüksek kaliteli kod sağlamak için güçlü bir özelliktir. Dış hizmetler PR'lerinize ayrıntılı durum gönderisi yapmak için PR Durumu API'sini kullanabilir. Dış hizmetler için dal ilkesi, bu üçüncü taraf hizmetlerin PR iş akışına katılmalarını ve ilke gereksinimleri oluşturmalarını sağlar. Bu makale, PR durumu gönderen bir hizmet için dal ilkesi yapılandırma sürecinde size yol gösterir. Çekme isteği durumu hakkında daha fazla bilgi için bkz. Çekme isteği durumuyla çekme isteği iş akışlarını özelleştirme ve genişletme.

Not

Bu makalede belgelenmiş olan özellik için TFS 2018 Güncelleştirme 2 veya sonraki bir sürümü gerekir.

Önkoşullar

  • Git Azure DevOps bir kuruluş. Bir kuruluş yoksa ücretsiz sınırsız özel Git depolarında kod yüklemek ve paylaşmak için kaydolabilirsiniz.
  • DurumlarınıRS'lere iletir. Bkz. Çekme isteği durum sunucusu oluşturma.

Dal ilkesi yapılandırma

  1. Kod > Dalları'a gidin ve ilkeyi yapılandırmak istediğiniz dalı bulun (genellikle master veya develop ). Bağlam menüsünden Dal ilkeleri seçeneğini belirleyin.

    Bağlam menüsünden Dal ilkeleri'i seçin

  2. Durum denetimlerini bulmak için aşağı kaydırın. + düğmesini seçin.

    İlke ekle düğmesini seçin

  3. Listeden ilke oluşturmak istediğiniz hizmeti seçin. Durum daha önce gönderildiyse listeden seçebilirsiniz; Yeni bir ilke ise, ilkenin adını yazarak.

    Listeden ilkeyi seçin

    • İlke gereksinimi, bu ilkenin dalda çekme isteklerini tamamlamak için isteğe bağlı veya gerekli olup olmadığını belirler.
    • Yetkili kimlik, ilkenin yerine getirilmesi için yalnızca belirtilen kimlikten bu durumu zorlamak için kullanılır.
    • Sıfırlama koşulları, gönderilen durumun ne zaman geçerli olmadığını belirlemek için kullanılır. Gönderilen durum en son koda (yani derlemeye) özgü ise, kaynak dal değiştinde durumu sıfırlamak için her yeni değişiklik olduğunda Durumu sıfırla'yı kontrol edin.
    • İsteğe bağlı olarak bir Yol filtresi ayarlayın. Dal ilkelerde yol filtreleri hakkında daha fazla bilgi.
    • İlke uygulanabilirliği, bu ilkenin çekme isteği oluşturulur oluşturulmaz geçerli olup olmadığını veya ilkenin yalnızca çekme isteğine ilk durum gönderildikten sonra geçerli olup olmadığını belirler.
    • Varsayılan görünen ad, ilkeniz için isteğe bağlı bir görünen ad belirtmenize olanak sağlar.

Yeni çekme isteği oluşturma

  1. İlkenin tanımlandığı dala yeni bir çekme isteği oluşturun. Daha fazla bilgi için bkz. Çekme isteği oluşturma.

  2. Pr'i oluşturdukta yeni ilke, PR ayrıntıları görünümünün İlkeler bölümünde görünür. İlk olarak, dış hizmet durumu gönderene kadar ilke ayarlanmaz olarak görünür.

    İlke durumu İlkeler bölümünde görünür

    Hizmet durumu yayınlayana kadar ilke uygun şekilde güncelleştirmesi gerekir. İlke PR'i onaylayana kadar tamamlama engellenir.

    İlke durumu güncelleştirmeleri

    İlke ölçütleri karşılandıktan ve hizmet bir durumla succeeded karşılaştığında, PR onaylanır ve tamamlama engeli silinir.

    İlke durumu onaylandı ve tamamlama engeli kaldırıldı

Özet

Bu makalede, bir dış hizmet için dal ilkesi yapılandırmayı öğrendiniz.