Delen via

De Azure Boards-app voor GitHub installeren

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Installeer de Azure Boards-app voor GitHub om Azure Boards te verbinden met uw GitHub-opslagplaatsen. Wanneer u Azure Boards-projecten verbindt met GitHub.com opslagplaatsen, ondersteunt u het koppelen tussen GitHub-doorvoeringen en pull-aanvragen voor werkitems. U kunt GitHub gebruiken voor softwareontwikkeling terwijl u Azure Boards gebruikt om uw werk te plannen en bij te houden.

Zie Azure Boards-GitHub-integratie voor een overzicht van de integratie die door de Azure Boards-app voor GitHub wordt ondersteund. Nadat u de Azure Boards-app voor GitHub hebt geïnstalleerd op uw GitHub-account of -organisatie, kiest u met welke GitHub-opslagplaatsen u verbinding wilt maken vanuit uw project.

Vereisten

Machtigingen:

  • Wees een beheerder of eigenaar van de GitHub-organisatie om de Azure Boards-app te installeren.
  • Leesmachtigingen hebben voor de GitHub-opslagplaats.
  • Lid zijn van de groep Beheerders van projectverzamelingen. Als u het project hebt gemaakt, hebt u deze machtigingen al.

Belangrijk

Als uw opslagplaats al is verbonden via een ander verificatietype, zoals OAuth, moet u die opslagplaats verwijderen uit uw bestaande verbinding voordat u deze opnieuw verbindt via de GitHub-app. Volg de stappen in GitHub-opslagplaatsen toevoegen of verwijderen verderop in dit artikel voordat u de GitHub-app configureert.

U kunt een Azure DevOps-organisatie verbinden met meerdere GitHub-opslagplaatsen als u een beheerder bent voor deze opslagplaatsen. U moet echter geen GitHub-opslagplaats verbinden met meer dan één Azure DevOps-organisatie.

Azure Boards-organisatie toegang geven

Voer de volgende stappen uit om GitHub toegang te verlenen tot uw Azure DevOps-organisatie.

  1. Open In de GitHub-webportal instellingen in het profielmenu.

    Schermopname van het geopende profiel, kies Instellingen.

  2. Selecteer Toepassingen onder Integraties.

  3. Selecteer Geautoriseerde GitHub Apps>Azure Boards.

    Schermopname van het tabblad Geautoriseerde OAuth-apps en kies Azure Boards.

  4. Los onder Toegang tot de organisatie eventuele problemen op. Selecteer Verlenen om toegang te verlenen aan organisaties die een toegangsaanvraag in behandeling hebben.

    Schermopname van toegang tot de organisatie met organisaties zonder toegang.

De Azure Boards-app installeren en configureren

  1. Ga naar de Azure Boards-app in GitHub Marketplace.

  2. Selecteer Een plan instellen.

    Schermopname van GitHub Marketplace, knop Plan instellen.

  3. Kies de GitHub-organisatie waarmee u verbinding wilt maken met Azure Boards.

    Schermopname van het dialoogvenster Azure Boards installeren.

  4. Kies de opslagplaatsen die u wilt verbinden met Azure Boards.

    In het volgende voorbeeld kiezen we ervoor om verbinding te maken met alle opslagplaatsen.

    Schermopname van alle geselecteerde opslagplaatsen.

  5. Kies het Azure DevOps-organisatie- en Azure Boards-project waarmee u verbinding wilt maken met GitHub.com.

    Schermopname van het instellen van het verbindingsdialoogvenster.

    U kunt slechts één project tegelijk verbinden. Als u andere projecten hebt waarmee u verbinding wilt maken, kunt u dat later doen, zoals beschreven in Andere projecten of opslagplaatsen configureren verderop in dit artikel.

  6. Als u verbinding wilt maken met GitHub.com, autoriseert u uw Azure Boards-organisatie.

    Schermopname van het dialoogvenster Autorisatie van Azure Boards.

  7. Bevestig de GitHub.com opslagplaatsen waarmee u verbinding wilt maken. Selecteer elke opslagplaats waarmee u verbinding wilt maken. Hef de selectie van opslagplaatsen op die u niet wilt opnemen in de integratie.

    Schermopname van het dialoogvenster Uw GitHub-opslagplaatsen bevestigen.

De verbinding gebruiken

Op dit moment is uw Azure Boards-GitHub-integratie voltooid. U kunt de volgende stappen overslaan of ze doorlopen om inzicht te krijgen in de functies die worden ondersteund met de verbinding.

  1. Selecteer op uw bord Nieuw werkitem om een nieuw werkitem met de naam 'Badge toevoegen aan README' in te voeren: Probleem (Basis), Gebruikersverhaal (Agile) of Productachterstanditem (Scrum) afhankelijk van het procesmodel dat wordt gebruikt door uw Azure Boards-project.

    Er wordt een werkitem met de titel Badge toevoegen aan LEESMIJ weergegeven op uw bord.

  2. Open uw werkitem, ga naar de sectie Ontwikkeling en selecteer Koppeling toevoegen.

  3. Selecteer GitHub Pull Request in het vervolgkeuzemenu Koppelingstype .

  4. Selecteer de opslagplaats en voer de pull-aanvraag-id en een optionele opmerking in.

  5. Selecteer Koppeling toevoegen.

    Schermopname van de actie Koppeling toevoegen in het gebruikersverhaal, met de selectie van de opslagplaats en lege vakken voor invoer van de pull-aanvraag-id en optionele opmerking.

    De volgende acties worden automatisch op de achtergrond uitgevoerd:

    • Hiermee voegt u een badge toe aan het README-bestand van de eerste opslagplaats in de lijst met verbonden GitHub-opslagplaatsen.
    • Hiermee maakt u een GitHub-doorvoering voor de update die is gemaakt door de badge toe te voegen aan het README-bestand.
    • Hiermee maakt u een GitHub-pull-aanvraag om de wijzigingen in het README-bestand samen te voegen.
    • Hiermee koppelt u de Doorvoer- en pull-aanvraag van GitHub aan het werkitem dat u in stap 1 hebt gemaakt.

  6. Selecteer de eerste pull-aanvraagkoppeling in uw werkitem.

    Schermopname van het probleemformulier voor een pull-aanvraag die is geopend in GitHub.

    De GitHub-pull-aanvraag wordt geopend op een nieuw browsertabblad.

  7. Selecteer Pull-aanvraag samenvoegen.

    Schermopname van een voorbeeld van een pull-aanvraag in GitHub.

  8. Ga naar het README-bestand van uw opslagplaats en bekijk de badge die is toegevoegd.

    Schermopname van GitHub-opslagplaats met badge toegevoegd.

    Zie Statusbadges configureren om toe te voegen aan GitHub README-bestanden voor meer informatie.

