GitHub için Azure Boards uygulamasını yükleme

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

Bu hızlı başlangıçta, Azure Boards GitHub depolarınıza bağlamak için GitHub için Azure Boards uygulamasını yükleyebilirsiniz. Azure Boards projelerini GitHub.com depolarına bağladığınızda, GitHub taahhütleri ve çekme talepleri ile iş öğeleri arasında bağlantı kurmayı desteklersiniz. çalışmanızı planlamak ve izlemek için Azure Boards kullanırken yazılım geliştirme için GitHub kullanabilirsiniz. GitHub hesabınıza veya kuruluşunuza GitHub için Azure Boards uygulamasını yükledikten sonra, projenizden hangi GitHub depolarına bağlanmak istediğinizi seçin.

GitHub için Azure Boards uygulamasının desteklediği tümleştirmeye genel bakış için bkz. Azure Boards-GitHub integration.

Prerequisites

İzin kategorisi	Requirements
Azure DevOps	- Proje Koleksiyonu Yöneticileri grubuüyesi. Projeyi oluşturduysanız bu izne sahip olursunuz. - Proje üyesi Azure Boards projesinde.
GitHub	- Azure Boards uygulamasını yüklemek için GitHub kuruluş yöneticisi veyasahibi - GitHub deposu için okuma izinleri

Important

• Deponuz OAuth gibi başka bir kimlik doğrulama türü kullanılarak zaten bağlıysa, GitHub Uygulamasını kullanarak yeniden bağlamadan önce bu depoyu mevcut bağlantınızdan kaldırmanız gerekir. GitHub Uygulamasını yapılandırmadan önce Bu makalenin devamında yer alan GitHub depoları ekleme veya kaldırma bölümünde verilen adımları izleyin.
• Bu depoların yöneticisiyseniz, bir Azure DevOps kuruluşunu birden çok GitHub deposuna bağlayabilirsiniz. bir GitHub deposunu birden fazla Azure DevOps kuruluşuna bağlamamalısınız.

Azure Boards uygulamasını yükleme ve yapılandırma

Aşağıdaki adımlarda tipik bir yükleme dizisi gösterilmektedir. Kurulumu tamamlamak için ekrandaki yönergeleri izleyin.

1. GitHub Market Azure Boards uygulamasına gidin.

2. Planlar ve fiyatlandırma'nın altında, Ücretsiz'in altında Yükle'yi seçin.

3. Azure Boards’u Yükleyin ve Yetkilendirin bölümünde, Azure Boards’a bağlamak istediğiniz depoları seçin ve ardından Yükle ve Yetkilendir öğesini seçin.

   Bu örnekte Tüm depolar kullanılır:

   

4. GitHub.com bağlanmak istediğiniz Azure DevOps kuruluşunu ve Azure Boards projesini seçin.

   

   Aynı anda yalnızca bir projeye bağlanabilirsiniz. Diğer projeleri bağlamak istiyorsanız bkz. Diğer projeleri veya depoları yapılandırma.

Azure Boards organizasyonuna erişim izni verme

Azure DevOps kuruluşunuza GitHub erişim vermek için aşağıdaki adımları tamamlayın.

1. GitHub web portalından profil menünüzü kullanarak Settings açın.

   

2. Tümleştirmeler'in altında Uygulamalar'ıseçin.

3. Authorized GitHub Apps>Azure Boards öğesini seçin.

   

4. Kuruluş erişimi altında görünen sorunları çözün. Grant'i seçerek, Erişim isteği beklemede olarak görünen kuruluşlara erişim izni verebilirsiniz.

   

Üçüncü taraf uygulama erişim ilkenizi denetleyin

GitHub kuruluşunuzun Azure Boards uygulaması için üçüncü taraf uygulama erişimine izin olduğundan emin olun. Üçüncü taraf erişimi kısıtlanmışsa, Azure DevOps depoları eklemek boş bir liste gösterebilir veya hata oluşturabilir.

Erişimi etkinleştirmek için:

1. GitHub'da kuruluşunuzu açın ve Ayarlar>OAuth uygulama ilkesi'ne gidin.

2. Azure Boards uygulamasını özel olarak onaylayın (önerilir) veya tüm üçüncü taraf uygulamalar için kısıtlamaları kaldırın.

   

