Pijplijnen configureren ter ondersteuning van werktracering

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

Voor ondersteuning van integratie en tracering in Azure DevOps Services met pijplijnen kunt u verschillende opties configureren. U kunt de pijplijnstatus rapporteren, de syntaxis voor statusbadges kopiëren en automatisch koppelen van werkitems aan builds en releases instellen.

Ondersteunde integratiefuncties voor pijplijn- en werktracering

Verschillende functies bieden ondersteuning voor end-to-end traceerbaarheid wanneer gebruikersverhalen en -functies door de ontwikkelingscyclus lopen. Net als bij Azure-opslagplaatsen kunt u werkitems koppelen aan pijplijnobjecten met de volgende koppelingstypen: Bouwen, Geïntegreerd in build en Geïntegreerd in release. De koppeling geïntegreerd in de releaseomgeving kan alleen worden gemaakt door de optie "Releasestatus naar Boards rapporteren" in te schakelen in klassieke release pipelines.

De volgende tabel bevat een overzicht van de integratiepunten tussen Azure Boards en Azure Pipelines. Opties en configuratiestappen verschillen, afhankelijk van of u een YAML- of klassieke pijplijn configureert en uw Azure DevOps-versie. De meeste opties worden ondersteund voor pijplijnen die worden uitgevoerd in een Azure Repos Git-opslagplaats, tenzij anders vermeld.

Functie

Beschrijving

Ondersteunde versies

---

Werkitems handmatig koppelen aan builds

U kunt vanuit een werkitem een koppeling maken naar builds binnen hetzelfde project of andere projecten binnen de organisatie. Zie Koppeling naar werkitems van andere objecten voor meer informatie.

Alle versies

---

Builds weergeven die verbonden zijn aan een werkitem

U kunt alle builds bekijken die zijn gekoppeld vanuit een werkitem, handmatig of automatisch gekoppeld, op het tabblad Koppelingen. Zie Koppeling naar werkitems van andere objecten, lijst met gekoppelde objecten weergeven voor meer informatie.

Alle versies

---

Werkitems automatisch koppelen aan builds

Vereist om het controle Ontwikkeling te vullen met koppelingen geïntegreerd in build. De werkitems of doorvoeringen die deel uitmaken van een release, worden berekend op basis van de versies van artefacten. Bijvoorbeeld, elke build in Azure Pipelines is gekoppeld aan een set werkitems en commits. Zie Werkitems automatisch koppelen verderop in dit artikel voor meer informatie.

YAML, Azure DevOps Server 2020 en hoger

---

Werkitems automatisch koppelen aan releases en de implementatiestatus rapporteren aan een werkitem (alleen klassiek)

Vereist om het implementatiebesturingselement in het werkitemformulier in te vullen met koppelingen die geïntegreerd zijn in de releasefase. Zie De implementatiestatus rapporteren aan borden verderop in dit artikel voor meer informatie.

Azure DevOps Server 2020 en hoger

---

Lijst met werkitems weergeven die zijn gekoppeld aan een build of release

Controleer en open de werkitems die zijn opgenomen in een build of release.

YAML, Azure DevOps Server 2020 en hoger

---

Werkitem maken bij fout (klassiek)

Automatisch een werkitem maken wanneer een build mislukt en desgewenst waarden instellen voor werkitemvelden. Zie Werkitem maken over fouten verderop in dit artikel voor meer informatie.

2018 en latere versies

---

Voer een query uit voor de taak Werkitems. Zorg ervoor dat het aantal overeenkomende werkitems dat wordt geretourneerd door een query binnen een drempelwaarde valt.

Gebruik deze taak om ervoor te zorgen dat het aantal overeenkomende items dat wordt geretourneerd door een werkitemquery binnen de geconfigureerde drempelwaarden valt. Zie de taak Querywerkitems, Implementaties beheren met poorten en goedkeuringen voor meer informatie.

Azure DevOps Server 2020 en latere versies

---

Vereisten

