Dela via

Länka GitHub-incheckningar, pull-begäranden, grenar och problem till arbetsobjekt i Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

I den här artikeln får du lära dig hur du länkar arbetsobjekt till GitHub-incheckningar, pull-begäranden, grenar och byggen när du har anslutit ditt Azure Boards-projekt till en GitHub-lagringsplats. Du kan använda #mention-syntax för commits och grenar, använda !-omnämnanden för att referera till GitHub-pull requests från arbetsobjektdiskussioner, eller lägga till en GitHub-commit, pull request eller grenlänk direkt från arbetsobjektet i Azure Boards.

Note

Stöd för GitHub-integrering:

  • Azure DevOps Services: Integreras med både GitHub.com- och GitHub Enterprise Server-lagringsplatser via Azure Boards-appen för GitHub.
  • Azure DevOps Server 2020 och senare: Stöder endast integrering med GitHub Enterprise Server-lagringsplatser.
  • Andra Git-lagringsplatser: Integrering stöds inte.

Prerequisites

Category Requirements
Permissions Deltagare i både Azure Boards-projektet och GitHub-lagringsplatsen.
Projektanslutning Azure Boards-projektet är kopplat till GitHub-repositoryt där de commit, pull-begäranden och branch som du vill länka till eller från finns. Mer information finns i Azure Boards-GitHub-integrering.

Note

För att visa avsnittet Utveckling och GitHub-länktyper kräver projekt som använder den värdbaserade XML-processmodellen uppdateringar av arbetsobjektstyperna. Mer information finns i Uppdatera XML-definitioner för utvalda typer av arbetsobjekt.

Från en GitHub-incheckning, pull-begäran eller ett problem använder du följande syntax för att skapa en länk till ditt Azure Boards-arbetsobjekt. Ange AB#ID i texten i ett commitmeddelande. Eller för en pull request eller en fråga anger du AB#ID i beskrivningen. Att använda AB#ID i en kommentar eller pull request-titel skapar inte en länk till arbetsobjekt.

AB#{ID}

Till exempel AB#125 länkar till arbetsobjekts-ID 125.

Du kan också ange ett commit- eller pull request-meddelande för att ändra status på arbetsobjektet. Systemet känner igen {state} eller {state category}, tillsammans med fix, fixes, fixedoch tillämpar det på det #-mention-objekt som följer.

När en beskrivning av pull-begäran innehåller ett giltigt tillståndsnamn Closed AB#1234, till exempel , uppdaterar systemet det refererade arbetsobjektet till det specifika tillståndet. Om tillståndsnamnet inte känns igen direkt försöker Azure Boards matcha det med en arbetsflödeskategori som Resolved eller Completed. Om en matchning hittas övergår arbetsobjektet till det första tillgängliga tillstånd som definierats under den kategorin.

Arbetsobjekt som refereras till med fix, fixeseller fixed övergår som standard till det första tillstånd som är associerat med kategorin Löst. Om det inte finns något sådant tillstånd i den aktuella processen övergår systemet i stället arbetsobjektet till det första tillståndet i kategorin Slutförd .

Important

Du kan fortfarande länka arbetsobjekt och rikta in dig mot andra grenar, men regler för statusövergångar gäller inte om inte pull-begäran slås samman till standardgrenen.

Mer information finns i Hur arbetsflödeskategoritillstånd används i Azure Boards backloggar och tavlor (How workflow category states are used in Azure Boards backlogs and boards).

Granska följande tabell med exempel:

Meddelande för commit eller pull-begäran Action
Fixed AB#123 Länkar och övergår arbetsobjektet till kategorin Löst arbetsflödestillstånd eller, om inget har definierats, kategorin Status för slutfört arbetsflöde.
Closed AB#123 Länkar och överför arbetsobjektet till tillståndet Stängt arbetsflöde. Om ingen definieras görs inga övergångar.
Adds a new feature, fixes AB#123. Länkar och övergår arbetsobjektet till kategorin Löst arbetsflödestillstånd eller, om inget har definierats, kategorin Status för slutfört arbetsflöde.
Fixes AB#123, AB#124, and AB#126 Länkar till Arbetsobjekten 123, 124 och 126 i Azure Boards. Övergår endast det första objektet, 123 till kategorin Löst arbetsflödestillstånd eller, om inget har definierats, sedan kategorin Slutfört arbetsflödestillstånd .
Fixes AB#123, Fixes AB#124, Fixes AB#125 Länkar till Arbetsobjekten 123, 124 och 126 i Azure Boards. Övergår alla objekt till antingen kategorin Löst arbetsflödestillstånd eller, om inget har definierats, statuskategorin Slutfört arbetsflöde.
Fixing multiple bugs: issue #123 and user story AB#234 Länkar till GitHub-ärende 123 och Azure Boards-arbetsobjekt 234. Inga övergångar görs.

Note

Om du har anslutit samma GitHub-lagringsplats till projekt som definierats i två eller flera Azure DevOps-organisationer kan du se oväntade AB# -omnämnandelänkar. Mer information finns i Lösa anslutningsproblem. Därför rekommenderar vi att du endast ansluter en GitHub-lagringsplats till projekt som definierats i en enda Azure DevOps-organisation.

När du lägger till en länk till ett arbetsobjekt med en AB# beskrivning av pull-begäran visas länkarna i avsnittet Utveckling i GitHub-pullbegäran. Dessa länkar är endast tillgängliga när du använder AB# i beskrivningen av pull-begäran. De visas inte om du länkar till pull-begäran direkt från arbetsobjektet. Om du tar bort referensen AB# från beskrivningen tas den också bort från avsnittet Utveckling.

Skärmbild av AB#-länkar i utvecklingsavsnittet i GitHub-pull-begäran.

Skapa GitHub-gren från arbetsobjekt

Använd följande steg för att skapa en GitHub-gren direkt från ett arbetsobjekt:

  1. Leta reda på det arbetsobjekt som du vill använda för att skapa en GitHub-gren från ditt bräde.

  2. Välj Åtgärder för arbetsobjekt>Ny GitHub-gren.

    Skärmbild av arbetsobjekt Fler åtgärder väljer och markerar alternativet Ny GitHub-gren.

  3. I dialogfönstret Skapa en GitHub-gren anger du branches namn. Välj GitHub-lagringsplatsen och basgrenen.

  4. Välj Skapa.

    Skärmbild av dialogrutan Skapa en GitHub Branch.

    Azure Boards skapar grenen på den angivna GitHub-lagringsplatsen och länkar den till arbetsobjektet. Mer information finns i Azure Boards-GitHub-integrering.

  1. Öppna arbetsobjektet och gå till området Utveckling .

  2. Välj Lägg till länk. I varje listruta väljer du din länktyp, GitHub-lagringsplats och GitHub-pullbegäran. Du kan söka och tränga in mer detaljerat i förrådet för att hitta och välja en specifik pull-begäran eller commit, utan att behöva kopiera och klistra in URL:ar.

  3. Välj Lägg till länk.

    Skärmbild som visar femstegssekvens för att lägga till en länk för pull-begäran till arbetsobjektet.

    Azure Boards kontrollerar att du har angett en giltig länk. Den länkade GitHub-lagringsplatsen måste vara ansluten till Azure Boards-projektet eller så misslyckas verifieringen.

Note

Om du använder Azure DevOps Server och GitHub Enterprise Server finns det en fördröjning när AB#-länkarna slutförs. Processen använder en "push-and-pull"-design för att hämta från GitHub-händelserna varje timme vid inkrementella ändringar i Commit, PR och Issue.

Flera händelser uppdaterar automatiskt länkarna i arbetsobjektformuläret, så du behöver inte skapa dem manuellt. Dessa händelser omfattar:

GitHub-händelse Action
Länk till gren När en pull-begäran skapas från en gren länkar den automatiskt till arbetsobjektet.
Sammanfognings-commit När pull-begäran har slagits samman, länkar det resulterande sammanslagningsåtagandet automatiskt till arbetsobjektet.
Ta bort gren Om grenen tas bort (vanligtvis efter sammanslagning) tas länken bort automatiskt från arbetsobjektet.

