Azure Boards'u GitHub (bulut) ile bağlama

Azure DevOps Services

Çalışmanızı planlamak ve izlemek için yazılım geliştirme ve Azure Boards projeniz için GitHub.com depoları kullanın. Projeniz ve deponuz arasında bağlantı kurarak GitHub commitleriniz ve çekme isteklerinizin Azure Boards'taki iş öğelerinize bağlanabilmesini sağlayın.

Note

Azure Boards ve Azure DevOps Hizmetleri, GitHub.com ve GitHub Enterprise Server depolarıyla tümleştirmeyi destekler. Şirket içindeki bir Azure DevOps Server'dan bağlanmak istiyorsanız, bkz. Azure DevOps Server'ı GitHub Enterprise Server'a Bağlama.

Prerequisites

Category	Requirements
İzinler	- Proje Koleksiyonu Yöneticileri grubu üyesi Projeyi oluşturduysanız, izinleriniz vardır. bağlanacak GitHub deposunun - yöneticisi veya sahibi. Bu depoların yöneticisi olduğunuz sürece birden çok GitHub deposuna bağlanabilirsiniz.
Proje üyeliği	Proje üyesi.

Kimlik doğrulama seçenekleri

Bağlanmak istediğiniz GitHub platformu temel alınarak aşağıdaki kimlik doğrulama seçenekleri desteklenir.

GitHub.com

GitHub Enterprise Server

• GitHub.com kullanıcı hesabı (Önerilir)
• Kişisel erişim belirteci (PAT)

• OAuth (tercih edilen, kayıt gerekli)
• PAT
• GitHub kimlik bilgileri

Note

GitHub bir PAT ile bağlanmayı seçerseniz, GitHub hesabınızda PAT için çoklu oturum açmayı (SSO) yapılandırın. Bu yapılandırma, Güvenlik Onaylama İşaretleme Dili (SAML) SSO kimlik doğrulamasının etkinleştirildiği bir kuruluştan depoların listesini almak için gereklidir.

Azure Boards bir GitHub deposuna bağlama