Andere projecten of opslagplaatsen configureren

U kunt andere Azure Boards/Azure DevOps Projects, GitHub.com opslagplaatsen configureren of de huidige configuratie wijzigen op de azure Boards-app-pagina. Zie Toegang tot GitHub-opslagplaatsen wijzigen of de integratie onderbreken of verwijderen voor meer informatie.

Opslagplaatsen toevoegen of verwijderen of een verbinding verwijderen uit Azure Boards

Als u een probleem ondervindt met een verbinding, wordt u aangeraden de verbinding te verwijderen en opnieuw te beginnen met een nieuwe verbinding.

  1. Ga vanuit uw project in Azure DevOps naar GitHub-verbindingen met Project-instellingen>.

  2. Als u opslagplaatsen wilt toevoegen of verwijderen, selecteert u het beletselteken Meer opties voor de verbinding en kiest u Opslagplaatsen toevoegen of Opslagplaatsen verwijderen uit het menu.

    Schermopname van het gitHub-verbindingsmenu van Meer opties.

  3. Als u alle opslagplaatsen en de verbinding wilt verwijderen, kiest u de optie Verbinding verwijderen. Kies vervolgens Verwijderen om te bevestigen.

    Schermopname van het verwijderen van een GitHub-verbinding.

  1. Als u opslagplaatsen wilt toevoegen of verwijderen, opent u het actiespictogram voor de verbinding en kiest u Opslagplaatsen toevoegen of Opslagplaatsen verwijderen uit het menu.

    Schermopname van het toevoegen of verwijderen van GitHub-opslagplaatsen.

  2. Als u alle opslagplaatsen en de verbinding wilt verwijderen, kiest u de optie Verbinding verwijderen. Kies vervolgens Verwijderen om te bevestigen.

    Schermopname van bevestiging van het dialoogvenster voor het verwijderen van GitHub-verbindingen.

Toegang tot opslagplaats wijzigen

  1. Meld u aan bij GitHub en open de profielinstellingen van uw organisatie.

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

  2. Ga naar Geïnstalleerde GitHub-apps>die Azure Boards>configureren.
    Schermopname van het geopende Organisatie-account, Geïnstalleerde GitHub-apps, Azure Boards, Configureren.

    De configuratiepagina van Azure Boards wordt geopend.

  3. Schuif omlaag naar de sectie Toegang tot opslagplaats.

  4. Kies de gewenste optie, Alle opslagplaatsen of alleen opslagplaatsen selecteren.

    Als u Alleen opslagplaatsen selecteert, selecteert u de opslagplaatsen die u wilt integreren met Azure Boards.

    Schermopname van opslagplaatstoegang, kies Alleen opslagplaatsen selecteren.

  5. Selecteer Opslaan.

Integratie van Azure Boards onderbreken of verwijderen

  1. Schuif vanaf stap 2 in de vorige procedure omlaag naar de sectie Gevaarzone .

    Schermopname van de configuratie van Azure Boards, sectie Gevaarzone.

  2. Als u de integratie wilt onderbreken, kiest u Onderbreken. Kies ok in het pop-upbevestigingsvenster om de schorsing te bevestigen.

    Schermopname van bevestiging van schorsing.

    Als u de integratie ongedaan wilt maken, kiest u Unsuspend.

  3. Als u de Azure Boards-app wilt verwijderen, kiest u Verwijderen en kiest u VERVOLGENS OK in het pop-upvenster.

    Schermopname van bevestiging voor verwijderen.

Azure Boards-GitHub-verbindingen bijwerken

Als u de opslagplaatsen wijzigt die door de Azure Boards-app voor GitHub worden ondersteund, wordt u mogelijk omgeleid naar Azure Boards GitHub-verbindingen. Een goede gewoonte is om de opslagplaatsen in Azure Boards te verwijderen die geen verbinding meer kunnen maken met GitHub. Zie GitHub-opslagplaatsen toevoegen of verwijderen voor meer informatie.

Als u de Azure Boards-app voor GitHub verwijdert, wordt het volgende bericht weergegeven in Azure Boards, Projectinstellingen>GitHub-verbindingen. Kies Verbinding verwijderen om alle eerder gemaakte GitHub-verbindingen te verwijderen. Zie GitHub-opslagplaatsen toevoegen/verwijderen voor meer informatie.

Schermopname van de Azure Boards GitHub-app verwijderd.

Volgende stappen

GitHub-doorvoeringen, pull-aanvragen en vertakkingen koppelen aan werkitems