Připojení Azure Boards k GitHub (cloud)

Služby Azure DevOps

Připojte projekt Azure Boards k GitHub.com úložištím, aby potvrzení a žádosti o přijetí změn automaticky propojily s pracovními položkami. Tato integrace umožňuje plánovat a sledovat práci v Azure Boards, zatímco váš tým vyvíjí na GitHubu.

Po připojení můžete:

• Automatické propojování commitů, větví a žádostí o přijetí změn s pracovními položkami
• Monitorování průběhu vývoje přímo z Azure Boards
• Použití GitHub Copilotu s pracovními položkami pro vývoj s asistencí umělé inteligence

Note

Azure Boards podporuje integraci s GitHub.com i GitHub Enterprise Serverem. Pokud se chcete připojit z místního Azure DevOps Serveru, přečtěte si téma Připojení Azure DevOps Serveru k GitHub Enterprise Serveru.

Prerequisites

Category	Requirements
Povolení	– Člen skupiny Správci kolekce projektů skupiny Pokud jste projekt vytvořili, máte oprávnění. - Administrator nebo vlastník úložiště GitHub pro připojení. Pokud jste správcem těchto úložišť, můžete se připojit k více GitHub úložištím.
Členství v projectu	člen projektu.

Možnosti ověřování

Následující možnosti ověřování jsou podporované na základě platformy GitHub, ke které se chcete připojit.

GitHub.com

Podnikový server GitHub

• GitHub.com uživatelský účet (doporučeno)
• Osobní přístupový token (PAT)

• OAuth (preferovaný, vyžaduje se registrace)
• PAT
• GitHub přihlašovací údaje

Note

Pokud se připojíte pomocí pat, nakonfigurujte pro něj jednotné přihlašování (SSO) na svém účtu GitHubu. Jednotné přihlašování se vyžaduje k výpisu úložišť z organizace, která používá ověřování SAML.

Připojení Azure Boards k úložišti GitHub

