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 bir 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 doğrudan Azure Boards iş öğesinden GitHub işleme, çekme isteği 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 |
|---|---|
| İzinler | Contributor, hem Azure Boards projesine hem de GitHub deposuna. |
| Proje bağlantısı | Azure Boards projesi, bağlanmak istediğiniz veya mevcut işlemelerin, çekme taleplerinin ve dalların bulunduğu GitHub deposuna bağlanır. Daha fazla bilgi için bkz. Azure Boards-GitHub integration. |
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'den Azure Boards iş öğelerine bağlanmak için AB# kullanın
GitHub işleme, çekme isteği veya sorundan, 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 Resolved veya Completed gibi 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 bkz. Azure Boards birikimleri ve panolarında iş akışı kategorisi durumları nasıl kullanılır.
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 |
123, 124 ve 126 Azure Boards iş öğelerinin 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'daki sorun 123 ve Azure Boards'taki iş öğesi 234'e bağlantılar. Geçiş yapılmaz. |
Note
Aynı GitHub deposunu iki veya daha fazla Azure DevOps organizasyonundaki projelere bağladıysanız, beklenmeyen AB# mention bağlantısıyla karşılaşabilirsiniz. Daha fazla bilgi için bkz . Bağlantı sorunlarını çözme. Bu nedenle, yalnızca tek bir Azure DevOps kuruluşunda tanımlanan projelere bir GitHub deposu bağlamanızı öneririz.
Çekme isteği açıklamasında AB# kullanarak iş öğesine bağlantı eklediğinizde, bu bağlantılar GitHub çekme isteğinin Development 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:
Panonuzdan, GitHub dalı oluşturmak için kullanmak istediğiniz iş öğesini bulun.
Çalışma öğesi eylemleri>Yeni GitHub dalı öğesini 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 integration.
GitHub branşı, commit veya pull request'e iş öğesi bağlantısı ekleme
İş öğenizi açın ve Geliştirme alanına gidin.
Bağlantı ekle'yi seçin. Her açılan menüden link türünüzü, GitHub deposu ve GitHub çekme isteği 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. Bağlı GitHub deposu Azure Boards projesine bağlı olmalıdır, aksi takdirde doğrulama başarısız olur.
Note
Azure DevOps Server ve Enterprise Server GitHub kullanıyorsanız, AB# bağlantılarını tamamlarken bir gecikme olur. GitHub olaylarındaki Commit, PR ve Sorunlar üzerindeki artımlı değişiklikleri saatte bir çekmek için 'push ve pull' tasarımı kullanılı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 |
|---|---|
| Dal bağlantısı | 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 simgesini kullanarak GitHub işleme ve çekme istekleri için oluşturulan bağlantılar listelenir.
Commit veya pull isteğini GitHub'da açmak için bağlantıyı seçin.
GitHub pull request içgörüleri
Geliştirme bölümündeki bağlı GitHub çekme istekleri ek durum ayrıntılarını gösterir, böylece çekme isteğini GitHub açmadan ilerleme durumunu değerlendirebilirsiniz.
Çekme isteği içgörüleri için önkoşullar
Pull Request içgörülerini görmek için GitHub'daki Azure Boards uygulamasına gidin ve Denetimler için okuma ve yazma erişimi güncellenmiş izinlerini kabul edin.
`
`
Çekme isteği durum ayrıntılarını görüntüleme
Bağlı bir GitHub çekme isteği olan iş öğesi 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.
Detayları görmek için bir durum göstergesinin üzerine gelin veya doğrudan GitHub'da açmak için çekme isteği bağlantısını seçin.
! kullanarak GitHub çekme isteklerinden bahsedin
! etiketlerini kullanarak herhangi bir iş öğesinin zengin metin alanından veya tartışma açıklamasından doğrudan GitHub çekme isteklerine başvurun 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 oluşturmak için Azure Pipelines YAML kullandığınızda, ilişkili çalışma öğeleri üzerinde 'derlemede birleştirildi' bağlantılarını otomatik olarak oluşturabilirsiniz. Bu özellik, GitHub depoları için derleme izlenebilirliği sağlayarak Azure Repos'ta sunulan deneyimle eşdeğer kılar.
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.
Panodaki GitHub nesneleri görüntüleme
Panoda GitHub ek açıklamalarını etkinleştirerek, daha ayrıntılı bilgi için bağlantılı GitHub işlemlerini, çekme isteklerini veya sorunları hızla açabilirsiniz. Daha fazla bilgi için Kartları özelleştirme bölümüne bakınız.
