Připojení Azure DevOps Serveru na GitHub (místní)

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Když připojíte projekt Azure DevOps Serveru k úložištím GitHub, podporujete propojení mezi potvrzeními GitHubu a žádostmi o přijetí změn s pracovními položkami. GitHub můžete použít k vývoji softwaru při plánování a sledování práce pomocí Azure Boards.

Poznámka:

Místní Azure DevOps Server 2020 podporuje integraci s úložišti GitHub.com a GitHub Enterprise Server. Pokud se chcete připojit z Azure DevOps Services, přečtěte si Připojení Azure Boards k GitHubu.

Když propojíte projekt Azure DevOps Serveru s úložišti GitHub Enterprise Serveru, podporujete propojení mezi potvrzeními GitHubu a žádostmi o přijetí změn s pracovními položkami. GitHub Enterprise můžete použít k vývoji softwaru při plánování a sledování práce pomocí Azure Boards.

Poznámka:

Místní Azure DevOps Server 2019 podporuje integraci s úložišti GitHub Enterprise Serveru. Pokud se chcete připojit z Azure DevOps Services, přečtěte si Připojení Azure Boards k GitHubu.

Požadavky

Možnosti ověřování

Podporují se následující možnosti ověřování.

Poznámka:

OAuth se nepodporuje pro Azure DevOps Server 2020.

Registrace Azure DevOps na GitHubu jako aplikace OAuth

Pokud plánujete použít OAuth k připojení Azure DevOps Serveru s GitHub Enterprise Serverem, musíte nejdřív aplikaci zaregistrovat jako aplikaci OAuth. Další informace najdete v tématu Vytvoření aplikace OAuth.

Registrace Azure DevOps Serveru

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

    Screenshot of sign in for GitHub Enterprise Server.

  2. Vyberte Nastavení> Developer settings>Oauth Apps>New OAuth App.

    Screenshot showing sequence for getting to New OAuth App screen.

  3. Zadejte informace pro registraci aplikace Azure DevOps Serveru.

    Screenshot of Azure DevOps Server project registration.

    Jako adresu URL domovské stránky zadejte veřejnou adresu URL kolekce projektů. Tuto adresu URL najdete při otevření konzoly Azure DevOps Správa istrace a zobrazení uzlu aplikační vrstvy.

    Screenshot of Azure DevOps Server Administration Console, Application Tier.

    Pro adresu URL zpětného volání autorizace použijte následující vzor k vytvoření adresy URL.

    {Azure DevOps Server Public Url}/{Collection Name}/_admin/oauth2/callback

    Příklad:

    http://contoso/DefaultCollection/_admin/oauth2/callback

    https://tfs.contoso.com/MyCollection/_admin/oauth2/callback

  4. Vyberte Zaregistrovat aplikaci.

  5. Zobrazí se stránka, která poskytuje ID klienta a tajný klíč klienta pro vaši zaregistrovanou aplikaci OAuth.

    Screenshot of Client ID and Client Secret for your registered OAuth application.

Registrace konfigurace OAuth na Azure DevOps Serveru

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

  2. Přidejte do kolekce Azure DevOps Serveru konfiguraci GitHub Enterprise OAuth.

  3. Vyberte Správa nastavení>konfigurace>Oauth Přidat konfiguraci Oauth.

    Screenshot showing step sequence to add OAuth configuration.

  4. Zadejte informace a pak vyberte Vytvořit.

    Screenshot of OAuth configuration dialog.

Připojení Azure DevOps Serveru na GitHub Enterprise Server

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

Poznámka:

Připojení do více než 100 úložišť GitHub vyžaduje aktualizaci Azure DevOps Server 2020.1 nebo novější.
Připojení pro úložiště GitHub.com vyžaduje Azure DevOps Server 2020.1.1 Patch 2 nebo novější verzi.

K projektu Azure Boards můžete připojit až 100 úložišť GitHub. Tento limit není možné změnit.

  1. Otevřete webový portál pro Azure DevOps Server.

  2. Výběrem loga Azure DevOps otevřete projekty a pak zvolte projekt Azure Boards, který chcete nakonfigurovat pro připojení k úložištím GitHub Enterprise.

  1. Vyberte připojení GitHubu v nastavení>projektu.

    Screenshot of open Project Settings>GitHub connections.

  2. Pokud připojení z projektu vytváříte poprvé, zvolte metodu ověřování, kterou chcete použít k vytvoření připojení:

    Screenshot of first time connecting with GitHub credentials.

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

  1. Vyberte připojení> GitHubu k nastavení>projektu Připojení účtu GitHub Enterprise.

    Screenshot of Project settings, selected Integrations.

    Pokud používáte tyto přihlašovací údaje, zvolte osobní přístupový token nebo uživatelské jméno a heslo.