I avsnittet Utveckling i arbetsobjektsformuläret visas länkarna som skapats till GitHub-commits och pull-begäranden med hjälp av GitHub-ikonen.

Skärmbild av arbetsobjektsformuläret, avsnittet Utveckling visar GitHub-länkar.

Välj länken för att öppna commit- eller pull request i GitHub.

Insikter om GitHub-pullbegäran

Länkade GitHub-pull-begäranden i avsnittet Utveckling visar extra statusinformation, så att du kan utvärdera förloppet utan att öppna pull-begäran i GitHub.

Förutsättningar för pull request-insikter

Om du vill se insikter om pull-begäranden går du till Azure Boards-appen i GitHub och godkänner de uppdaterade behörigheterna för läs- och skrivåtkomst till Checkar.

Skärmbild av dialogrutan GitHub-appbehörigheter i Azure Boards som visar uppdaterade behörigheter för Checks.

Visa statusinformation för pull-begäran

  1. Öppna ett arbetsobjekt som har en länkad GitHub-pull-begäran.

  2. I avsnittet Utveckling hittar du den länkade pull-begäran. Följande statusinformation visas bredvid länken för pull-begäran:

    • Utkaststatus: Visar om pull-begäran fortfarande är ett utkast.
    • Granskningsstatus: Visar om pull-begäran behöver granskas, har godkänts eller om ändringar har begärts.
    • Kontrollstatus: Visar om CI-kontroller är godkända, underkända eller i väntan.

    Skärmbild av avsnittet Utveckling som visar en länkad GitHub pull request med indikatorer för stängd, granskning och statuskontroller.

  3. Hovra över en statusindikator om du vill se mer information eller välj länken för pull-begäran för att öppna den direkt i GitHub.

Nämn GitHub-pull-begäranden med hjälp av !

Använd ! omnämnanden för att referera till och diskutera GitHub-pull-begäran direkt från något rikt-textfält för arbetsobjekt eller diskussionskommentar. När du skriver ! i ett textfält visas en väljare som du kan använda för att söka efter och välja en GitHub-pull-begäran från en ansluten lagringsplats. Den valda pull-begäran infogas som en klickbar länk.

Den här funktionen gör det enkelt att referera till relaterade pull-begäranden i beskrivningar av arbetsobjekt, godkännandekriterier eller diskussionstrådar utan att kopiera URL:er manuellt.

GIF som visar hur du använder ett !-omnämnande för att referera till en 'pull request' från GitHub i en diskussion om ett arbetsobjekt.

Visa byggstatus för YAML-pipelines (integrerad i build)

När du använder Azure Pipelines YAML för att skapa kod som finns på en GitHub-lagringsplats kan du automatiskt skapa integrerade bygglänkar på associerade arbetsobjekt. Den här funktionen ger byggspårning för GitHub-lagringsplatser, vilket ger paritet med den upplevelse som är tillgänglig för Azure Repos.

Så aktiverar du funktionen:

  1. Öppna YAML-pipelinen, välj Fler åtgärder och välj sedan Inställningar.

  2. I dialogrutan Pipelineinställningar aktiverar du Länka automatiskt nya arbetsobjekt i den här versionen.

    Skärmbild av dialogrutan FÖR YAML-pipelineinställningar som visar alternativet Länka nya arbetsobjekt automatiskt i det här byggalternativet.

När bygget är klart visas en integrerad länk i bygget automatiskt i avsnittet Utveckling för varje associerat arbetsobjekt, vilket ger ditt team fullständig spårbarhet från arbetsobjekt till bygge.

Skärmbild av arbetsobjektet som visar länken Integrerad i build i avsnittet Utveckling.

Mer information om hur du konfigurerar den här inställningen finns i Konfigurera pipelines för att stödja arbetsspårning.

Visa GitHub-objekt på en tavla

Genom att aktivera GitHub-anmärkningar på tavlan kan du snabbt öppna länkade GitHub-commits, pull requests eller ärenden för mer information. Mer information finns i Anpassa kort.

Skärmbild av bräde som visar GitHub-länkar på arbetsobjektkort.

Nästa steg

Konfigurera statusmärken

Relaterat innehåll

  • Last updated on