1. Projenizde (https://dev.azure.com/{Your_Organization/Your_Project}) oturum açın.

2. Proje ayarları>GitHub connections öğesini seçin.

   

3. Projeden ilk kez bağlanıyorsanız, GitHub hesabı kimlik bilgilerinizi kullanmak için GitHub hesabınızı bağlayın seçeneğini seçin.

   

   Aksi takdirde Yeni bağlantı'yı seçin ve Yeni Bağlantı iletişim kutusundan kimlik doğrulama yönteminizi seçin.

   GitHub hesabınızla bağlandığınızda kimlik doğrulaması için GitHub kimlik bilgilerinizi kullanın. PAT kullanmak için bkz. PAT kullanarak GitHub bağlantısı ekleme. GitHub Enterprise Server'a bağlanmak için bkz. Azure DevOps'u GitHub'da bir OAuth Uygulaması olarak kaydetme.

GitHub kimlik bilgileriyle GitHub bağlantısı ekleme

Bir Azure Boards projesine en fazla 1.000 GitHub depo bağlayabilirsiniz.

1. Azure Boards'dan GitHub ilk kez bağlanıyorsanız GitHub kimlik bilgilerinizi kullanarak oturum açın. Depo yöneticisi olduğunuz bir hesap seçin.

2. Bağlanmak istediğiniz GitHub hesabını veya kuruluşu seçin. Yalnızca sahibi olduğunuz veya yöneticisi olduğunuz kuruluşlar listelenir.

   Bir kuruluşun tüm depoları zaten Azure Boards bağlıysa, aşağıdaki ileti şunları gösterir:

   Bağlanacak başka depo kalmadığını belirten mesajın ekran görüntüsü.

3. GitHub kimlik bilgilerinizi girin. İki öğeli kimlik doğrulaması etkinleştirildiyse, GitHub tarafından gönderilen kimlik doğrulama kodunu girin ve Verify öğesini seçin. Aksi takdirde, GitHub hesabınız Azure DevOps Hizmetleri hesabınızla ilişkilendirildiğinden sistem GitHub kuruluşunuzu otomatik olarak tanır.

GitHub depoları ekleme

Kimlik doğrulamasından geçtikten sonra, bağlanmak istediğiniz depoları seçebilirsiniz.

1. GitHub Depoları Ekle iletişim kutusu, seçili kuruluşta yönetici olduğunuz tüm GitHub.com depolarını otomatik olarak görüntüler ve seçer. Tümleştirmeye dahil etmek istemediğiniz depoların seçimini kaldırın.

   

   Tip

   Beklenmeyen AB# bağlantılarını önlemek için GitHub deposunu tek bir Azure DevOps organizasyonundaki projelere bağlamanızı öneririz. Aynı GitHub deponun birden çok Azure DevOps kuruluşundaki projelere bağlanması sorunlara neden olabilir. Daha fazla bilgi için bkz. GitHub ve Azure Boards entegrasyonu sorunlarını giderme.

   Eğer tüm depolar mevcut veya başka bir kuruluşa zaten bağlıysa, aşağıdaki ileti görüntülenir:

   Bağlanacak başka depo kalmadığını belirten mesajın ekran görüntüsü.

2. Seçimlerinizi yaptıktan sonra Kaydet'i seçin.

Bağlantıyı onaylayın

1. Görüntülenen GitHub sayfasını gözden geçirin ve ardından Onayla, Yükle ve Yetkilendir'i seçin.

   

2. Onaylamak için GitHub kimlik bilgilerinizi sağlayın.

3. İşiniz bittiğinde, seçilen depolarla yeni bağlantının listelendiğini görmeniz gerekir.

konfigürasyonu değiştirmek veya GitHub için Azure Boards uygulamasını yönetmek için bkz. Azure Boards için depo erişimini değiştirme.

PAT kullanarak GitHub bağlantısı ekleme

Important

Daha yüksek riskli personal erişim belirteçleri üzerinde daha güvenli Microsoft Entra belirteçleri kullanmayı göz önünde bulundurun. Daha fazla bilgi için bkz . PAT kullanımını azaltma. İhtiyaçlarınıza uygun kimlik doğrulama mekanizmasını seçmek için kimlik doğrulama kılavuzunu gözden geçirin.

GitHub deponuza bağlanmak için GitHub hesabı kimlik bilgilerinizi kullanmanızı öneririz.

Tip

GitHub PAT'nizi oluştururken şu kapsamları eklediğinizden emin olun: repo, read:user, user:email, admin:repo_hook.

1. Kişisel Erişim Belirteci'ni seçin.

   &lgt;c1>&lgt;c0>&lgt;sb0>Yeni GitHub bağlantısı iletişim kutusunun ekran görüntüsü, Kişisel Erişim Belirteci seçeneğini seçme.&lgt;/sb0>&lgt;/c0>&lgt;/c1>

   GitHub PAT oluşturmak için GitHub Geliştirici Ayarları > Kişisel erişim belirteçleri gidin.

2. PAT'i girin ve Bağlan'ı seçin.

   

3. Bu makalenin önceki bölümlerinde yer alan Depoları seçme başlığı altında açıklanan yordamları izleyerek projeye bağlanmak istediğiniz depoları seçin.

4. Azure Boards bir GitHub hesabına veya kuruluşuna ilk kez bağlanıyorsanız GitHub için Azure Boards uygulamasını yükleyin. Bu makalenin önceki bölümlerinde bağlantıyı onaylayın.

GitHub'da Azure DevOps OAuth Uygulaması olarak kaydetme

Azure DevOps GitHub Enterprise Server'ınıza bağlamak için OAuth kullanmak için önce uygulamayı OAuth Uygulaması olarak kaydedin. Daha fazla bilgi için bkz . OAuth Uygulaması oluşturma.

Azure DevOps Hizmetleri Kaydetme

1. GitHub Enterprise sunucunuz için web portalında oturum açın.

   

2. Ayarlar>>>.

   

3. Kayıt bilgilerini girin.

   Giriş sayfası URL'si için kuruluşunuzun Kuruluş URL'sini belirtin.
   Yetkilendirme geri çağırma URL'si için, URL'yi oluşturmak için aşağıdaki deseni kullanın.

   {Azure DevOps Services Organization URL}/_admin/oauth2/callback

   Örneğin:

   https://dev.azure.com/fabrikam/_admin/oauth2/callback

   

4. Kayıt uygulamasını seçin.

5. Kayıtlı OAuth uygulamanız için İstemci Kimliği ve İstemci Gizli Anahtarı görüntülenir.

   

OAuth yapılandırmanızı Azure DevOps Hizmetleri'ne kaydetme

1. Azure DevOps Hizmetleri için web portalında oturum açın.

2. kuruluşunuza GitHub Kurumsal Oauth yapılandırmasını ekleyin.

3. Kuruluş ayarları'nda Oauth yapılandırmaları, Oauth yapılandırması ekle.

   

4. Bilgilerinizi girin ve Oluştur'u seçin.

   

Azure DevOps Hizmetlerini GitHub Enterprise Server'a bağlama

Important

Azure DevOps Hizmetleri'ni GitHub Enterprise Server'ınıza bağlamak için, GitHub Enterprise Server'ınızın İnternet'ten erişilebilir olduğundan emin olun. Azure DNS GitHub Enterprise Server adınızı çözümleyebildiğini ve güvenlik duvarınızın Azure Veri Merkezi IP adreslerinden erişime izin verdiğinden emin olun. IP adresi aralığını belirlemek için bkz. Microsoft Azure Veri Merkezi IP Aralıkları. Bağlantı sorunları için sık karşılaşılan bir hata iletisi:

Uzak ad çözümlenemedi: 'github-enterprise-server.contoso.com'

Bu hatayla karşılaşırsanız sunucunuzun erişilebilirliğini denetleyin. Daha fazla bilgi için bkz. Azure DNS SSS.

1. İlk kez bağlantı için Proje ayarları>GitHub bağlantıları>GitHub Enterprise Server seçin.

   

   Alternatif olarak, Yeni GitHub bağlantısı iletişim kutusundan GitHub Enterprise Server öğesini seçin.

   

2. Kimlik doğrulama yöntemini seçin.

   

   OAuth ile bağlanma

   Azure DevOps Services'te OAuth yapılandırmanızı kaydetme adımının 4. adımında ayarladığınız yapılandırmayı seçin ve ardından Connect seçeneğini belirleyin.

   

   Kişisel Erişim Belirteci ile bağlanma

   GitHub Enterprise sunucunuzun URL'sini ve bu sunucu tarafından tanınan Kişisel erişim belirteci kimlik bilgilerini girin. Ardından Bağlan'ı seçin.

   

   GitHub kimlik bilgileriyle Connect

   GitHub Enterprise sunucunuzun URL'sini ve bu sunucu tarafından tanınan yönetici hesabı kimlik bilgilerini girin ve Connect öğesini seçin.

   

3. İletişim kutusunda, GitHub yönetim haklarına sahip olduğunuz tüm depolar listelenir. Başkalarının görünüp görünmediğini görmek için Benim ve Tümü arasında geçiş yapabilir ve ardından eklemek istediklerinizi işaretleyebilirsiniz. Bitirdiğinizde Kaydet'i seçin.

   

   Tip

   Yalnızca bir GitHub kuruluşta tanımlanan depolara bağlantı oluşturabilirsiniz. Projeyi başka bir GitHub kuruluşta tanımlanan diğer depolara bağlamak için başka bir bağlantı eklemeniz gerekir.

4. Azure Boards bir GitHub hesabına veya kuruluşuna ilk kez bağlanıyorsanız, GitHub için Azure Boards uygulamasını da yüklersiniz. Bu makalenin önceki bölümlerinde bağlantıyı onaylayın.

Bağlantı sorunlarını çözme

Azure Boards-GitHub tümleştirmesi, bağlantıyı korumak için çeşitli kimlik doğrulama protokollerini kullanır. Kullanıcının izin kapsamı veya kimlik doğrulaması kimlik bilgilerindeki değişiklikler Azure Boards bağlı GitHub depolarını iptal edebilir.

GitHub için Azure Boards uygulaması tarafından desteklenen tümleştirmeye genel bakış için bkz. Azure Boards-GitHub integration.

Desteklenen kimlik doğrulama seçenekleri

Aşağıdaki desteklenen kimlik doğrulama seçenekleri, bağlandığınız GitHub platformuna bağlıdır:

Platform

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

• GitHub.com kullanıcı hesabı
• Kişisel erişim belirteci (PAT)

• OAuth
• PAT
• GitHub kimlik bilgileri

Azure DevOps Server 2020

Uygulanamaz

• PAT
• GitHub kimlik bilgileri

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.

Azure Boards organizasyonuna erişim izni verme

Azure Boards ile GitHub arasındaki tümleştirme beklendiği gibi çalışmıyorsa kuruluşa erişim izni verdiğini doğrulayın.

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

2. Integrations>> altında Applications öğesini seçin.

3. Kuruluş erişimi altında karşılaşabileceğiniz sorunları çözün. İzin Ver seçeneğini belirleyin ve erişim isteği beklemede olarak gösterilen tüm kuruluşlara erişim izni verin.

   

Erişim sorunlarını çözme

GitHub Azure Boards bağlantısı erişimi kaybettiğinde, kullanıcı arabiriminde red-X ile bir uyarı durumu görüntülenir. Kimlik bilgilerinin artık geçerli olmadığını görmek için uyarının üzerine gelin. Sorunu düzeltmek için bağlantıyı kaldırın ve yeni bir bağlantı oluşturun.

Bu sorunu çözmek için aşağıdaki öğeleri göz önünde bulundurun:

• Bağlantı OAuth kullanıyorsa:

  • Azure Boards uygulamasının bir depoya erişimi reddedildi.

  • GitHub kullanılamıyor/ulaşılamıyor olabilir. Bu kullanılamazlık, hizmette veya şirket içinde bir altyapı/ağ sorunu nedeniyle olabilir. Hizmet durumunu aşağıdaki bağlantılardan de kontrol edebilirsiniz:

    • GitHub
    • Azure DevOps

    GitHub deposu bağlantısını silin ve yeniden oluşturun. Bu yeniden oluşturulan bağlantı, GitHub'ın Azure Boards için yeniden kimlik doğrulaması istemesine neden olur.

• Bağlantı pat kullanıyorsa:

  • PAT iptal edildi veya gerekli izin kapsamları değişti ve yetersiz hale geldi.

  • Kullanıcının GitHub deposunda yönetici izinleri olmayabilir.

    PAT'yi yeniden oluşturun ve belirtecin kapsamının gerekli izinleri içerdiğinden emin olun: repo, read:user, user:email, admin:repo_hook. Daha fazla bilgi için bkz. PAT'leri kullanmaya yönelik en iyi yöntemler.

GitHub Enterprise Server bağlantı sorununu çözme

Azure DevOps Server'den GitHub Enterprise Server bağlantısı olan Azure DevOps Hizmetlerine geçiş yaparsanız, var olan bağlantınız beklendiği gibi çalışmayabilir. GitHub ile ilişkili geri arama URL'sinin artık geçerli olmaması nedeniyle GitHub içindeki iş öğesi bahsetmeleri Azure DevOps Hizmetleri'nde gecikebilir veya hiç görünmeyebilir. Aşağıdaki çözümleri göz önünde bulundurun:

• Bağlantıyı yeniden oluşturun: GitHub Enterprise Server deposuna bağlantıyı kaldırın ve yeniden oluşturun. Connect from Azure Boards belgelerindeki adım sırasını izleyin.

• Web kancası URL'sini düzeltme: GitHub depo ayarları sayfasına gidin ve geçirilen Azure DevOps kuruluş URL'sine işaret ederek web kancası URL'sini düzenleyin: https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

Birden çok Azure DevOps kuruluşuna bağlanma

GitHub deponuzu dev.azure.com/Contoso ve dev.azure.com/Fabrikam gibi birden çok Azure DevOps kuruluşundaki projelere bağladığınızda, AB# bahsetmeleriyle beklenmeyen sonuçlara neden olabilir. İş öğesi kimlikleri Azure DevOps kuruluşlarda benzersiz olmadığından AB#12 Contoso veya Fabrikam'daki bir iş öğesine başvurabilir. Taahhüt iletisinde veya pull request'te bir iş öğesinden bahsedildiğinde, her iki kuruluş da eşleşen ID ile bir iş öğesine bağlanmaya çalışarak karışıklığa neden olabilir.

Bu sorunu önlemek için tek bir GitHub deposunu tek bir Azure DevOps kuruluşa bağlayın.

Note

GitHub için Azure Boards uygulamasını kullanarak bağlandığınızda, uygulama birden çok kuruluşa yönelik bağlantıları engeller. bir GitHub deposu yanlış Azure DevOps kuruluşa bağlıysa, depoyu doğru Azure DevOps kuruluşa eklemeden önce bağlantıyı kaldırmak için bu kuruluşun sahibine başvurun.

Belirli iş öğesi türleri için XML tanımlarını güncelleştirme

Kuruluşunuz iş izleme deneyimini özelleştirmek için Barındırılan XML veya şirket içi XML işlem modelini kullanıyorsa iş öğesi türleri için XML tanımlarını güncelleştirin ve iş öğesi formlarındaki Geliştirme bölümünden GitHub bağlantı türlerine bağlanın ve görüntüleyin.

Örneğin, kullanıcı öykülerini ve hatalarını Development bölümünden GitHub commit'lere ve çekme isteklerine bağlamak için, kullanıcı hikayeleri ve hataları için XML tanımlarını güncelleyin.

XML tanımlarını güncelleştirmek için Barındırılan XML işlem modelinde sağlanan görev dizisini izleyin. Her iş öğesi türü için Group Label="Development" bölümünü bulun ve dış bağlantı türlerini desteklemek için kod söz dizimine aşağıdaki iki satırı ekleyin: GitHub Commit ve GitHub Çekme İsteği.

             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  

Güncelleştirdikten sonra bölüm aşağıdaki gibi görünmelidir.

<Group Label="Development">  
   <Control Type="LinksControl" Name="Development">  
      <LinksControlOptions ViewMode="Dynamic" ZeroDataExperience="Development" ShowCallToAction="true">  
         <ListViewOptions GroupLinks="false">   
         </ListViewOptions>  
         <LinkFilters>  
             <ExternalLinkFilter Type="Build" />  
             <ExternalLinkFilter Type="Integrated in build" />  
             <ExternalLinkFilter Type="Pull Request" />  
             <ExternalLinkFilter Type="Branch" />  
             <ExternalLinkFilter Type="Fixed in Commit" />  
             <ExternalLinkFilter Type="Fixed in Changeset" />  
             <ExternalLinkFilter Type="Source Code File" />  
             <ExternalLinkFilter Type="Found in build" />  
             <ExternalLinkFilter Type="GitHub Pull Request" />  
             <ExternalLinkFilter Type="GitHub Commit" />  
         </LinkFilters>  
      </LinksControlOptions>  
   </Control>  
</Group>  

FAQs

S: Azure DevOps'daki bazı kullanıcılarımın GitHub kimlikleri var. Bunları kuruluşuma yeni GitHub kullanıcıları olarak eklemem gerekiyor mu?

Y: Hayır. Kullanıcılarınızdan oturumu kapatmalarını ve ardından yeni bir tarayıcı oturumundaki GitHub kimlik bilgileriyle kuruluşta yeniden oturum açmalarını isteyin. Bu eylem, GitHub kimliklerini oluşturur.

S: Kuruluş Yöneticisiyim ve GitHub kullanıcıları davet etme ilkesini etkinleştirdim. Neden yeni GitHub kullanıcıları davet edemiyoruz?

Y: Ayarı değiştirdikten sonra Azure DevOps oturumu kapatın ve yeni bir tarayıcı oturumundan GitHub kimlik bilgilerinizle kuruluşta (dev.azure.com/{organizationName} veya organizationName.visualstudio.com) yeniden oturum açın.

S: GitHub kimlik bilgilerimle oturum açtım, ancak neden GitHub kullanıcıları davet edemiyoruz?

Y: Yalnızca kuruluş veya proje Yöneticileri yeni kullanıcıları kuruluşa katılmaya davet edebilir. Yeni kullanıcı eklemek için gerekli izinlere sahip olmayabilirsiniz. Gerekli izinleri almak için yöneticinizle birlikte çalışın veya kullanıcıyı sizin yerinize eklemesini isteyin.

S: GitHub Enterprise kullanıcıları Azure DevOps ücretsiz erişim elde mi?

Y: Daha fazla bilgi için bkz. User ve izin yönetimi hakkında SSS/GitHub Enterprise.

Sonraki Adımlar

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

İlgili içerik

• GitHub
• GitHub README dosyalarına eklemek için durum rozetlerini yapılandırın
• GitHub ve Azure Boards tümleştirmesi sorun giderme
• GitHub havuzları oluştur
• GitHub depo erişimini değiştir

GitHub tümleştirmesi ile yapabilecekler

Bağlandıktan sonra şunları yapabilirsiniz:

• otomatik kod oluşturma için GitHub Copilot: İş öğeleriyle GitHub Copilot kullanın
• İş öğelerini bağla: Değişiklikleri, dalları ve çekme isteklerini iş öğelerine otomatik olarak bağlayın
• Gelişim izleme: İlerleme durumunu doğrudan Azure Boards