Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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, dallara ve derlemelere bağlamayı öğrenin. İşlemeler ve dallar için #mention söz dizimini kullanabilir, iş öğesi tartışmalarından GitHub çekme isteklerine başvurmak için ! bahsetmelerini kullanabilir veya GitHub işleme, çekme isteği ya da dal bağlantısını doğrudan Azure Boards iş öğesinden 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
Geliştirme bölümünü ve GitHub bağlantı türlerini görüntülemek için, Barındırılan XML işlem modelini kullanan projeler 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'dan Azure Boards iş öğelerine bağlantı vermek için kullanın AB#
GitHub işleminden, çekme talebinden veya sorundan Azure Boards iş öğenize bir link oluşturmak için aşağıdaki yapıyı 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çer. 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.
Çekme isteği açıklamasında kullanarak AB# bir iş öğesine bağlantı eklediğinizde, bu bağlantılar GitHub çekme isteğinin Geliştirme bölümünde görünür. Bu bağlantılar yalnızca çekme isteği açıklamasında AB# kullandığınızda kullanılabilir. İş öğesinden doğrudan bir pull request'e bağlanırsanız, görünmezler. Referansın AB# açıklamadan kaldırılması, geliştirme bölümünden de kaldırılmasına neden olur.
İş öğesinden GitHub dalı oluşturma
Doğrudan bir iş öğesinden GitHub dalı oluşturmak için aşağıdaki adımları kullanın:
Panonuzda GitHub dalı oluşturmak için kullanmak istediğiniz iş öğesini bulun.
İş öğesi eylemlerini>Yeni GitHub dalı seçin.
GitHub dalı oluştur iletişim kutusunda dal adını girin. GitHub deposunu ve temel dalı seçin.
Oluştur'i seçin.
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.
GitHub dalı, işlem veya çekim isteğine iş maddesi bağlantısı ekleme
İş öğenizi açın ve Geliştirme alanına gidin.
Bağlantı ekle'yi seçin. Her açılan menüden bağlantı türünüzü, GitHub deponuzu ve GitHub çekme isteğinizi seçin. Belirli bir pull isteğini veya commit'i bulmak ve seçmek için URL kopyalayıp yapıştırmanıza gerek kalmadan depo içinde arama yapabilir ve detaylara inebilirsiniz.
Bağlantı ekle'yi seçin.
Azure Boards, geçerli bir bağlantı girdiğinizden emin olmak için denetler. 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 bir gecikme oluşur. İşlem, her saat başı GitHub olaylarından Commit, Çekme İsteği (PR) ve Sorun üzerindeki artımlı değişiklikleri çekmek için 'gönderme ve çekme' tasarımını kullanır.
Otomatik bağlantı güncelleştirmeleri
Birkaç olay, iş öğesi formundaki bağlantıları otomatik olarak güncelleştirdiğinden, bunları el ile oluşturmanız gerekmez. Bu olaylar şunlardır:
| GitHub olayı | Action |
|---|---|
| Şubeye Bağlantı | Bir daldan çekme isteği oluşturulduğunda, bu çekme isteği otomatik olarak iş öğesine bağlanır. |
| Birleştirme işlemesi | Pull isteği birleştirildikten sonra, oluşan birleştirme işlemi otomatik olarak iş birimine bağlanır. |
| Dalı sil | Dal silinirse (genellikle birleştirildikten sonra), bağlantısı iş öğesinden otomatik olarak kaldırılır. |
Geliştirme bölümünde bağlantıları görüntüleme veya açma
İş öğesi formundaki Geliştirme bölümünde, GitHub simgesi kullanılarak GitHub commit'leri ve pull request'lere 
oluşturulan bağlantılar listelenir.
GitHub'da işleme veya çekme isteğini açmak için bağlantıyı seçin.
GitHub pull request bilgileri
Geliştirme bölümündeki bağlı GitHub çekme istekleri ek durum ayrıntılarını gösterir, böylece GitHub'da çekme isteğini açmadan ilerleme durumunu değerlendirebilirsiniz.
Çekme isteği içgörüleri için önkoşullar
Çekme isteği içgörülerini görmek için GitHub'daki Azure Boards uygulamasına gidin ve Kontroller'e okuma ve yazma erişimi için güncellenmiş izinleri onaylayın.
Çekme isteği durum ayrıntılarını görüntüleme
Bağlı bir GitHub çekme isteği olan iş öğesini açın.
Geliştirme bölümünde bağlantılı çekme isteğini bulun. Çekme isteği bağlantısının yanında aşağıdaki durum ayrıntıları görüntülenir:
- Taslak durumu: Çekme isteğinin hala taslak olup olmadığını gösterir.
- Gözden geçirme durumu: Çekme isteğinin gözden geçirilmesini mi, onaylandığını mı yoksa değişiklik mi istendiğini gösterir.
- Denetim durumu: CI denetimlerinin başarılı, başarısız veya beklemede olup olmadığını gösterir.
Durum göstergesi üzerine gelerek diğer ayrıntıları görebilir veya çekme isteği bağlantısını seçerek doğrudan GitHub'da açabilirsiniz.
GitHub çekme isteklerinden ! kullanarak bahsedin.
Bahsetmeleri ! kullanarak herhangi bir iş öğesi zengin metin alanından veya tartışma yorumundan GitHub pull request'lerine doğrudan referans verin ve tartışın. Metin alanına ! yazdığınızda, bağlı bir depodan GitHub çekme isteği aramak ve seçmek için kullanabileceğiniz bir seçici görüntülenir. Seçili çekme isteği tıklanabilir bağlantı olarak eklenir.
Bu özellik, URL'leri el ile kopyalamadan iş öğesi açıklamalarında, kabul ölçütlerinde veya tartışma mesaj dizilerinde ilgili çekme isteklerine kolayca başvurmayı sağlar.
YAML boru hatları için derleme durumunu görüntüleme (Derlemeye entegre)
GitHub deposunda barındırılan kodu derlemek için Azure Pipelines YAML kullandığınızda, ilişkili iş öğelerinde otomatik olarak Tümleşik derleme bağlantıları oluşturabilirsiniz. Bu özellik, GitHub depoları için derleme izlenebilirliği sağlar ve Azure Repos için mevcut olan deneyimle eşdeğerlik sunar.
Bu özelliği etkinleştirmek için:
YAML işlem hattınızı açın,
Diğer eylemler'i ve ardından Ayarlar'ı seçin.İşlem hattı ayarları iletişim kutusunda, Bu derlemede yeni iş öğelerini otomatik olarak bağla seçeneğini etkinleştirin.
Derleme tamamlandığında, ilişkili her iş öğesinin Geliştirme bölümünde otomatik olarak bir Tümleşik derleme bağlantısı görüntülenir ve ekibinize iş öğesinden derlemeye kadar tam izlenebilirlik sağlar.
Bu ayarı yapılandırma hakkında daha fazla bilgi için bkz. İşlem hatlarını iş izlemeyi destekleyecek şekilde yapılandırma.
GitHub nesnelerini panoda görüntüleme
Panoda GitHub açıklamalarını etkinleştirerek, bağlantılı GitHub commit’lerini, çekme isteklerini veya sorunları hızla açabilir ve daha fazla ayrıntı görebilirsiniz. Daha fazla bilgi için Kartları özelleştirme bölümüne bakınız.
