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

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

Požadavky

• Integrace s GitHubem:
  • 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řipojení k projektu: Připojte se k projektu Azure Boards nebo Azure DevOps. Pokud projekt ještě nemáte, vytvořte ho.
• Oprávnění:
  • Buďte členem skupiny Správci kolekce projektů a skupiny Přispěvatelé projektu. Pokud jste projekt vytvořili, máte oprávnění.
  • Buďte 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í přihlašovacích údajů GitHubu

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
• Přihlašovací údaje GitHubu

Azure DevOps Server 2020

Nelze použít

• PAT
• Přihlašovací údaje GitHubu

Azure DevOps Server 2019

Nelze použít

• OAuth
• PAT
• Přihlašovací údaje GitHubu

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 zrušen nebo došlo ke změně požadovaného rozsahu oprávnění, a ten nyní není dostačující.

  • 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. Další informace viz část Osvědčené postupy pro používání PATs.

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

Pokud vaše organizace přizpůsobí sledování práce pomocí hostovaného xml nebo místního modelu procesu XML a chce integrovat typy propojení GitHubu do části Vývoj formulářů pracovních položek, musíte aktualizovat definice XML pro odpovídající 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 v části Vývoj formulářů pracovních položek, musíte aktualizovat definice XML pro tyto typy pracovních položek.

Chcete-li upravit definice XML, proveďte kroky popsané v modelu hostovaného procesu XML. Pro každý typ pracovní položky:

1. Group Label="Development" Vyhledejte oddíl.
2. Pokud chcete podporovat typy externích odkazů, GitHub Commit a GitHub Pull Request, přidejte následující řádky kódu:

Tato integrace umožňuje bezproblémové sledování aktivit GitHubu přímo z pracovních položek v Azure Boards.

             <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

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