Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
In deze quickstart installeert u 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. 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.
Zie Azure Boards-GitHub-integratie voor een overzicht van de integratie die door de Azure Boards-app voor GitHub wordt ondersteund.
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | - Lid van de beheerders van projectverzamelingen groep. Als u het project hebt gemaakt, hebt u machtigingen. - beheerder of eigenaar van de GitHub-organisatie voor het installeren van de Azure Boards-app. - Lees machtigingen voor de GitHub-opslagplaats. |
| projectlidmaatschap | projectmedewerker. |
Important
Als uw opslagplaats al is verbonden met een ander verificatietype, zoals OAuth, moet u die opslagplaats verwijderen uit uw bestaande verbinding voordat u deze opnieuw verbindt met behulp van 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 geen GitHub-opslagplaats verbinden met meer dan één Azure DevOps-organisatie.
De Azure Boards-app installeren en configureren
De installatiereeks kan variëren vanwege de configuratie van uw account. Volg indien nodig de aanwijzingen op het scherm tussen de volgende stappen.
Ga naar de Azure Boards-app in GitHub Marketplace.
Selecteer Installeren onder Abonnementen en prijzen onder Gratis.
Kies in Install & Authorize Azure Boards de opslagplaatsen die u wilt verbinden met Azure Boards en selecteer vervolgens Installeren en autoriseren.
In dit voorbeeld worden alle opslagplaatsen gebruikt:
Kies het Azure DevOps-organisatie- en Azure Boards-project waarmee u verbinding wilt maken met GitHub.com.
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.
Azure Boards-organisatie toegang geven
Voer zo nodig de volgende stappen uit om GitHub toegang te verlenen tot uw Azure DevOps-organisatie.
Open Instellingen vanuit het profielmenu in de GitHub-webportal.
Selecteer Toepassingen onder Integraties.
Selecteer Geautoriseerde GitHub Apps>Azure Boards.
Los onder Toegang tot de organisatie eventuele problemen op. Selecteer Verlenen om toegang te verlenen aan organisaties die een toegangsaanvraag in behandeling hebben.
Uw toegangsbeleid voor toepassingen van derden controleren
Zorg ervoor dat uw GitHub-organisatie externe toepassingstoegang toestaat voor de Azure Boards-app. Als toegang van derden is beperkt, kan het toevoegen van opslagplaatsen van Azure DevOps een lege lijst weergeven of een fout veroorzaken.
Toegang inschakelen:
Open uw organisatie in GitHub en ga naar Instellingen > OAuth-appbeleid.
Keur de Azure Boards-app specifiek (aanbevolen) goed of verwijder beperkingen voor alle toepassingen van derden.
Opmerking
U moet de eigenaar of beheerder van de organisatie zijn om deze instelling te wijzigen.
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.
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.
Open uw werkitem, ga naar de sectie Ontwikkeling en selecteer Koppeling toevoegen.
Selecteer Bij koppelingstypede optie GitHub Pull-aanvraag.
Selecteer de opslagplaats en voer de pull-aanvraag-id en een optionele opmerking in.
Selecteer Koppeling toevoegen.
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.
Selecteer de eerste pull-aanvraagkoppeling in uw werkitem.
De GitHub-pull-aanvraag wordt geopend op een nieuw browsertabblad.
Selecteer Pull-aanvraag samenvoegen.
Ga naar het README-bestand van uw opslagplaats en bekijk de badge die is toegevoegd.
Zie Statusbadges toevoegen voor uw GitHub-opslagplaats 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 Opslagplaatsen toevoegen of verwijderen of een verbinding uit Azure Boards 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.
Ga vanuit uw project in Azure DevOps naar Projectinstellingen>GitHub-verbindingen.
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.
Als u alle opslagplaatsen en de verbinding wilt verwijderen, kiest u de optie Verbinding verwijderen. Kies vervolgens Verwijderen om te bevestigen.
Toegang tot opslagplaats wijzigen
Open Instellingen vanuit het profielmenu in de GitHub-webportal.
Selecteer Integratietoepassingen>. Selecteer Configureren onder Geïnstalleerde GitHub-apps.
De configuratiepagina van Azure Boards wordt geopend.
Scroll omlaag naar de sectie Toegang tot opslagplaats.
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.
Selecteer Opslaan.
Integratie van Azure Boards onderbreken of verwijderen
Schuif vanaf stap 2 in de vorige procedure omlaag naar de sectie Gevaarzone .
Als u de integratie wilt onderbreken, kiest u Onderbreken. Kies OK in het bevestigingsvenster om de schorsing te bevestigen.
Als u de integratie ongedaan wilt maken, kiest u Unsuspend.
Als u de Azure Boards-app wilt verwijderen, kiest u Verwijderen en kiest u VERVOLGENS OK in het pop-upvenster.
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 of verwijderen voor meer informatie.
