Připojení Azure Boards k GitHub (cloud)

Azure DevOps Services

K plánování a sledování práce použijte úložiště GitHub.com pro vývoj softwaru a projekt Azure Boards. Připojte projekt a úložiště, aby vaše GitHub potvrzení a žádosti o přijetí změn byly propojené s pracovními položkami v Azure Boards.

Note

Azure Boards a Azure DevOps Services podporují integraci s úložišti GitHub.com a GitHub Enterprise Server. Pokud se chcete připojit z místního Azure DevOps Server, přečtěte si téma Pojení Azure DevOps Server 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

GitHub Enterprise Server

• 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 rozhodnete připojit GitHub pomocí PAT, nakonfigurujte jednotné přihlašování (SSO) pro PAT ve vašem účtu GitHub. Tato konfigurace je nutná k načtení seznamu úložišť z organizace s povoleným ověřováním jednotného přihlašování SAML (Security Assertion Markup Language).

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. Pokud se z projektu poprvé připojujete, vyberte Připojte svůj účet GitHub pro použití přihlašovacích údajů k účtu GitHub.

   

   V opačném případě zvolte Nové připojení a v dialogovém okně Nové připojení vyberte metodu ověřování.

   Když se připojíte ke svému účtu GitHub, použijte k ověření své GitHub přihlašovací údaje. Pokud chcete použít PAT, podívejte se na Přidání připojení GitHub pomocí PAT. Informace o připojení k GitHub Enterprise Serveru najdete v tématu Register Azure DevOps v GitHub 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. Pokud se k GitHub připojujete z Azure Boards poprvé, přihlaste se pomocí svých přihlašovacích údajů GitHub. Zvolte účet, pro který jste správcem úložiště.

2. Vyberte účet GitHub nebo organizaci, kterou chcete připojit. V seznamu jsou uvedené jenom organizace, které vlastníte nebo které jsou správcem.

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

   

3. Zadejte svoje GitHub přihlašovací údaje. Pokud máte povolené dvoufaktorové ověřování, zadejte ověřovací kód odeslaný GitHub a vyberte Verify. Pokud ne, systém automaticky rozpozná vaši GitHub organizaci, protože váš účet GitHub je přidružený k vašemu účtu Azure DevOps Services.

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

Po ověření můžete vybrat úložiště, která chcete připojit.

1. Dialogové okno Přidat úložiště GitHub automaticky zobrazí a vybere všechna úložiště GitHub.com, pro která jste správcem ve vybrané organizaci. Zrušte výběr všech úložišť, která nechcete zahrnout do integrace.

   

   Tip

   Pokud se chcete vyhnout neočekávaným odkazům na AB#, doporučujeme připojit GitHub úložiště k projektům v rámci jedné organizace Azure DevOps. Připojení stejného úložiště GitHub k projektům ve více Azure DevOps organizacích může způsobit problémy. Další informace najdete v článku Řešení problémů s integrací GitHub & Azure Boards.

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

   

2. Po výběru vyberte Uložit.

Potvrzení připojení

1. Zkontrolujte stránku GitHub, která se zobrazí, a pak zvolte Approve, Install, & Autorizovat

   

2. Zadejte svoje GitHub přihlašovací údaje k potvrzení.

3. Až budete hotovi, měli byste vidět nové připojení s vybranými úložišti.

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.

Pro připojení k úložišti GitHub doporučujeme použít přihlašovací údaje účtu GitHub.

Tip

Při vytváření GitHub PAT nezapomeňte zahrnout tyto obory: repo, read:user, user:email, admin:repo_hook.

1. Zvolte 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. Podle postupů popsaných dříve v tomto článku v části Zvolte úložiště vyberte úložiště, která chcete připojit k projektu.

4. Pokud se z Azure Boards poprvé připojujete k účtu GitHub nebo organizaci, nainstalujte aplikaci Azure Boards pro GitHub. Potvrďte připojení dříve v tomto článku.

Zaregistrujte Azure DevOps v GitHubu jako aplikaci OAuth

Pokud chcete použít OAuth k připojení Azure DevOps s GitHub Enterprise Serverem, nejprve 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 server GitHub Enterprise.

   

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

   

3. Zadejte registrační informace.

   Jako adresu URL domovské stránky zadejte adresu URL organizace vaší organizace.
   Pro adresu URL zpětného volání autorizace použijte následující šablonu k vytvoření adresy URL.

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

   Například:

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

   