Připojení s OAuth

Zvolte konfiguraci, kterou jste nastavili v kroku 4 registrace konfigurace OAuth na Azure DevOps Serveru. Pak vyberte Připojení.

Screenshot fo New GitHub Enterprise connection, OAuth dialog.

Připojení s osobním přístupovým tokenem

  1. Pokud chcete vytvořit token PAT, přečtěte si téma Vytvoření tokenu PAT.

    Tip

    Při vytváření pat GitHubu se ujistěte, že zahrnujete tyto obory: repo, admin:repo_hook, read:user, user:email.

  2. Zadejte adresu URL vašeho serveru GitHub Enterprise a přihlašovací údaje tokenu pat, které tento server rozpozná. A pak vyberte Připojení.

Screenshot of sign in with PAT.

Připojení s uživatelským jménem a heslem

  1. Zadejte adresu URL vašeho serveru GitHub Enterprise a přihlašovací údaje účtu správce rozpoznané tímto serverem. A pak zvolte Připojení.

Screenshot of sign in with username and password.

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

    Screenshot of repositories to select to add.

  2. Pokud se chcete poprvé připojit k účtu Nebo organizaci GitHubu z Azure Boards, nainstalujte si také aplikaci Azure Boards pro GitHub. Dokončete integraci podle postupů popsaných v části Potvrzení připojení.

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

Integrace Azure Boards-GitHubu spoléhá na různé ověřovací protokoly pro podporu připojení. Změny oboru oprávnění uživatele nebo přihlašovacích údajů pro ověřování můžou způsobit odvolání úložišť GitHub připojených k Azure Boards.

Přehled integrace, kterou aplikace Azure Boards pro GitHub podporuje, najdete v tématu Integrace Azure Boards-GitHub.

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

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

Platforma

GitHub.com

GitHub Enterprise Server

Služby Azure DevOps

  • GitHub.com uživatelský účet
  • Token PAT (Personal Access Token)
  • OAuth
  • PAT
  • Uživatelské jméno a heslo

Azure DevOps Server 2020

Nelze použít

  • PAT
  • Uživatelské jméno a heslo

Azure DevOps Server 2019

Nelze použít

  • OAuth
  • PAT
  • Uživatelské jméno a heslo

Poznámka:

S aplikací Azure Boards pro GitHub, Azure Boards a Azure DevOps Services podporují integraci s úložišti GitHub.com a GitHub Enterprise Serverem. Azure DevOps Servers 2019 a novější verze podporují integraci pouze s úložišti GitHub Enterprise Serveru. Integrace s jinými úložišti Git se nepodporuje.

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

Když už připojení Azure Boards k GitHubu nemá přístup, zobrazí se v uživatelském rozhraní stav upozornění s červeným X. Najeďte myší na výstrahu a značí, že přihlašovací údaje už nejsou platné. Problém opravíte tak, že odeberete připojení a znovu vytvoříte nové připojení.

Screenshot of failed connection.

Pokud už připojení Azure Boards k GitHubu nemá přístup, zobrazí se v uživatelském rozhraní stav upozornění s červeným X, který obsahuje popis, například Nejde se připojit k GitHubu.

Zvažte následující řešení:

  • 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 nedostupný. 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:

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

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

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

    • Uživatel možná ztratil 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.

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

Pokud vaše organizace používá hostovaný model procesu XML nebo místní model procesu XML k přizpůsobení prostředí pro sledování práce a chcete propojit a zobrazit typy odkazů GitHubu z části Vývoj ve formulářích pracovních položek, musíte aktualizovat definice XML pro typy 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 , musíte aktualizovat definice XML pro uživatelské scénáře 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 Group Label="Development" oddíl a do následující syntaxe kódu přidejte následující dva řádky, které podporují typy externích odkazů: GitHub Commit a GitHub Pull Request.

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

Když se aktualizuje, měl by se oddí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>  

Další kroky