• Als u de integratieopties voor een klassieke release-pijplijn wilt configureren, moet u gemachtigd zijn om de release te bewerken.
• Als u werkitems wilt koppelen aan commits en pull-aanvragen, moet u de machtigingen voor Werkitems bewerken in dit knooppunt instellen op Toestaan voor het toegewezen gebiedspad aan het werkitem. De groep Inzenders heeft standaard deze machtiging ingesteld.
• Als u werkitems wilt weergeven, moet u de machtiging werkitems weergeven in dit knooppunt instellen op Toestaan voor het gebiedspad dat aan het werkitem is toegewezen.

Pijplijninstellingen, buildopties of integratieopties openen

YAML

Pijplijninstellingen openen

Voor DOOR YAML gedefinieerde release-pijplijnen configureert u de integratie via het dialoogvenster Pijplijninstellingen .

1. Open de pijplijn, kies Meer acties en kies Instellingen.

   

   Het dialoogvenster Pijplijninstellingen wordt weergegeven. Voor meer informatie over automatisch koppelen, zie Werkitems automatisch koppelen verderop in dit artikel.

   

Klassieke build

Build-eigenschappen

Open de build-pijplijn, kies ervoor om de pijplijn te bewerken en kies vervolgens het tabblad Opties .

De pagina Bouweigenschappen wordt weergegeven.

Gebruik een van de volgende koppelingen voor meer informatie over elke instelling:

• Getalnotatie bouwen
• Werkitems automatisch koppelen
• Werkitem maken bij een fout
• Statusbadge

Klassieke uitgave

Release-integratieopties

Voor klassieke release-pijplijnen opent u Pijplijnen>, kiest u de optie om uw pijplijn te bewerken, kiest u Opties en vervolgens Integraties.

Gebruik een van de volgende koppelingen voor meer informatie over elke instelling:

• Implementatiestatus rapporteren aan de opslagplaatshost
• Implementatiestatus rapporteren in Werk
• Inzetstatus rapporteren aan Boards
• Implementatiestatus rapporteren aan Jira
• De implementatiestatus-badge inschakelen

Werkitems automatisch koppelen aan builds of releases

Door automatisch koppelen in te schakelen, kunt u de builds of releases bijhouden waarin werk is opgenomen, zonder dat u handmatig hoeft te zoeken door een grote reeks daarvan. Elke geslaagde build die aan het werkitem is gekoppeld, wordt automatisch weergegeven in het besturingselement Ontwikkeling van het werkitemformulier. Elke releasefase die aan het werkitem is gekoppeld, wordt automatisch weergegeven in het besturingselement Implementatie van het werkitemformulier.

YAML

1. Open Pipeline-instellingen zoals beschreven in Open Pipeline-instellingen.

2. Schakel automatisch nieuw werk in deze build in.

   

   Zodra deze optie is ingeschakeld, worden er ingebouwde buildkoppelingen gegenereerd voor alle werkitems die zijn gekoppeld aan de geselecteerde pull-aanvraag bij elke release-uitvoering.

Klassieke versie

1. Open pijplijn Build-eigenschappen zoals beschreven in Build-eigenschappen.

2. Schakel automatisch koppelen van werkitems die in deze uitvoering zijn opgenomen in. Voeg de vertakkingen toe die moeten worden opgenomen of uitgesloten.
   

   Zodra deze optie is ingeschakeld, wordt geïntegreerd in de build gegenereerd voor alle werkitems die aan de geselecteerde vertakkingen zijn gekoppeld bij elke uitvoering.

   Als u een lijst met werkitems wilt weergeven die aan de build zijn gekoppeld, kiest u de koppeling Gerelateerd op de pagina Overzicht.

   

3. Sla uw pijplijn op.

Klassieke release

Voordat u integratieopties kiest, moet u de release-stages instellen zoals beschreven in Definieer uw multi-stage continuous deployment (CD) pijplijn.

1. Open Options>Integrations voor de release-pijplijn zoals beschreven in de opties voor releaseintegratie.