4. Vyberte Zaregistrovat aplikaci.

5. Zobrazí se ID klienta a tajný klíč klienta pro 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. Přidejte do organizace konfiguraci GitHub Enterprise Oauth.

3. V Nastavení organizace vyberte konfigurace Oauth>Přidat konfiguraci Oauth.

   

4. Zadejte informace a pak vyberte Vytvořit.

   

Připojení Azure DevOps Services k GitHub Enterprise Serveru

Important

Pokud chcete připojit Azure DevOps Služby k GitHub Enterprise Serveru, ujistěte se, že je váš GitHub Enterprise Server přístupný z internetu. Ověřte, že Azure DNS dokáže přeložit název GitHub Enterprise Server a že brána firewall povoluje přístup z IP adres Azure datacentra. Chcete-li určit rozsah IP adres, podívejte se na Microsoft Azure Data Center IP Ranges. Mezi běžné chybové zprávy pro problémy s připojením patří:

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

Pokud k této chybě dojde, 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í.

   

   Nebo v dialogovém okně Nové připojení k GitHubu vyberte GitHub Enterprise Server.

   

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

   

   Připojení pomocí OAuth

   Zvolte konfiguraci, kterou jste nastavili v Step 4 registrace konfigurace OAuth v Azure DevOps Services a pak zvolte Connect.

   

   Připojení pomocí osobního přístupového tokenu

   Zadejte adresu URL serveru GitHub Enterprise a přihlašovací údaje pro osobní přístupový token rozpoznané tímto serverem. A pak zvolte Připojit.

   

   Pojení pomocí přihlašovacích údajů GitHub

   Zadejte adresu URL serveru GitHub Enterprise a přihlašovací údaje účtu správce rozpoznané tímto serverem a pak vyberte Connect.

   

3. V dialogovém okně jsou uvedena všechna úložiště, pro která máte práva pro správu GitHub. Mezi možnostmi Moje a Vše můžete určit, jestli se zobrazí ostatní, a pak zaškrtnout ty, které chcete přidat. Až budete hotovi, zvolte tlačítko Uložit.

   

   Tip

   Připojení k úložištím definovaným v jedné GitHub organizaci můžete vytvořit pouze. Pokud chcete připojit projekt k jiným úložištím definovaným v jiné GitHub organizaci, musíte přidat další připojení.

4. Pokud se z Azure Boards poprvé připojujete k účtu GitHub nebo organizaci, nainstalujte si také aplikaci Azure Boards pro GitHub. Potvrďte připojení dříve v tomto článku.

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

Integrace Azure Boards-GitHub používá k údržbě připojení různé ověřovací protokoly. Změny oboru oprávnění uživatele nebo přihlašovacích údajů pro ověřování můžou odpojit úložiště GitHub připojená k Azure Boards.

Přehled integrace podporované aplikací Azure Boards pro GitHub najdete v tématu Azure Boards integrace 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

GitHub Enterprise Server

Azure DevOps Services

• 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 mezi Azure Boards a GitHub nefunguje podle očekávání, ověřte, že jste organizaci udělili přístup.

1. Na webovém portálu GitHub otevřete v nabídce profilu Nastavení.
   

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

3. V části Přístup k organizaci vyřešte případné problémy. Výběrem možnosti Udělit udělte přístup všem organizacím, které se zobrazují jako čekající na vyřízení žádosti o přístup.

   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 ke GitHub ztratí přístup, zobrazí se v uživatelském rozhraní stav výstrahy s červeným X. Najeďte myší na výstrahu, abyste viděli, že přihlašovací údaje už nejsou platné. Pokud chcete tento problém vyřešit, odeberte připojení a vytvořte nové.

Pokud chcete tento problém vyřešit, zvažte následující položky:

• Pokud připojení používá OAuth:

  • Aplikace Azure Boards měla pro jedno z úložišť odepřený přístup.

  • GitHub může být nedostupný nebo nepřístupný. Tato nedostupnost může být způsobená výpadkem služby nebo místního problému s infrastrukturou nebo sítí. Stav služby můžete zkontrolovat na následujících odkazech:

    • GitHub
    • Azure DevOps

    Odstraňte a znovu vytvořte připojení k úložišti GitHub. Obnovené připojení způsobí, že GitHub vyzve k opětovnému ověření Azure Boards.