Uyarı

Bu ayarı değiştirmek için kuruluş sahibi veya yönetici olmanız gerekir.

İş öğelerini GitHub çekme isteklerine bağlama

Azure Boards-GitHub tümleştirmenizi yapılandırdıktan sonra, iş öğelerinizi GitHub çekme isteklerine ve işlemelere bağlayabilirsiniz.

Aşağıdaki örnek, bir iş öğesi oluşturup bunu bir çekme talebine bağlayarak entegrasyonu gösterir:

1. Panonuzda Yeni iş öğesi'ni seçerek bir iş öğesi oluşturun. Bu örnek için "BENIOKU'ya rozet ekle" başlığını kullanın. İş öğesi türü sürecinize bağlıdır: Sorun (Temel), Kullanıcı Hikayesi (Çevik) veya Ürün Kapsamı Öğesi (Scrum).

   Yeni iş öğesi panonuzda görünür.

2. İş öğenizi açın ve Geliştirme bölümüne gidin.

3. Bağlantı ekle'yi seçin ve ardından Bağlantı türü menüsünden GitHub Çekme İsteği'ni seçin.

4. Depoyu seçin ve çekme isteği kimliğini girin. İsteğe bağlı bir açıklama da ekleyebilirsiniz.

5. Bağlantıyı oluşturmak için Bağlantı ekle'yi seçin.

   Azure Boards arka planda otomatik olarak aşağıdaki eylemleri gerçekleştirir:

   • Bağlı GitHub depoları listesindeki ilk deponun README dosyasına bir rozet ekler
   • Rozet güncellemesi için bir GitHub gönderimi oluşturur
   • README dosyasındaki değişiklikleri birleştirmek için bir GitHub çekme talebi oluşturur
   • GitHub kaydetme ve çekme talebini iş öğenize bağlar

6. İş öğenizde, bunu GitHub’da açmak için çekme isteği bağlantısını seçin.

7. GitHub'da Çekme İsteğini Birleştir'i seçin.

8. GitHub deponuzda, rozetin eklendiğini doğrulamak için README dosyasını açın. Daha fazla bilgi için GitHub README dosyalarına eklenecek durum rozetlerini yapılandırma konusuna bakın.

Diğer projeleri veya depoları yapılandırma

Diğer Azure Boards/Azure DevOps projelerini, GitHub.com depolarını yapılandırabilir veya mevcut yapılandırmayı Azure Boards uygulama sayfasından değiştirebilirsiniz. Daha fazla bilgi için bkz. Depo ekleme veya kaldırma ya da Azure Boards bağlantısını kaldırma.

Depo ekleme veya kaldırma ya da Azure Boards bağlantısını kaldırma

Bağlantıyla ilgili bir sorunla karşılaşırsanız, bağlantıyı kaldırın ve yeni bir bağlantıyla baştan başlayın.

1. Azure DevOps’taki projenizden Proje ayarları>GitHub bağlantıları seçin.

2. Bağlantı için Diğer seçenekler üç noktasına tıklayın ve menüden Depo ekle veya Depoları kaldır'ı seçin.

   Ekran görüntüsü, GitHub bağlantı menüsünü ve Diğer seçenekleri gösterir.

3. Tüm depoları ve bağlantıyı kaldırmak için Bağlantıyı kaldır seçeneğini belirleyin. Ardından onaylamak için Kaldır'ı seçin.

   

Depo erişimini değiştirme

1. GitHub web portalından profil menünüzü kullanarak Settings açın.

2. Tümleştirme Uygulamaları'nı> seçin. Stalled GitHub Apps altında Configure öğesini seçin.

   

   Azure Boards yapılandırma sayfası açılır.

3. Ekranı aşağı kaydırarak Depo erişimi bölümüne gelin.

4. İstediğiniz seçeneği belirtin, Tüm depolar veya Yalnızca depoları seçin.

   Only select repositories seçerseniz, Azure Boards tümleştirmesine katılmak istediğiniz depoları seçin.

   

5. Kaydetseçeneğini seçin.

Azure Boards tümleştirmesini askıya alma veya kaldırma

