Aracılığıyla paylaş

Azure Boards'ta GitHub commit'lerini, pull request'lerini, dallarını ve sorunlarını iş öğelerine bağlama

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Bu makalede, Azure Boards projenizi GitHub deposuna bağladıktan sonra iş öğelerini GitHub işlemelerine, çekme isteklerine ve dallara bağlamayı öğrenin. Commit'ler ve dallar için #mention söz dizimini kullanabilir veya Azure Boards iş öğelerinden doğrudan bir GitHub commit, pull request veya dal bağlantısı ekleyebilirsiniz.

Note

GitHub tümleştirme desteği:

  • Azure DevOps Services: GitHub için Azure Boards uygulaması aracılığıyla hem GitHub.com hem de GitHub Enterprise Server depolarıyla tümleştirilir.
  • Azure DevOps Server 2020 ve üzeri: Yalnızca GitHub Enterprise Server depolarıyla tümleştirmeyi destekler.
  • Diğer Git depoları: Tümleştirme desteklenmez.

Prerequisites

Category Requirements
Permissions Katkıda Bulunan hem Azure Boards projesine hem de GitHub deposuna.
Proje bağlantısı Azure Boards projesi, taahhütlerin, çekme isteklerinin ve bağlanmak istediğiniz dalın bulunduğu GitHub deposuna bağlanır. Daha fazla bilgi için bkz . Azure Boards-GitHub tümleştirmesi.

Note

Barındırılan XML işlem modelini kullanan projeler, Geliştirme bölümünü ve GitHub bağlantı türlerini görüntülemek için iş öğesi türlerinde güncelleştirmeler gerektirir. Daha fazla bilgi için bkz . Belirli iş öğesi türleri için XML tanımlarını güncelleştirme.

GitHub commit, çekme isteği veya sorun üzerinden Azure Boards iş öğenize bağlantı oluşturmak için aşağıdaki söz dizimini kullanın. AB#ID işleme iletisi metnine yerleştirin. Ya da çekme isteği veya sorun için açıklamaya AB#ID girin. Açıklama veya çekme isteği başlığında AB#ID kullanılması, iş öğesinde bağlantı oluşturmaz.

AB#{ID}

Örneğin, AB#125 bir iş öğesi kimliği 125'e bağlantı verir.

Bir iş öğesinin geçişini sağlamak için bir taahhüt veya çekme isteği iletisi de girebilirsiniz. Sistem {state} veya {state category} ile birlikte fix, fixes, ve fixed öğesini tanır ve bunları izleyen #bahsetme öğesine uygular.

Çekme isteği açıklaması geçerli bir durum adı içerdiğinde, örneğin, Closed AB#1234, sistem ilgili iş öğesini bu belirli duruma günceller. Durum adı doğrudan tanınmıyorsa, Azure Boards bunu veya Resolvedgibi Completed bir iş akışı kategorisiyle eşleştirmeye çalışır. Eşleşme bulunursa, iş öğesi söz konusu kategori altında tanımlanan ilk kullanılabilir duruma geçirilir.

Varsayılan olarak, fix, fixes, veya fixed ile başvurulan iş öğeleri, Çözümlendi kategorisiyle ilişkilendirilmiş ilk duruma geçiş yapar. Geçerli işlemde böyle bir durum yoksa, sistem bunun yerine iş öğesini Tamamlandı kategorisindeki ilk duruma geçirmektedir.

Important

İş öğelerini bağlamaya ve diğer dalları hedeflemeye devam edebilirsiniz, ancak pull request varsayılan dalda birleştirilmediği sürece durum geçiş kuralları uygulanmaz.

Daha fazla bilgi için Azure Boards kapsamları ve panolarında iş akışı kategorisi durumları nasıl kullanılır? başlığına bakın.

Aşağıdaki örnek tablosunu gözden geçirin:

Taahhüt veya çekme isteği iletisi Action
Fixed AB#123 İş öğesini Çözümlenmiş iş akışı durumu kategorisine veya tanımlı değilse Tamamlanan iş akışı durumu kategorisine bağlar ve bu kategoriye geçirilir.
Closed AB#123 İş öğesini Kapalı iş akışı durumuna bağlar ve geçirir. Hiçbiri tanımlanmamışsa hiçbir geçiş yapılmaz.
Adds a new feature, fixes AB#123. İş öğesini Çözümlenmiş iş akışı durumu kategorisine veya tanımlı değilse Tamamlanan iş akışı durumu kategorisine bağlar ve bu kategoriye geçirilir.
Fixes AB#123, AB#124, and AB#126 Azure Boards 123, 124 ve 126 iş öğelerine bağlantılar. Yalnızca ilk öğe olan 123 öğesini Çözüldü iş akışı durumu kategorisine veya tanımlı değilse Tamamlandı iş akışı durumu kategorisine geçirilir.
Fixes AB#123, Fixes AB#124, Fixes AB#125 Azure Boards 123, 124 ve 126 iş öğelerine bağlantılar. Tüm öğeleri Çözüldü iş akışı durumu kategorisine veya tanımlı değilse Tamamlandı iş akışı durumu kategorisine geçirilir.
Fixing multiple bugs: issue #123 and user story AB#234 GitHub sorunu 123 ve Azure Boards iş öğesi 234 için bağlantılar. Geçiş yapılmaz.