2. Schakel het selectievakje Status van rapportimplementatie naar Boards in. Wijs het implementatietype toe aan elke fase of laat Ongemapt. Selecteer deze optie als u koppelingen wilt maken naar alle werkitems die gekoppelde wijzigingen in de bron vertegenwoordigen, wanneer een release is voltooid. Deze optie moet zijn ingeschakeld om het besturingselement Implementatie van het werkitemformulier te laten werken.

   

   Als u een lijst met werkitems wilt weergeven die aan de release zijn gekoppeld, kiest u Release (oude weergave) in Meer opdrachten en kiest u vervolgens het tabblad Werkitems.

   

3. Sla uw datapijplijn op.

De integratie controleren

Voer de volgende stappen uit om te controleren of de integratie werkt:

1. Koppel een of meer werkitems aan een commit of pull request in een Azure Repos Git-opslagplaats. Zie voor meer informatie:

   • Git-ontwikkeling van een werkitem stimuleren
   • Koppeling naar werkitems van andere objecten

2. Voer de pijplijn uit.

3. Open een van de gekoppelde werkitems en bekijk het besturingselement Implementatie. Zoals te zien is in de onderstaande afbeelding, toont het besturingselement Implementatie release-informatie voor twee releasefasen, welke werkitems betreffen die gekoppeld zijn aan een Git commit of pull-aanvraag voor een release-pijplijn die is geconfigureerd om te integreren met Azure Boards.

Welke werkitems zijn opgenomen in automatische koppeling?

Bij het ontwikkelen van uw software kunt u werkitems koppelen wanneer u een vertakking, doorvoer of pull-aanvraag maakt. U kunt ook een vertakking, doorvoer- of pull-aanvraag starten vanuit een werkitem, zodat deze objecten automatisch worden gekoppeld, zoals beschreven in Git-ontwikkeling in Drive vanuit een werkitem. Hier maken we bijvoorbeeld een nieuwe vertakking op basis van het gebruikersverhaal van het orderformulier Annuleren.

Wanneer u werkitems automatisch koppelt aan builds, worden de volgende berekeningen uitgevoerd:

• Voor een eerste build:

  • Identificeer alle werkitems die zijn gekoppeld aan de branch, commits en pull-aanvragen die bij de build horen.

• Voor toekomstige builds:

  • Identificeer alle werkitems die zijn gekoppeld aan de huidige commit (C1) die wordt gebouwd.
  • Identificeer alle werkitems die zijn gekoppeld aan de doorvoer (C2) van de laatste geslaagde build van dezelfde bronbranch.
  • Identificeer alle werkitems die zijn gekoppeld aan de commits tussen C1 en C2 in de commitboom.

Werkitem maken bij buildfout (klassiek)

Als een build-pijplijn mislukt, kunt u automatisch een werkitem maken om het oplossen van het probleem te volgen. U kunt het type werkitem opgeven en opties instellen om het automatisch toe te wijzen aan de aanvrager of andere velden. De aanvrager komt overeen met de persoon die de build heeft geactiveerd.

Tip

De optie voor het maken van een werkitem bij een fout wordt alleen ondersteund voor klassieke pijplijnen. U kunt dit bereiken met een YAML-pijplijn door een marketplace-extensie te gebruiken, zoals Bug bij releasefout maken of u kunt het zelf implementeren met behulp van aanroepen via Azure CLI of REST API.

1. Open opties voor pijplijnbuild zoals beschreven in Build-eigenschappen.

2. Schakel Werkitem maken in bij fout en kies het type werkitem dat u wilt maken. Schakel desgewenst het selectievakje Toewijzen aan aanvrager in om het Toewijzen aan veld in te stellen en velden toe te voegen die binnen het werkitem moeten worden ingesteld dat je wilt maken.

   Hier kiezen we bijvoorbeeld het itemtype Bug work en specificeren we de velden Prioriteit en Tags en hun waarden.

   

3. Sla uw pipeline op.

Als u de verwijzingsnaam voor een veld wilt leren, zoekt u deze op in de veldindex Werkitem. Voor aangepaste velden die u toevoegt via een overgenomen proces, wijst Azure DevOps een verwijzingsnaam toe op basis van de beschrijvende veldnaam die is voorafgegaan door Aangepast. U voegt bijvoorbeeld een veld toe met de naam DevOps Triage. De referentienaam is Custom.DevOpsTriage. Er zijn geen spaties toegestaan binnen de verwijzingsnaam.