1. Önceki yordamda 2. adımdan başlayarak, ekranı aşağı kaydırarak Tehlike bölgesi bölümüne gelin.

   

2. Tümleştirmeyi askıya almak için Askıya Al'ı seçin. Askıya alma işlemini onaylamak için onay penceresinde Tamam'ı seçin.

   

   Entegrasyonu askıdan çıkarmak için Askıdan çıkar'ı seçin.

3. Azure Boards uygulamasını kaldırmak için Kaldır'ı ve ardından açılan onay penceresinden Tamam'ı seçin.

   

Azure Boards-GitHub bağlantılarını güncelleştirme

GitHub için Azure Boards uygulamasının desteklediği depoları değiştirirseniz, Azure Boards GitHub bağlantılara yönlendirilebilirsiniz. Artık GitHub'a bağlanamayacak olan Azure Boards depolarını kaldırmak iyi bir uygulamadır. Daha fazla bilgi için bkz. GitHub depolarını ekleme veya kaldırma.

GitHub için Azure Boards uygulamasını kaldırırsanız, aşağıdaki ileti Azure Boards, Proje ayarları>GitHub bağlantılarında görüntülenir. Daha önce yapılan tüm GitHub bağlantıları kaldırmak için Bağlantıyı kaldır'ı seçin. Daha fazla bilgi için bkz. GitHub depolarını ekleme veya kaldırma.

Ekran görüntüsü, kaldırılmış Azure Boards GitHub uygulamasını gösterir.

Tümleştirme sorunlarını giderme

Depo eklerken boş depo listesi

Depo listesi Azure DevOps boş görünüyorsa:

• GitHub kuruluşunuzun üçüncü taraf uygulama erişimini etkinleştirdiğini doğrulayın.
• Azure Boards’a kuruluş erişimi verme bölümünde, Azure Boards’a kuruluşunuza erişim izni verdiğinizden emin olun.
• GitHub'da kuruluş ayarlarınızı > Yüklü GitHub Uygulamaları > Azure Boards > Kuruluş erişimi bölümünden denetleyin. Durumda "Erişim isteği beklemede" yazıyorsa onaylamak için İzin ver'i seçin.

"Erişim isteği beklemede" takılı kalma durumu

Kuruluş erişimi beklemede kalırsa:

• İsteği onaylamak için GitHub kuruluş sahibi veya yöneticisi olmanız gerekir.
• Yetkili uygulamalar ayarlarınızda, Kuruluş erişimi bölümünde Grant'ı seçin.
• Sorun devam ederse, Azure Boards uygulamasını kaldırın ve Azure Boards uygulamasını yükleme ve yapılandırma makalesindeki adımları izleyerek uygulamayı yeniden yükleyin.

Çekme isteğini bağladıktan sonra rozet görünmüyor

Bir çekme isteğini bağladıktan sonra rozet README dosyanızda görünmüyorsa:

• Rozet yalnızca çekme isteğini bağladığınızda ve depo bağlı listenizde ilk sıradaysa görünür.
• Bağlantısını verdiğiniz PR'nin hâlâ açık olduğunu doğrulayın (birleştirilmiş PR'ler rozet oluşturulmasını tetiklemez).
• Azure Boards deponuza yazma erişimi olup olmadığını denetleyin.

Kimlik doğrulaması veya izin hataları

Kurulum sırasında kimlik doğrulama hataları görürseniz:

• GitHub'da kuruluş sahibi veya yönetici olduğunuzu doğrulayın.
• GitHub kuruluşunuzun üçüncü taraf uygulama erişimini kısıtlamadığından emin olun.
• Bağlanmak istediğiniz depoda Okuma izinlerinizin olup olmadığını denetleyin.
• GitHub'dan çıkış yapıp yeniden giriş yapmayı deneyin, ardından yetkilendirmeyi tekrar deneyin.

Sonraki adım

İş öğelerine GitHub commit'leri, pull isteklerini ve dalları bağlama

İlgili içerik

• İş öğesinden Git geliştirmesini yönlendirme
• GitHub depo erişimini değiştirin veya entegrasyonu askıya alın ya da kaldırın
• GitHub README dosyalarına eklemek için durum rozetlerini yapılandırın