Ansluta Azure DevOps Server till GitHub (lokalt)

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

Förutsättningar

Kategori	Krav
Behörigheter	- Medlem i gruppen projektsamlingadministratörer och gruppen projektdeltagare. Om du har skapat projektet har du behörighet. - Administratör för den GitHub Enterprise-server som du ansluter till.
Projektmedlemskap	Medlem i projektet.
integrering med GitHub	– Azure DevOps Server 2020.1.1 Patch 2. Utan den här korrigeringen kan du bara ansluta till dina GitHub Enterprise Server-lagringsplatser. - Azure Boards-appen för GitHub installerad i GitHub-organisationer eller på ett konto.

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.

   Tips

   När du skapar din GitHub PAT ska du se till att inkludera 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.

Plattform

GitHub.com

GitHub Enterprise Server

Azure DevOps Services

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

• OAuth
• KLAPPA
• GitHub-autentiseringsuppgifter

Azure DevOps Server 2020

Inte tillämpligt

• KLAPPA
• GitHub-autentiseringsuppgifter

Azure DevOps Server 2019

Inte tillämpligt

• OAuth
• KLAPPA
• GitHub-autentiseringsuppgifter

Anteckning

Med Azure Boards-appen för GitHub integrerar Azure Boards och Azure DevOps Services med GitHub.com- och GitHub Enterprise Server-lagringsplatser. Azure DevOps Server 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 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. Hitta 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

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

Relaterade artiklar

• Läs mer om Azure Boards
• Felsöka Integrering av GitHub och Azure Boards
• Skapa GitHub Enterprise Server-lagringsplatser