Dela via

Installera Azure Boards-appen för GitHub

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

I den här snabbstarten installerar du Azure Boards-appen för GitHub för att ansluta Azure Boards till dina GitHub-lagringsplatser. När du ansluter Azure Boards-projekt med GitHub.com lagringsplatser stöder du länkning mellan GitHub-incheckningar och pull-begäranden till arbetsobjekt. Du kan använda GitHub för programvaruutveckling när du använder Azure Boards för att planera och spåra ditt arbete. När du har installerat Azure Boards-appen för GitHub på ditt GitHub-konto eller din organisation väljer du vilka GitHub-lagringsplatser du vill ansluta till från projektet.

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

Prerequisites

Category Requirements
Permissions – Medlem i projektsamlingsadministratörer grupp. Om du har skapat projektet har du behörighet.
- Administratör eller ägare i GitHub-organisationen för att installera Azure Boards-appen.
- Läs behörigheter för GitHub-lagringsplatsen.
Projektmedlemskap Projektmedlem.

Important

Om lagringsplatsen redan är ansluten med en annan autentiseringstyp, till exempel OAuth, måste du ta bort lagringsplatsen från din befintliga anslutning innan du återansluter den med hjälp av GitHub-appen. Följ stegen i Lägg till eller ta bort GitHub-lagringsplatser senare i den här artikeln innan du konfigurerar GitHub-appen.

Du kan ansluta en Azure DevOps-organisation till flera GitHub-lagringsplatser om du är administratör för dessa lagringsplatser. Du bör inte ansluta en GitHub-lagringsplats till mer än en Azure DevOps-organisation.

Installera och konfigurera Azure Boards-appen

Installationssekvensen kan variera på grund av kontokonfigurationen. Om det behövs följer du anvisningarna på skärmen mellan följande steg.

  1. Gå till Azure Boards-appen på GitHub Marketplace.

  2. Under Abonnemang och priser går du till Kostnadsfritt och väljer Installera.

  3. I Installera och auktorisera Azure Boards väljer du de lagringsplatser som du vill ansluta till Azure Boards och väljer sedan Installera och auktorisera.

    I det här exemplet används Alla lagringsplatser:

    Skärmbild som visar sidan Installera och auktorisera med alla lagringsplatser valda.

  4. Välj det Azure DevOps-organisations- och Azure Boards-projekt som du vill ansluta till GitHub.com.

    Skärmbild som visar sidan Konfigurera ditt Azure Boards-projekt där du väljer en organisation och ett projekt.

    Du kan bara ansluta ett projekt i taget. Om du har andra projekt som du vill ansluta till kan du göra det senare enligt beskrivningen i Konfigurera andra projekt eller lagringsplatser senare i den här artikeln.

Ge Azure Boards-organisationen åtkomst

Utför följande steg om det behövs för att ge GitHub åtkomst till din Azure DevOps-organisation.

  1. Från GitHub-webbportalen öppnar du Inställningar från profilmenyn.

    Skärmbild som visar alternativet Inställningar i din profil.

  2. Välj Program under Integreringar.

  3. Välj Auktoriserade GitHub Apps>Azure Boards.

    Skärmbild som visar auktoriserade GitHub-appar med Azure Boards markerat.

  4. Lös eventuella problem som kan uppstå under Organisationsåtkomst. Välj Bevilja för att bevilja åtkomst till organisationer som visar sig ha en väntande åtkomstbegäran.

    Skärmbild som visar organisationsåtkomst med organisationer utan åtkomst.

Kontrollera åtkomstprincipen för program från tredje part

Se till att din GitHub-organisation tillåter programåtkomst från tredje part för Azure Boards-appen. Om åtkomst från tredje part är begränsad kan tillägg av lagringsplatser från Azure DevOps visa en tom lista eller generera ett fel.

Så här aktiverar du åtkomst:

  1. Öppna din organisation i GitHub och gå till Inställningar > OAuth-apppolicy.

  2. Godkänn Azure Boards-appen specifikt (rekommenderas) eller ta bort begränsningar för alla program från tredje part.

    Skärmbild som visar åtkomstprincipen för program från tredje part.

Anmärkning

Du måste vara organisationsägare eller administratör för att kunna ändra den här inställningen.

Använd anslutningen