Note

Aynı GitHub deposunu iki veya daha fazla Azure DevOps kuruluşundaki projelere bağladıysanız beklenmedik AB# atıf bağlantısı görebilirsiniz. Daha fazla bilgi için bkz . Bağlantı sorunlarını çözme. Bu nedenle, bir GitHub deposunu yalnızca tek bir Azure DevOps kuruluşunda tanımlanan projelere bağlamanızı öneririz.

AB# kullanarak bir iş öğesine bağlantı eklediğinizde, bu bağlantılar çekme isteğinin Geliştirme bölümünde görünür.

AB# bağlantılarının GitHub pull request geliştirme bölümündeki ekran görüntüsü.

İş öğesinden GitHub dalı oluşturma

Doğrudan bir iş öğesinden GitHub dalı oluşturmak için şu adımları uygulayın:

  1. Panonuzda GitHub dalı oluşturmak istediğiniz iş öğesini bulun.

  2. İş öğesi eylemlerini>Yeni GitHub dalı seçin.

    İş öğesinin ekran görüntüsünde Diğer eylemler menüsü açılmış ve Yeni GitHub dalı seçeneği vurgulanmıştır.

  3. GitHub dalı oluştur iletişim kutusunda dal adını girin ve GitHub deposunu ve temel dalı seçin.

  4. Oluştur'i seçin.

    GitHub Dalı Oluştur iletişim kutusunun ekran görüntüsü.

    Azure Boards, belirtilen GitHub deposunda dalı oluşturur ve iş öğesine bağlar. Daha fazla bilgi için bkz . Azure Boards-GitHub tümleştirmesi.

  1. İş öğesini açın ve Bağlantılar sekmesine gidin.

    İş öğesi formunun, Bağlantılar sekmesinin, Soruna bağlantı ekle'nin ekran görüntüsü.

  2. Bağlantı ekle iletişim kutusunda GitHub bağlantı türlerinden birini seçin, bir GitHub deposu seçin, GitHub dalının URL'sini girin, işleme veya çekme isteği yapın ve ardından Bağlantı ekle'yi seçin.

    Aşağıdaki örnekte, bir GitHub çekme isteğine bağlantı ekleyeceğiz.

    İş öğesi formunun, Bağlantılar sekmesinin, Bağlantı ekle iletişim kutusunun, GitHub çekme isteği bağlantı türünün seçili olduğu ekran görüntüsü.

    Azure Boards, geçerli bir bağlantı girdiğinizden emin olmak için bir denetim tamamlar. GitHub'a bağlı deponun Azure Boards projesine bağlı olması gerekir veya doğrulama başarısız olur.

Note

Azure DevOps Server ve GitHub Enterprise Server kullanıyorsanız AB# bağlantılarını tamamlarken gecikme yaşanıyor. GitHub olaylarındaki Commit, Çekme İsteği ve Sorunlarda saat başı oluşan kademeli değişiklikleri çekebileceğimiz bir 'itme ve çekme' tasarımına sahibiz.

Birkaç olay, iş öğesi formundaki bağlantıları otomatik olarak güncelleştirdiğinden, bunları el ile oluşturmanız gerekmez. Bunlar şunları içerir:

GitHub olayı Action
Şubeye Bağlantı Bir daldan bir çekme isteği oluşturulduğunda, bu çekme isteği otomatik olarak iş öğesine bağlanır.
Birleştirme işlemesi Çekme isteği birleştirildikten sonra, sonuçta elde edilen birleştirme işlemesi otomatik olarak iş öğesine bağlanır.
Dalı sil Dal silinirse (genellikle birleştirildikten sonra), bağlantısı iş öğesinden otomatik olarak kaldırılır.

İş öğesi formunun Geliştirme bölümünde, GitHub taahhütleri ve çekme istekleri için oluşturulan bağlantılar GitHub simgesiyle listelenir.

GitHub bağlantılarını gösteren geliştirme bölümünde iş öğesi formunun ekran görüntüsü.

GitHub'da işleme veya çekme isteğini açmak için sağlanan bağlantıyı seçin.

GitHub nesnelerini panoda görüntüleme

GitHub notları panoda etkinleştirildiğinde, bağlantılı GitHub işlemlerini, pull request'leri veya sorunları daha ayrıntılı bilgi almak için hızla açabilirsiniz. Daha fazla bilgi için Kartları özelleştirme bölümüne bakınız.

İş öğesi kartlarındaki GitHub bağlantılarını gösteren panonun ekran görüntüsü.

Sonraki Adımlar

Durum rozetlerini yapılandırma

İlgili içerik

  • Last updated on