• Pokud připojení používá pat:

  • PAT byl odvolán nebo došlo ke změně požadovaných oborů oprávnění a ty nejsou dostatečné.

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

    Znovu vytvořte token PAT a ujistěte se, že rozsah tokenu zahrnuje požadovaná oprávnění: 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 Server na Azure DevOps Služby s existujícím připojením GitHub Enterprise Server, vaše stávající připojení nemusí fungovat podle očekávání. Zmínky o pracovních položkách v rámci GitHub můžou být zpožděné nebo se v Azure DevOps Services nezobrazí, protože adresa URL zpětného volání přidružená k GitHub už není platná. Zvažte následující řešení:

• Odstranit a znovu vytvořit připojení: Odstraňte a znovu vytvořte připojení k repozitáři na serveru GitHub Enterprise. Postupujte podle posloupnosti kroků uvedených v dokumentaci Připojení z Azure Boards.

• Opravit adresu URL webhooku: Přejděte na stránku nastavení úložiště GitHub a upravte adresu URL webhooku tak, aby směřovala na adresu URL migrované organizace Azure DevOps: https://dev.azure.com/{OrganizationName}/_apis/work/events?api-version=5.2-preview

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

Když připojíte úložiště GitHub k projektům v několika organizacích Azure DevOps, jako jsou dev.azure.com/Contoso a dev.azure.com/Fabrikam, může to způsobit neočekávané výsledky u zmínek AB#. ID pracovních položek nejsou v organizacích Azure DevOps jedinečná, takže AB#12 může odkazovat na pracovní položku ve společnosti Contoso nebo Fabrikam. Když je pracovní položka zmíněna ve zprávě potvrzení nebo žádosti o přijetí změn, obě organizace se mohou pokusit propojit pracovní položku s odpovídajícím ID, což způsobuje nejasnosti.

Abyste se tomuto problému vyhnuli, připojte jedno úložiště GitHub jenom k jedné Azure DevOps organizaci.

Note

Když se připojíte pomocí aplikace Azure Boards pro GitHub, zabrání aplikace připojení k více organizacím. Pokud je úložiště GitHub připojené k nesprávné Azure DevOps organizaci, před přidáním úložiště do Azure DevOps správné organizace se obraťte na vlastníka této organizace a odeberte připojení.

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

Aktualizujte definice XML pro typy pracovních položek, pokud vaše organizace používá hostovaný xml nebo místní model procesu XML k přizpůsobení prostředí sledování práce a propojení a zobrazení typů odkazů GitHub z části Vývoj ve formulářích pracovních položek.

Pokud chcete například propojit uživatelské příběhy a chyby s commity a žádostmi o přijetí změn na GitHubu z oddílu Development, aktualizujte definice XML pro uživatelské příběhy a chyby.

Postupujte podle posloupnosti úloh poskytovaných v modelu hostovaného procesu XML a aktualizujte definice XML. Pro každý typ pracovní položky najděte oddíl Group Label="Development" a přidejte do syntaxe kódu následující dva řádky, které podporují typy externích odkazů: GitHub Commit a GitHub Žádost o přijetí změn.

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

Po aktualizaci by se oddíl měl zobrazit následujícím způsobem.

<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í svých GitHub přihlašovacích údajů z nové relace prohlížeče. Tato akce zakládá jejich GitHub identity.

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: Po změně nastavení se odhlaste z Azure DevOps a pak se znovu přihlaste k organizaci (dev.azure.com/{organizationName} nebo organizationName.visualstudio.com) pomocí přihlašovacích údajů GitHub 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: Pouze správci organizace nebo projektu můžou pozvat nové uživatele, aby se připojili k organizaci. Možná nemáte požadovaná oprávnění k přidání nových uživatelů. Spolupracujte se správcem a získejte potřebná oprávnění nebo požádejte ho o přidání uživatele za vás.

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ší kroky

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

Co můžete dělat s integrací GitHub

Po připojení můžete:

• Použití GitHub Copilot: Použití GitHub Copilot s pracovními položkami pro automatizované generování kódu
• Propojení pracovních položek: Automaticky propojit commity, větve a pull requesty s pracovními položkami
• Track development: Sledujte průběh přímo z Azure Boards