Ansluta Azure DevOps Server till GitHub (lokalt)

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

Förutsättningar

• Integrering med GitHub:
  • Anslut till GitHub.com lagringsplatser genom att installera Azure DevOps Server 2020.1.1 Patch 2. Utan den här korrigeringen kan du bara ansluta till dina GitHub Enterprise Server-lagringsplatser.
  • Installera Azure Boards-appen för GitHub på GitHub-organisationer eller -kontot.
• Projektanslutning: Anslut till ett Azure Boards- eller Azure DevOps-projekt. Om du inte har något projekt än skapar du ett.
• Behörigheter:
  • Var medlem i gruppen Projektsamlingsadministratörer och projektets deltagargrupp. Om du har skapat projektet har du behörighet.
  • Vara administratör för den GitHub Enterprise-server som du ansluter till.

Autentiseringsalternativ

Följande autentiseringsalternativ stöds.

Ansluta Azure DevOps Server till GitHub Enterprise Server

1. Öppna webbportalen för din Azure DevOps Server.

2. Välj Azure DevOps-logotypen för att öppna Projekt och välj sedan det Azure Boards-projekt som du vill konfigurera för att ansluta till dina GitHub Enterprise-lagringsplatser.

Ansluta med en personlig åtkomsttoken

1. Information om hur du skapar en PAT finns i Skapa en personlig åtkomsttoken.

   Dricks

   När du skapar din GitHub PAT kontrollerar du att du inkluderar dessa omfång: repo, admin:repo_hook, read:user, user:email.

2. Ange URL:en för din GitHub Enterprise-server och autentiseringsuppgifterna för personlig åtkomsttoken som identifieras av servern. Välj sedan Anslut.

Ansluta med GitHub-autentiseringsuppgifter

1. Ange URL:en för din GitHub Enterprise-server och autentiseringsuppgifterna för administratörskontot som identifieras av servern. Välj sedan Anslut.

2. I dialogrutan visas alla lagringsplatser som du har GitHub-administrationsbehörighet för. Du kan växla mellan Min och Alla för att avgöra om andra visas och sedan kontrollera de som du vill lägga till. Välj Spara när du är klar.

   

3. Om du vill ansluta till ett GitHub-konto eller en organisation från Azure Boards för första gången installerar du även Azure Boards-appen för GitHub. Slutför integreringen genom att följa de procedurer som beskrivs i Bekräfta anslutningen.

Lös anslutningsproblem

Azure Boards-GitHub-integreringen förlitar sig på olika autentiseringsprotokoll för att stödja anslutningen. Ändringar i en användares behörighetsomfång eller autentiseringsuppgifter kan orsaka återkallande av GitHub-lagringsplatser som är anslutna till Azure Boards.

En översikt över den integrering som Azure Boards-appen för GitHub stöder finns i Azure Boards-GitHub-integrering.

Autentiseringsalternativ som stöds

Följande autentiseringsalternativ stöds baserat på den GitHub-plattform som du vill ansluta till.

Lösa åtkomstproblem

Överväg följande lösningar:

• Om anslutningen använder OAuth:

  • Azure Boards-programmet fick åtkomst nekad för en av lagringsplatserna.

  • GitHub kan vara otillgängligt/oåtkomligt. Den här otillgängligheten kan bero på ett avbrott i antingen tjänsten eller ett infrastruktur-/nätverksproblem lokalt. Du kan kontrollera tjänststatus från följande länkar:

    • GitHub
    • Azure DevOps

    Ta bort och återskapa anslutningen till GitHub-lagringsplatsen. Den här återskapade anslutningen gör att GitHub uppmanas att auktorisera Azure Boards igen.

• Om anslutningen använder en PAT:

  • PAT har återkallats eller de behörighetsomfång som krävs har ändrats och är otillräckliga.

  • Användaren kanske förlorade administrativa behörigheter på GitHub-lagringsplatsen.

    Återskapa PAT och se till att omfånget för token innehåller de behörigheter som krävs: repo, read:user, user:email, admin:repo_hook. Mer information finns i Metodtips för att använda PAT:er.

Uppdatera XML-definitioner för utvalda typer av arbetsobjekt

Om din organisation anpassar arbetsspårning med hjälp av den värdbaserade XML- eller lokala XML-processmodellen och vill integrera GitHub-länktyper i avsnittet Utveckling i arbetsobjektformulär, måste du uppdatera XML-definitionerna för motsvarande typer av arbetsobjekt.

Om du till exempel vill länka användarberättelser och buggar till GitHub-incheckningar och pull-begäranden i avsnittet Utveckling i arbetsobjektformulär måste du uppdatera XML-definitionerna för dessa typer av arbetsobjekt.

Om du vill ändra XML-definitionerna utför du stegen som beskrivs i en värdbaserad XML-processmodell. För varje typ av arbetsobjekt:

1. Leta upp avsnittet Group Label="Development" .
2. Lägg till följande kodrader för att stödja de externa länktyperna GitHub Commit och GitHub Pull Request:

Den här integreringen möjliggör sömlös spårning av GitHub-aktiviteter direkt från dina arbetsobjekt i Azure Boards.

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

När den uppdateras bör avsnittet visas på följande sätt.

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

Nästa steg

Relaterade artiklar

• Lär du dig mer om Azure Boards?
• Felsöka Integrering av GitHub och Azure Boards
• Skapa GitHub Enterprise Server-lagringsplatser