Připojení Azure DevOps Serveru k GitHubu (místně)

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

Požadavky

• Připojte se k úložištím GitHub.com instalací Azure DevOps Serveru 2020.1.1 Patch 2. Bez této opravy se můžete připojit jenom k úložištím GitHub Enterprise Serveru.
• Nainstalujte aplikaci Azure Boards pro GitHub na organizace nebo účet GitHubu.
• Připojte se k projektu Azure Boards nebo Azure DevOps. Pokud projekt ještě nemáte, vytvořte ho.
• Musíte být členem skupiny Správci kolekce projektů a skupiny Přispěvatelé projektu. Pokud jste projekt vytvořili, máte oprávnění.
• Musíte být správcem GitHub Enterprise Serveru, ke kterému se připojujete.

Možnosti ověřování

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

Připojení Azure DevOps Serveru k GitHubu Enterprise Serveru

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.

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

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řipojit.

Připojení pomocí uživatelského jména a hesla

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řipojit.

2. 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 .

   

3. 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 se Azure Boards a Azure DevOps Services integrují s úložišti GitHub.com a GitHub Enterprise Serverem. Azure DevOps Server 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í.

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:

    • GitHub
    • Azure DevOps

    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

Propojení potvrzení GitHubu a žádostí o přijetí změn s pracovními položkami

Související články

• Co je Azure Boards?
• Řešení potíží s integrací GitHubu a Azure Boards
• Vytváření úložišť GitHub Enterprise Serveru