1. Přihlaste se ke svému projektu (https://dev.azure.com/{Your_Organization/Your_Project}).

2. Vyberte nastavení projektu >GitHub připojení.

   

3. Pro první připojení vyberte Připojit účet GitHub a ověřte se pomocí přihlašovacích údajů GitHubu.

   

   Pro další připojení vyberte Nové připojení a zvolte metodu ověřování.

   Pokud se chcete místo toho připojit pomocí PAT, přečtěte si téma Přidání připojení GitHubu pomocí PAT. Informace o GitHub Enterprise Serveru najdete v tématu Registrace Azure DevOps na GitHubu jako aplikace OAuth.

Přidání připojení k GitHub pomocí autentizačních údajů GitHub

K projektu Azure Boards můžete připojit až 1 000 GitHub úložišť.

1. Přihlaste se pomocí přihlašovacích údajů GitHubu. Zvolte účet, ve kterém jste správcem úložiště.

2. Vyberte účet GitHubu nebo organizaci, ke které se chcete připojit. V seznamu se zobrazí jenom organizace, které vlastníte nebo spravujete.

   Pokud jsou všechna úložiště pro organizaci již připojená, zobrazí se následující zpráva:

   

3. Zadejte svoje GitHub přihlašovací údaje. Pokud máte povolené dvoufaktorové ověřování, zadejte kód odeslaný GitHubem a vyberte Ověřit.

Přidání úložišť GitHub

Po ověření vyberte úložiště, která se mají připojit.

1. V dialogovém okně Přidat úložiště GitHub se zobrazí a předem vyberou všechna úložiště, ve kterých jste správcem ve vybrané organizaci. Vymažte všechna úložiště, která nechcete připojit.

   

   Tip

   Připojte každé úložiště na GitHubu k projektům v jedné organizaci Azure DevOps, abyste se vyhnuli neočekávanému propojení zmínky AB#. Další informace najdete v tématu Řešení problémů s připojením.

   Pokud jsou všechna úložiště již připojená k aktuální nebo jiné organizaci, zobrazí se následující zpráva:

   

2. Vyberte Uložit.

Potvrzení připojení

1. Na stránce GitHubu vyberte Schválit, Nainstalovat a Autorizovat.

   

2. Potvrďte své přihlašovací údaje GitHubu.

3. Nové připojení se zobrazí s vybranými úložišti uvedenými v seznamu.

Pokud chcete změnit konfiguraci nebo spravovat aplikaci Azure Boards pro GitHub, přečtěte si téma Změňte přístup k Azure Boards.

Přidejte připojení k GitHubu pomocí osobního přístupového tokenu (PAT)

Important

Zvažte použití bezpečnějších tokenů Microsoft Entra místo vysoce rizikových osobních přístupových tokenů. Další informace najdete v tématu Snížení využití PAT. Projděte si doprovodné materiály k ověřování a zvolte správný mechanismus ověřování pro vaše potřeby.

Tip

Při vytváření GitHub PAT zahrňte tato oprávnění: repo, read:user, user:email, admin:repo_hook.

1. V dialogovém okně Nové připojení vyberte osobní přístupový token.

   

   Pokud chcete vytvořit GitHub PAT, přejděte na Nastavení vývojáře GitHub > Osobní přístupové tokeny.

2. Zadejte PAT a vyberte Připojit.

   

3. Vyberte úložiště, která se mají připojit. Podrobnosti najdete v tématu Přidání úložišť GitHub.

4. Pro první připojení nainstalujte aplikaci Azure Boards pro GitHub. Viz Potvrzení připojení.

Zaregistrujte Azure DevOps v GitHubu jako aplikaci OAuth

Pokud chcete azure DevOps připojit k GitHub Enterprise Serveru pomocí OAuth, zaregistrujte aplikaci jako aplikaci OAuth. Další informace najdete v tématu Vytvoření aplikace OAuth.

Registrace služeb Azure DevOps

1. Přihlaste se k webovému portálu pro GitHub Enterprise Server.

   

2. Otevřete nastavení>Nastavení pro vývojáře>Oauth Apps>Nová OAuth aplikace.

   

3. Zadejte registrační informace.

   • Adresa URL domovské stránky – Adresa URL vaší organizace
   • Adresa URL zpětného volání autorizace – Použijte vzor {Organization URL}/_admin/oauth2/callback. Příklad: https://dev.azure.com/fabrikam/_admin/oauth2/callback

   

4. Vyberte Zaregistrovat aplikaci.

5. Zkopírujte ID klienta a tajný klíč klienta , které se zobrazí pro vaši zaregistrovanou aplikaci OAuth.

   

Registrace konfigurace OAuth ve službě Azure DevOps Services

1. Přihlaste se k webovému portálu pro Azure DevOps Services.

2. Vyberte Nastavení organizace>Konfigurace OAuth>Přidat konfiguraci OAuth.

   

3. Zadejte informace a vyberte Vytvořit.

   

Připojení Azure DevOps Services k GitHub Enterprise Serveru

Important

Váš GitHub Enterprise Server musí být přístupný z internetu. Ověřte, že Azure DNS dokáže přeložit název serveru a že brána firewall umožňuje přístup z rozsahů IP adres datacentra Azure. Mezi běžné chyby patří:

Vzdálený název nelze přeložit: "github-enterprise-server.contoso.com"

Pokud se zobrazí tato chyba, zkontrolujte přístupnost vašeho serveru. Další informace najdete v tématu Azure DNS nejčastější dotazy.

1. Vyberte Nastavení projektu>GitHub připojení>GitHub Enterprise Server pro první připojení.

   

   Pro další připojení vyberte GitHub Enterprise Server z dialogového okna Nové připojení GitHubu .

   

2. Vyberte metodu ověřování.

   

   Připojte se pomocí OAuth – Vyberte konfiguraci OAuth, kterou jste zaregistrovali v registraci konfigurace OAuth, a pak vyberte Připojit.

   

   Připojte se pomocí osobního přístupového tokenu – Zadejte adresu URL serveru GitHub Enterprise a PAT a pak vyberte Připojit.

   

   Připojte se pomocí přihlašovacích údajů GitHubu – Zadejte adresu URL serveru GitHub Enterprise a přihlašovací údaje správce a pak vyberte Připojit.

   

3. V dialogovém okně jsou uvedena všechna úložiště, ve kterých máte práva pro správu. Přepněte mezi Mými a Všemi, abyste našli další úložiště, vyberte ta, která chcete přidat, a poté zvolte Uložit.

   

   Tip

   Každé připojení podporuje jenom jednu organizaci GitHubu. Pokud chcete připojit úložiště z jiné organizace, přidejte samostatné připojení.

4. Pro první připojení nainstalujte aplikaci Azure Boards pro GitHub. Viz Potvrzení připojení.

řešení problémů s připojením

Integrace Azure Boards –GitHub používá k údržbě připojení několik ověřovacích protokolů. Změny oborů oprávnění nebo přihlašovacích údajů můžou odpojit propojená úložiště GitHubu.

Přehled integrace najdete v tématu Integrace azure Boards-GitHub.

Podporované možnosti ověřování

Následující podporované možnosti ověřování závisí na GitHub platformě, ke které se připojujete:

Platform

GitHub.com

Podnikový server GitHub

Služby Azure DevOps

• GitHub.com uživatelský účet
• Osobní přístupový token (PAT)

• OAuth
• PAT
• GitHub přihlašovací údaje

Azure DevOps Server 2020

Není relevantní

• PAT
• GitHub přihlašovací údaje

Note

podpora integrace GitHub:

• Azure DevOps Services: Integruje se s úložišti GitHub.com i GitHub Enterprise Server prostřednictvím aplikace Azure Boards pro GitHub.
• Azure DevOps Server 2020 a novější: Podporuje integraci pouze s úložišti GitHub Enterprise Server.
• Jiná úložiště Git: Integrace se nepodporuje.

Udělení přístupu k organizaci Azure Boards

Pokud integrace nefunguje podle očekávání, ověřte, že jste organizaci udělili přístup.

1. Na webovém portálu GitHubu otevřete Nastavení z nabídky profilu.
   

2. Vyberte Applications pod Integrations>Authorized OAuth Apps>Azure Boards.

3. V části Přístup k organizaci vyberte Udělit pro jakoukoli organizaci, která zobrazuje žádost o přístup čekající na vyřízení.

   Snímek obrazovky zobrazuje přístup k organizaci včetně organizací, které nemají přístup.

Řešení problémů s přístupem

Když připojení Azure Boards k GitHubu ztratí přístup, zobrazí se v uživatelském rozhraní upozornění s červeným X. Najeďte myší na upozornění, abyste potvrdili, že přihlašovací údaje už nejsou platné. Odeberte připojení a vytvořte nové.

• Připojení OAuth:

  • Přístup ke službě Azure Boards byl odepřen pro jedno z úložišť.

  • GitHub nebo Azure DevOps můžou být nedostupné kvůli výpadku služby nebo problému se sítí. Kontrola stavu: GitHub | Azure DevOps

    Odstraňte a znovu vytvořte připojení. GitHub vás vyzve k opětovnému ověření Azure Boards.

• Připojení PAT:

  • Pat byl odvolán nebo jeho obory oprávnění nejsou dostatečné.

  • Uživatel nemusí mít oprávnění správce v úložišti GitHub.

    Znovu vytvořte PAT s požadovanými obory: repo, read:user, user:email, admin:repo_hook. Další informace najdete v tématu Osvědčené postupy pro používání osobních přístupových tokenů (PATs).

Řešení poškozených připojení k podnikovému serveru GitHub

Pokud jste migrovali z Azure DevOps Serveru do Azure DevOps Services s existujícím připojením k GitHubu Enterprise Serveru, můžou být zmínky o pracovních položkách na GitHubu zpožděné nebo chybějící, protože adresa URL zpětného volání už není platná.

• Odeberte a znovu vytvořte připojení – postupujte podle kroků v tématu Připojení Azure DevOps Services k Serveru GitHub Enterprise.

• Opravte adresu URL webhooku – V nastavení úložiště GitHub aktualizujte adresu URL webhooku tak, aby odkazovala na migrovanou organizaci: https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

Připojení k několika organizacím Azure DevOps

Připojení úložiště GitHub k projektům v několika organizacích Azure DevOps (například dev.azure.com/Contoso a dev.azure.com/Fabrikam) může způsobit neočekávané chování zmínek AB# . ID pracovních položek nejsou v organizacích jedinečná, takže AB#12 by mohla odpovídat pracovní položce v některé z organizací. Obě organizace se mohou pokusit propojit s odpovídajícím ID, což způsobuje nejasnosti.

Pokud se chcete tomuto problému vyhnout, připojte každé úložiště GitHubu jenom k jedné organizaci Azure DevOps.

Note

Aplikace Azure Boards pro GitHub zabraňuje připojení k více organizacím. Pokud je úložiště připojené k nesprávné organizaci, obraťte se na vlastníka organizace, aby připojení před přidáním do správné organizace odebral.

Aktualizace definic XML pro vybrané typy pracovních položek

Pokud vaše organizace používá hostovaný xml nebo místní model procesu XML, aktualizujte definice XML pro typy pracovních položek tak, aby zobrazovaly typy odkazů GitHubu v části Vývoj formulářů pracovních položek.

Pokud například chcete propojit uživatelské scénáře a chyby s potvrzeními GitHubu a žádostmi o přijetí změn z části Vývoj , aktualizujte definice XML pro tyto typy pracovních položek.

Postupujte podle kroků v modelu hostovaného procesu XML. Pro každý typ pracovní položky vyhledejte Group Label="Development" oddíl a přidejte následující řádky, které podporují typy odkazů gitHub Commit a GitHub Pull Request :

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

Po aktualizaci by se oddíl měl zobrazit takto:

<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

Otázka: Někteří moji uživatelé v Azure DevOps mají GitHub identity. Musím je do své organizace přidat jako nové uživatele GitHub?

A: Ne. Požádejte uživatele, aby se odhlasili a pak se znovu přihlásili k organizaci pomocí přihlašovacích údajů GitHubu z nové relace prohlížeče.

Otázka: Jsem správce organizace a povolil(a) jsem zásadu pro pozvání GitHub uživatelů. Proč nemůžu pozvat nové GitHub uživatele?

A: Odhlaste se z Azure DevOps a znovu se přihlaste k organizaci (dev.azure.com/{organizationName} nebo organizationName.visualstudio.com) pomocí přihlašovacích údajů GitHubu z nové relace prohlížeče.

Otázka: Přihlásil(a) jsem se pomocí svých přihlašovacích údajů GitHub, ale proč nemůžu pozvat GitHub uživatele?

A: Nové uživatele můžou pozvat jenom správci organizace nebo projektu. Obraťte se na správce a získejte oprávnění nebo požádejte ho o přidání uživatele.

Otázka: Mají uživatelé GitHub Enterprise bezplatný přístup k Azure DevOps?

A: Další informace najdete v tématu Uživatele a nejčastější dotazy ke správě oprávnění/GitHub Enterprise.

Další krok

Propojte GitHub commity, pull requesty a větve s pracovními položkami

Související obsah

• Instalujte a nakonfigurujte aplikaci Azure Boards pro GitHub
• Konfigurování odznáček stavu pro přidání do GitHub souborů README
• Řešení problémů s integrací GitHub & Azure Boards
• Vytvořit úložiště na GitHubu
• Změnit přístup GitHub k úložišti