Nu är din Azure Boards-GitHub-integrering klar. Du kan hoppa över nästa steg eller gå igenom dem för att förstå vilka funktioner som stöds med anslutningen.

  1. På din tavla väljer du Nytt arbetsobjekt för att ange ett nytt arbetsobjekt med namnet "Lägg till märke i README" – Problem (Grundläggande), Användarhistoria (Agile) eller Produktpost för kvarvarande uppgifter (Scrum) – beroende på vilken processmodell som används av ditt Azure Boards-projekt.

    Ett arbetsobjekt med titeln Lägg till märke i README visas på tavlan.

  2. Öppna ditt arbetsobjekt, gå till avsnittet Utveckling och välj Lägg till länk.

  3. Välj GitHub Pull Request från Länktyp.

  4. Välj lagringsplatsen och ange pull-begärande-ID och en valfri kommentar.

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

    Skärmbild som visar åtgärden Lägg till länk i användarberättelsen, som visar val av lagringsplats och tomma rutor för indata från pull-begärande-ID och valfri kommentar.

    Följande åtgärder sker automatiskt i bakgrunden:

    • Lägger till ett märke i README-filen för den första lagringsplatsen i listan över anslutna GitHub-lagringsplatser.
    • Skapar en GitHub-incheckning för uppdateringen genom att lägga till märket i README-filen.
    • Skapar en GitHub-pullbegäran för att sammanfoga ändringarna i README-filen.
    • Länkar GitHub-inchecknings- och pull-begäran till arbetsobjektet som skapades i steg 1.

  6. Välj den första länken för pull-begäran från ditt arbetsobjekt.

    Skärmbild som visar problemformuläret för pull-begäran som öppnats i GitHub.

    GitHub-pull-begäran öppnas på en ny webbläsarflik.

  7. Välj Koppla pull-begäran.

    Skärmbild som visar exemplet på pull-begäran i GitHub.

  8. Gå till README-filen för lagringsplatsen och visa märket som lades till.

    Skärmbild som visar GitHub-lagringsplatsen med märket tillagt.

    Mer information finns i Lägga till statusmärken för din GitHub-lagringsplats.

Konfigurera andra projekt eller lagringsplatser

Du kan konfigurera andra Azure Boards/Azure DevOps Projects, GitHub.com lagringsplatser eller ändra den aktuella konfigurationen från azure boards-appsidan. Mer information finns i Lägga till eller ta bort lagringsplatser eller ta bort en anslutning från Azure Boards.

Lägga till eller ta bort lagringsplatser eller ta bort en anslutning från Azure Boards

Om du stöter på ett problem med en anslutning rekommenderar vi att du tar bort anslutningen och börjar om med en ny anslutning.

  1. Från ditt projekt i Azure DevOps går du till Projektinställningar>GitHub-anslutningar.

  2. Om du vill lägga till eller ta bort lagringsplatser väljer du ellipserna Fler alternativ för anslutningen och väljer Lägg till lagringsplatser eller Ta bort lagringsplatser på menyn.

    Skärmbild som visar GitHub-anslutningsmenyn med Fler alternativ.

  3. Om du vill ta bort alla lagringsplatser och anslutningen väljer du alternativet Ta bort anslutning . Välj sedan Ta bort för att bekräfta.

    Skärmbild som visar bekräftelseborttagning av GitHub-anslutning.

Ändra åtkomst till lagringsplats

  1. Från GitHub-webbportalen öppnar du Inställningar från profilmenyn.

  2. Välj Integreringsprogram>Program. Under Installerade GitHub-appar väljer du Konfigurera.

    Skärmbild som visar installerade GitHub-appar med Azure Boards och alternativet Konfigurera.

    Konfigurationssidan för Azure Boards öppnas.

  3. Rulla ned till avsnittet Lagringsplatsåtkomst .

  4. Välj önskat alternativ, Alla lagringsplatser eller Välj endast lagringsplatser.

    Om du väljer Välj endast lagringsplatser väljer du de lagringsplatser som du vill delta i integreringen med Azure Boards.

    Skärmbild som visar åtkomsten till lagringsplatsen, där du kan välja valda lagringsplatser.

  5. Välj Spara.

Pausa eller avinstallera Azure Boards-integrering

  1. Från och med steg 2 i föregående procedur rullar du ned till avsnittet Riskzon .

    Skärmbild som visar avsnittet Riskzon med alternativ för att pausa och avinstallera.

  2. Om du vill pausa integreringen väljer du Pausa. I bekräftelsefönstret väljer du OK för att bekräfta avstängningen.

    Skärmbild som visar dialogrutan för bekräftelse av avstängning.

    Om du vill avanvända integreringen väljer du Unsuspend (Ej använd).

  3. Om du vill avinstallera Azure Boards-appen väljer du Avinstallera och väljer sedan OK i popup-bekräftelsefönstret.

    Skärmbild som visar dialogrutan för bekräftelse av avinstallation.

Uppdatera Azure Boards-GitHub-anslutningar

Om du ändrar de lagringsplatser som Azure Boards-appen för GitHub stöder kan du omdirigeras till Azure Boards GitHub-anslutningar. En bra idé är att ta bort lagringsplatserna i Azure Boards som inte längre kan ansluta till GitHub. Mer information finns i Lägga till eller ta bort GitHub-lagringsplatser.

Om du avinstallerar Azure Boards-appen för GitHub visas följande meddelande i Azure Boards, Project Settings>GitHub-anslutningar. Välj Ta bort anslutning för att ta bort alla tidigare gjorda GitHub-anslutningar. Mer information finns i Lägga till eller ta bort GitHub-lagringsplatser.

Skärmbild som visar avinstallerad GitHub-app för Azure Boards.

Nästa steg

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

Relaterat innehåll