Installera Azure-tavlor-appen för GitHub

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

I den här snabbstarten installerar du Azure-tavlor-appen för GitHub för att ansluta Azure-tavlor till dina GitHub lagringsplatser. När du ansluter Azure-tavlor 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-tavlor för att planera och spåra ditt arbete. När du har installerat Azure-tavlor-appen för GitHub på ditt GitHub konto eller din organisation väljer du vilka GitHub lagringsplatser som du vill ansluta till från projektet.

En översikt över integreringen som Azure-tavlor-appen för GitHub stöder finns i Azure-tavlor-GitHub integration.

Prerequisites

Behörighetskategori Requirements
Azure DevOps – Medlem i projektsamlingsadministratörer grupp. Om du har skapat projektet har du den här behörigheten.
- Projektmedlem i Azure-tavlor-projektet.
GitHub - Administratör eller ägare av GitHub organisation för att installera Azure-tavlor-appen
- Läsbehörigheter för GitHub-lagringsplatsen

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 ansluter den igen med hjälp av GitHub App. Följ stegen i Lägg till eller ta bort GitHub lagringsplatser senare i den här artikeln innan du konfigurerar GitHub App.
  • 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-tavlor-appen

Följande steg visar en typisk installationssekvens. Slutför konfigurationen genom att följa anvisningarna på skärmen.

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

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

  3. I Installera & Auktorisera Azure-tavlor, välj de lagringsplatser som du vill ansluta till Azure-tavlor och välj sedan Installera & 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 den Azure DevOps organisation och Azure-tavlor projekt som du vill ansluta till GitHub.com.

    Screenshot visar sidan Konfigurera ditt Azure-tavlor projekt där du väljer en organisation och ett projekt.

    Du kan bara ansluta ett projekt i taget. Om du vill ansluta andra projekt kan du läsa Konfigurera andra projekt eller lagringsplatser.

Bevilja åtkomst till Azure-tavlor-organisationen

Utför följande steg för att ge GitHub åtkomst till din Azure DevOps organisation.

  1. Öppna Settings från profilmenyn från GitHub webbportalen.

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

  2. Välj Program under Integreringar.

  3. Välj Authorized GitHub Apps>Azure-tavlor.

    Screenshot visar auktoriserade GitHub appar med Azure-tavlor 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-tavlor-appen. Om åtkomst från tredje part är begränsad kan det hända att lagrings­platser från Azure DevOps visar en tom lista eller ger ett felmeddelande.

Så här aktiverar du åtkomst:

  1. I GitHub öppnar du din organisation och går du till Inställningar>princip för OAuth-appar.

  2. Godkänn Azure-tavlor 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.

När du har konfigurerat din Azure-tavlor-GitHub-integrering kan du länka dina arbetsobjekt till GitHub pull-begäranden och incheckningar.

I följande exempel visas integreringen genom att skapa ett arbetsobjekt och länka det till en pull-begäran:

  1. På tavlan väljer du Nytt arbetsobjekt för att skapa ett arbetsobjekt. I det här exemplet använder du rubriken "Lägg till märke i README". Arbetsobjektstypen beror på din process: Ärende (Basic), Användarberättelse (Agile) eller Produktbacklogobjekt (Scrum).

    Det nya arbetsobjektet visas på tavlan.

  2. Öppna arbetsobjektet och gå till avsnittet Utveckling .

  3. Välj Lägg till länk och välj sedan GitHub pull-begäran från menyn Länktyp.

  4. Välj lagringsplatsen och ange pull-begärande-ID:t. Du kan också lägga till en valfri kommentar.

  5. Välj Lägg till länk för att skapa anslutningen.

    Azure-tavlor utför automatiskt följande åtgärder 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-commit för uppdatering av märket
    • Skapar en GitHub pull-begäran för att sammanfoga ändringarna i README-filen
    • Länkar GitHub-commit och pull request till ditt arbetsobjekt

  6. I arbetsobjektet väljer du länken för pull-begäran för att öppna den i GitHub.

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

  8. I din GitHub-lagringsplats öppnar du README-filen för att verifiera att märket har lagts till. Mer information finns i Konfigurera statusmärken att lägga till i GitHub README-filer.

Konfigurera andra projekt eller lagringsplatser

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

Lägg till eller ta bort lagringsplatser eller ta bort en anslutning från Azure-tavlor

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

  1. Från project i Azure DevOps väljer du Project instä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.

    Screenshot visar GitHub-anslutningsmenyn i 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ärmdumpen visar borttagningen av bekräftelsen på GitHub-anslutningen.

Ändra åtkomst till lagringsplats

  1. Öppna Settings från profilmenyn från GitHub webbportalen.

  2. Välj Integreringsprogram>Program. Under Installerad GitHub Apps väljer du Configure.

    Screenshot visar Installerade GitHub-appar med Azure-tavlor och alternativet Konfigurera.

    Konfigurationssidan Azure-tavlor ö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 bara lagringsplatser väljer du de lagringsplatser som du vill delta i integreringen med Azure-tavlor.

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

  5. Välj Spara.

Pausa eller avinstallera Azure-tavlor-integration

  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ända).

  3. Om du vill avinstallera Azure-tavlor app väljer du Avinstallera och sedan OK i fönstret för popup-bekräftelse.

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

Uppdatera Azure-tavlor-GitHub-anslutningar

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

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

Screenshot visar avinstallerade Azure-tavlor GitHub app.

Felsöka integreringsproblem

Tom lagringsplatslista när lagringsplatser läggs till

Om lagringsplatsens lista visas tom i Azure DevOps:

  • Kontrollera att din GitHub organisation har aktiverat appåtkomst från tredje part.
  • Se till att du har beviljat Azure-tavlor behörighet att komma åt din organisation i Bevilja Azure-tavlor organisationsåtkomst.
  • I GitHub kontrollerar du organisationsinställningarna > Installerade GitHub Appar > Azure-tavlor > Organisationsåtkomst. Om statusen visar "Väntande åtkomstbegäran" väljer du Bevilja för att godkänna.

Statusen "Väntande åtkomstbegäran" har fastnat

Om åtkomsten för organisationen fortfarande är väntande:

  • Du måste vara en GitHub organisationsägare eller administratör för att godkänna begäran.
  • Välj Bevilja i avsnittet Organisationsåtkomst i inställningarna för auktoriserade appar.
  • Om problemet kvarstår avinstallerar du Azure-tavlor-appen och installerar om den enligt stegen i Installera och konfigurera Azure-tavlor-appen.

Märke visas inte efter länkning av pull-begäran

Om märket inte visas i README-filen när du har länkat en pull-begäran:

  • Märket visas bara när du länkar pull-begäran och lagringsplatsen är den första i din anslutna lista.
  • Kontrollera att den länkade PR:en fortfarande är öppen (sammanfogade PR:er utlöser inte skapande av märke).
  • Kontrollera att Azure-tavlor har skrivåtkomst till din lagringsplats.

Autentiserings- eller behörighetsfel

Om du ser autentiseringsfel under installationen:

  • Kontrollera att du är organisationsägare eller administratör i GitHub.
  • Se till att din GitHub organisation inte har begränsat åtkomsten till program från tredje part.
  • Kontrollera att du har läsbehörigheter på den lagringsplats som du vill ansluta till.
  • Prova att logga ut från GitHub och logga in igen och försök sedan auktoriseringen igen.

Nästa steg

Länka GitHub-förändringar, pull-förfrågningar och grenar till arbetsobjekt

Relaterat innehåll

  • Last updated on