Anslut Azure DevOps Server till GitHub (lokalt)

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

Förutsättningar

• 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.
• Anslut till ett Azure Boards- eller Azure DevOps-projekt. Om du inte har något projekt än skapar du ett.
• Du måste vara medlem i gruppen Projektsamlingsadministratörer och projektets deltagargrupp. Om du har skapat projektet har du behörighet.
• Du måste vara administratör för den GitHub Enterprise-server som du ansluter till.

Autentiseringsalternativ

Följande autentiseringsalternativ stöds.

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

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

Anslut med användarnamn och lösenord

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.

Plattform

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

• GitHub.com användarkonto
• Personlig åtkomsttoken (PAT)

• OAuth
• PAT
• Användarnamn plus lösenord

Azure DevOps Server 2020

Inte tillämpligt

• PAT
• Användarnamn plus lösenord

Azure DevOps Server 2019

Inte tillämpligt

• OAuth
• PAT
• Användarnamn plus lösenord

Kommentar

Med Azure Boards-appen för GitHub stöder Azure Boards och Azure DevOps Services integrering med GitHub.com- och GitHub Enterprise Server-lagringsplatser. Azure DevOps Servers 2019 och senare versioner stöder endast integrering med GitHub Enterprise Server-lagringsplatser. Integrering med andra Git-lagringsplatser stöds inte.

Lösa åtkomstproblem

När Azure Boards-anslutningen till GitHub inte längre har åtkomst visas en aviseringsstatus i användargränssnittet med en red-X. Hovra över aviseringen och det anger att autentiseringsuppgifterna inte längre är giltiga. Åtgärda problemet genom att ta bort anslutningen och återskapa en ny anslutning.

Ö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 kan ha återkallats eller de behörighetsomfång som krävs har ändrats och är otillräckliga.

  • Användaren kan ha förlorat administratörsbehö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.

Uppdatera XML-definitioner för utvalda typer av arbetsobjekt

Om din organisation använder den värdbaserade XML-koden eller den lokala XML-processmodellen för att anpassa arbetsspårningsmiljön, och du vill länka till och visa GitHub-länktyperna från avsnittet Utveckling i arbetsobjektsformulären, måste du uppdatera XML-definitionerna för arbetsobjekttyperna.

Om du till exempel vill länka användarberättelser och buggar till GitHub checkar in och hämtar begäranden från avsnittet Utveckling måste du uppdatera XML-definitionerna för användarberättelser och buggar.

Följ sekvensen med uppgifter som tillhandahålls i värdbaserad XML-processmodell för att uppdatera XML-definitionerna. För varje typ av arbetsobjekt letar du upp Group Label="Development" avsnittet och lägger till följande två rader i följande kodsyntax för att stödja de externa länktyperna: GitHub Commit och GitHub Pull Request.

             <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

Länka GitHub-incheckningar och pull-begäranden till arbetsobjekt

Relaterade artiklar

• Vad är Azure Boards?
• Felsöka Integrering av GitHub och Azure Boards
• Skapa GitHub Enterprise Server-lagringsplatser