GitHub commit'leri, pull request'leri, dalları ve issue'ları Azure Boards iş öğelerine bağlama

Azure DevOps Hizmetleri | Azure DevOps Server | Azure DevOps Server 2022

Bu makalede, Azure Boards projenizi bir GitHub deposuna bağladıktan sonra iş öğelerini GitHub commit'lerine, çekme taleplerine, dallara ve derlemelere nasıl bağlayacağınızı öğreneceksiniz. Commit'ler ve dallar için #mention söz dizimini kullanın, iş öğesi tartışmalarında GitHub çekme isteklerine başvurmak için ! anmalarını kullanın veya doğrudan Azure Boards iş öğesinden bir GitHub commit’i, çekme isteği ya da dal bağlantısı ekleyin.

Prerequisites

GitHub'den Azure Boards iş öğelerine bağlanmak için AB# kullanın

Azure Boards iş öğelerine bağlantı vermek için GitHub metninde AB# bahsetmelerini kullanın.

Bağlantı oluşturmak için:

1. AB#{ID} öğesini bir işleme mesajına, çekme isteği açıklamasına veya problem açıklamasına ekleyin.
2. Commit’i push edin veya pull request’i ya da issue’yu kaydedin.
3. Bağlantının Geliştirme bölümünde göründüğünü onaylamak için iş öğesini açın.

AB#ID ifadesini bir yorumda ya da çekme isteği başlığında kullanmak, iş öğesi üzerinde bir bağlantı oluşturmaz.

AB#{ID}

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

İş öğelerinin durumunu gönderme veya çekme isteği metninden de değiştirebilirsiniz. Azure Boards, {state} veya {state category} ile fix, fixes ve fixed gibi anahtar sözcükleri tanır ve ardından bu geçişi, ardından gelen AB# referansına 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.

Daha fazla bilgi için bkz. Azure Boards birikimleri ve panolarında iş akışı kategorisi durumları nasıl kullanılır.

Aşağıdaki yalnızca bağlantı örneklerini kullanın:

Aşağıdaki bağlantı ve geçiş örneklerini kullanın:

Ç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:

1. Panonuzdan, GitHub dalı oluşturmak için kullanmak istediğiniz iş öğesini bulun.

2. Çalışma öğesi eylemleri>Yeni GitHub dalı öğesini seçin.

   

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

4. 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

1. İş öğenizi açın ve Geliştirme alanına gidin.

2. 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.

3. 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.

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:

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 ilişkili GitHub pull request'leri ek durum ayrıntılarını gösterir. GitHub’da pull request’i 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

1. Bağlı bir GitHub çekme isteği olan iş öğesi açın.

2. 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.

   

3. 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:

1. YAML işlem hattınızı açın, Diğer eylemler'i ve ardından Ayarlar'ı seçin.

2. İş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ştirdiğinizde, daha fazla ayrıntı görmek için bağlantılı GitHub commit’lerini, çekme isteklerini veya issue’larını hızla açabilirsiniz. Daha fazla bilgi için Kartları özelleştirme bölümüne bakınız.

GitHub işi bağlamak ve yönetmek için yapay zekayı kullanma

Azure DevOps MCP Sunucusu'nu yapılandırıyorsanız, iş öğesi formunda el ile gezinmek yerine GitHub-iş öğesi bağlama görevlerini doğal dilde açıklayabilirsiniz.

Senaryo örnekleri olarak bu istemleri kullanın. Desteklenen işlemler yapılandırılmış araç kümelerine, uzantı sürümüne ve izinlerinize göre farklılık gösterir.

Bazı istemler yazma eylemi gerçekleştirmek yerine rehberlik döndürebilir veya etkinleştirdiğiniz MCP araçlarına bağlı olarak birden çok istem gerektirebilir.

bir istem çalıştırmadan önce , <Contoso>ve <owner/repo> gibi <sha>yer tutucuları gerçek değerlerinizle değiştirin.

Bu hızlı çalıştırma ve doğrulama akışını kullanın:

1. Tablodan bir istem çalıştırın.
2. Gerçekleştirilen eylemin yanıtını gözden geçirin.
3. İş öğesini açın ve Geliştirme bölümünde sonucu onaylayın.
4. İlgili GitHub yapıtını açın ve beklenen bağlantıyı veya güncelleştirmeyi onaylayın.

Önce şu istemleri deneyin:

• Link work item AB#125 in project <Contoso> to GitHub pull request <owner/repo>#42
• Link work item AB#312 in project <Contoso> to GitHub commit <owner/repo>@<sha>
• Summarize all GitHub commits and pull requests linked to work item AB#312 in project <Contoso>

Yapay zeka destekli bağlantı sorunlarını giderme

• İstem çalışmazsa, yapay zeka istemcinizde aracı modunun etkinleştirildiğini onaylayın.
• Bir istem erişim hatalarıyla başarısız olursa hesabınızın Azure DevOps projesine ve GitHub deposuna erişimi olduğunu doğrulayın.
• Bağlantılar oluşturulmazsa, tüm yer tutucuları (örneğin, <Contoso>, <owner/repo>, <sha>) gerçek değerlerle değiştirin ve istemi yeniden çalıştırın.
• Toplu istem başarısız olursa, önce tek bir iş öğesiyle yeniden deneyin, ardından daha küçük bir toplu işlemle yineleyin.
• Sonuçlar yine de beklentileri karşılamıyorsa, sonucu iş öğesi Geliştirme bölümünde ve ilgili GitHub yapıtında doğrulayın.

Sonraki adım

İlgili içerik

• Azure Boards'u GitHub ile Entegre Et
• İşlem hatlarını iş izlemeyi destekleyecek şekilde yapılandırma
• Azure Boards iş listeleri ve panolarında iş akışı kategorisi durumlarının nasıl kullanıldığını anlayın
• İş öğelerini nesnelere bağlama
• GitHub ve Azure Boards bağlantı sorunlarını çözme