Een statusbadge ophalen of inschakelen

YAML

1. Open pijplijn Meer acties en kies statusbadge.

   

2. Kies de afdeling en het interessegebied en klik daarna op Kopiëren naar klembord om de afbeelding of Markdown-syntaxis te kopiëren.

   

Klassieke build

1. Open Build-eigenschappen van de pijplijn zoals beschreven in Build-eigenschappen.

2. Kies Kopiëren naar klembord om de afbeelding of Markdown-syntaxis te kopiëren.

   

3. Sla uw pijplijn op.

Klassieke uitgave

Selecteer deze optie als u het laatste resultaat van een fase-implementatie op een externe website wilt weergeven.

1. Vink het selectievakje Implementatiestatusbadge inschakelen aan. Selecteer vervolgens de fasen waarvoor u het resultaat wilt weergeven. Standaard worden alle fasen geselecteerd die zijn gedefinieerd voor de release.

   

2. Kies Kopiëren naar klembord om de afbeelding of Markdown-syntaxis te kopiëren.

   

3. Sla uw pipeline op.

Implementatiestatus rapporteren aan de opslagplaatshost (klassiek)

Wanneer uw code is opgeslagen in een Git-opslagplaats in Azure Repos, kunt u uw releasepipeline configureren om een badge weer te geven op de Azure Repos-pagina's. De badge geeft aan waar de specifieke commit is geïmplementeerd en of de implementatie geslaagd of mislukt is. Deze optie verbetert de traceerbaarheid van codedoorvoering tot implementatie.

De uitrolstatus wordt weergegeven in de volgende secties van Azure Repos:

• Bestanden: Geeft de status van de laatste implementatie voor de geselecteerde tak aan.
• Doorvoeringen: geeft de implementatiestatus voor elke doorvoer aan (vereist dat de trigger voor continue integratie (CD) is ingeschakeld voor uw release.
• Vertakkingen: Geeft de status van de nieuwste implementatie voor elke vertakking aan.

Wanneer een commit wordt geïmplementeerd in meerdere releasepijplijnen, elk met meerdere fasen, heeft elke fase een vermelding in de badge met de status die voor die fase wordt weergegeven. Wanneer u een release-pijplijn maakt, wordt de implementatiestatus standaard voor alle fasen gepost. U kunt echter selectief de fasen kiezen waarvoor de implementatiestatus moet worden weergegeven in de statusbadge (bijvoorbeeld alleen de productiefase weergeven). Uw teamleden kunnen de statusbadge selecteren om de meest recente implementatiestatus weer te geven voor elk van de geselecteerde fasen van de release-pijplijnen.

Implementatiestatus rapporteren aan Jira (klassiek)

Voeg Jira-problemen in werkitems toe en maak koppelingen naar alle problemen bij het voltooien van de fase. Installeer Azure Pipelines voor de Jira-app in de Jira Software-cloud en voeg organisatie toe om een verbinding te maken.

Installeer Azure DevOps voor Jira en verbind uw Azure DevOps-organisaties met uw Jira Software-instantie om de integratie met het bijhouden van issues in Jira te ondersteunen. U kunt meerdere organisaties verbinden met één exemplaar en gegevens ophalen voor al uw teams en gerelateerde projecten. Zie Azure DevOps verbinden met Jira voor meer informatie.

Verwante artikelen:

• Een pijplijn voor continue implementatie (CD) met meerdere fasen definiëren
• Werkitems koppelen aan andere objecten
• Bekijk het overzicht van release-pijplijnen (klassiek)
• Alle werkitems ophalen die zijn gekoppeld aan een release-pijplijn met behulp van de Azure DevOps-API
• Git-ontwikkeling van een werkitem stimuleren
• Werkitems koppelen aan andere objecten
• End-to-end traceerbaarheid garanderen
• Raadpleeg de referentie voor koppelingstype