Installera Azure Boards-appen för GitHub

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

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

En översikt över den integrering som Azure Boards-appen för GitHub stöder finns i Azure Boards-GitHub-integrering. 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.

Förutsättningar

  • Om du vill installera Azure Boards-appen måste du vara administratör eller ägare av GitHub-organisationen.
  • Om du vill ansluta till Azure Boards-projektet måste du ha läsbehörighet för GitHub-lagringsplatsen. Du måste också vara medlem i gruppen Projektsamlingsadministratörer. Om du har skapat projektet har du behörighet.

Viktigt!

Om lagringsplatsen redan är ansluten via en annan autentiseringstyp, till exempel OAuth, måste du ta bort lagringsplatsen från din befintliga anslutning innan du ansluter den igen via 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 dock inte ansluta en GitHub-lagringsplats till mer än en Azure DevOps-organisation.

Ge Azure Boards-organisationen åtkomst

Utför följande steg för att bevilja åtkomst till organisationen.

  1. Öppna Inställningar från din profilmeny från GitHub-webbportalen.

    Screenshot of open profile, choose Settings.

  2. Välj Program under Integreringar.

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

    Screenshot of Authorized OAuth Apps tab, choose Azure Boards.

  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.

    Screenshot of Organization access with organizations without access.

Installera och konfigurera Azure Boards-appen

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

  2. Välj Konfigurera en plan.

    Screenshot of GitHub Marketplace, Set up a plan button.

  3. Välj den GitHub-organisation som du vill ansluta till Azure Boards.

    Screenshot showing Install Azure Boards dialog.

  4. Välj de lagringsplatser som du vill ansluta till Azure Boards.

    I följande exempel väljer vi att ansluta till alla lagringsplatser.

    Screenshot showing all repositories selected.

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

    Screenshot of setting up connection dialog.

    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.

  6. Auktorisera din Azure Boards-organisation att ansluta till GitHub.com.

    Screenshot of Azure Boards authorization dialog.

  7. Bekräfta de GitHub.com lagringsplatser som du vill ansluta till. Välj varje lagringsplats som du vill ansluta till. Avmarkera alla lagringsplatser som du inte vill delta i integreringen.

    Screenshot of Confirm your GitHub repositories dialog.

Använda 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å tavlan väljer du Nytt objekt för att ange ett nytt arbetsobjekt med namnet "Lägg till märke i README" – Problem (Grundläggande), Användarhistoria (Agile) eller Produktpost (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 arbetsobjektet och välj pull-begäran under Lägg till länk.

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

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

    Screenshot of Add link action in user story, showing repository selection and empty boxes for input of pull request ID and optional comment.

    Följande åtgärder utförs 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.

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

    Screenshot of issue form for pull request opened in GitHub.

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

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

    Screenshot of example pull request in GitHub.

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

    Screenshot of GitHub repo with badge added.

    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 Boards/Azure DevOps Projects, GitHub.com lagringsplatser eller ändra den aktuella konfigurationen från azure boards-appsidan. Mer information finns i Ändra åtkomst till GitHub-lagringsplats eller pausa eller avinstallera integreringen.

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. Om du vill lägga till eller ta bort lagringsplatser väljer du Fler alternativ för anslutningen och väljer Lägg till lagringsplatser eller Ta bort lagringsplatser från menyn.

    Screenshot of GitHub connection menu of More options.

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

    Screenshot of confirmation removal of GitHub connection.

  1. Om du vill lägga till eller ta bort lagringsplatser öppnar du åtgärdsikonen för anslutningen och väljer Lägg till lagringsplatser eller Ta bort lagringsplatser från menyn.

    Screenshot of add or remove GitHub repos.

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

    Screenshot of confirmation of GitHub connection removal dialog.

Ändra åtkomst till lagringsplats

  1. Logga in på webbportalen för din GitHub-organisation och öppna Kontoinställningar.

    https://github.com/organizations/fabrikam-fiber/settings/profile

  2. Välj Installerade GitHub-appar och sedan Konfigurera bredvid Azure Boards.
    Screenshot of open Organization account, Installed GitHub Apps, Azure Boards, Configure.

    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.

    Screenshot of Repository access, choose Only select repositories.

  5. Välj Spara när du är klar.

Pausa eller avinstallera Azure Boards-integrering

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

    Screenshot of Azure Boards configuration, Danger zone section.

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

    Screenshot of suspension confirmation.

    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.

    Screenshot of uninstall confirmation.

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/ta bort GitHub-lagringsplatser.

Screenshot of uninstalled Azure Boards GitHub app.

Nästa steg

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