ManualValidation@0 - Handmatige validatie v0-taak

Artikel
06/11/2024

Gebruik deze taak om een YAML-pijplijnuitvoering te onderbreken om te wachten op handmatige interactie.

Syntax

# Manual validation v0
# [PREVIEW] Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@0
  inputs:
    notifyUsers: # string. Required. Notify users. 
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

Invoerwaarden

notifyUsers - Gebruikers op de hoogte stellen
string. Vereist.

Hiermee wordt een e-mail met een handmatige validatie verzonden naar specifieke gebruikers (of groepen). Alleen gebruikers met een machtiging voor het maken van wachtrijen kunnen reageren op een handmatige validatie. U kunt een e-mailbericht verzenden naar een groep met behulp van de [org name]\group name syntaxis.

Deze taakinvoer is vereist, maar u kunt een lege tekenreeks opgeven als u niemand op de hoogte wilt stellen, bijvoorbeeld tijdens een testuitvoering: notifyUsers: ''.

instructions - Instructies
string.

Hiermee geeft u de instructies op die aan de gebruiker worden weergegeven bij het hervatten of weigeren van de handmatige interventie. Op basis van deze instructies neemt de gebruiker een weloverwogen beslissing over deze handmatige interventie.

onTimeout - Bij time-out
string. Toegestane waarden: reject, resume. Standaardwaarde: reject.

Deze handmatige validatie wordt automatisch geweigerd of hervat nadat deze in behandeling is voor de opgegeven time-out, of 30 dagen, afhankelijk van wat eerder is.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak in een YAML-pijplijn om een uitvoering binnen een fase te onderbreken. Dit wordt meestal uitgevoerd om verschillende handmatige stappen of acties uit te voeren en vervolgens wordt de uitvoering hervat of geweigerd.

Belangrijk

Deze taak wordt alleen ondersteund in YAML-pijplijnen en kan alleen worden gebruikt in een taak zonder agent van een YAML-pijplijn.

Met de taak Handmatige validatie kunt u een pijplijnuitvoering binnen een fase onderbreken, meestal om enkele handmatige stappen of acties uit te voeren en vervolgens door te gaan met de pijplijn. De gebruiker moet bijvoorbeeld mogelijk bepaalde implementatieconfiguraties handmatig valideren voordat de pijplijn een langdurige rekenintensieve taak start.

De taakconfiguratie Handmatige validatie bevat een instructieparameter die wordt gebruikt om gerelateerde informatie op te geven of om de handmatige stappen op te geven die de gebruiker tijdens de onderbreking uitvoert. U kunt de taak configureren om e-mailmeldingen te verzenden naar gebruikers en gebruikersgroepen wanneer deze wacht op een beoordeling en het automatische antwoord (weigeren of hervatten) opgeven nadat een configureerbare time-out is opgetreden.

U kunt de time-outwaarde voor de taak opgeven met behulp van de optionele timeoutInMinutes parameter, die beschikbaar is in de algemene taakeigenschappen.

Notitie

De taak kan alleen volledig worden uitgevoerd als de timeoutInMinutes waarde van de taak (default = 60 minutes) die deze taak bevat, hoger is dan de timeoutInMinutes waarde van de taak zelf. Zie standaardwaarden voor taaktime-outs.

Tip

U kunt variabelen gebruiken om e-mailadressen op te geven in de notifyUsers parameter .

Wanneer de taak Handmatige validatie wordt geactiveerd tijdens een pijplijn, wordt er een berichtenbalk weergegeven met een koppeling waarmee het dialoogvenster Handmatige validatie, dat de instructies bevat, wordt geopend. Nadat de handmatige stappen zijn uitgevoerd, kan de beheerder of gebruiker ervoor kiezen de uitvoering te hervatten of te weigeren. Gebruikers met de machtiging Queue Builds voor de pijplijn kunnen de uitvoering hervatten of weigeren.

Voorbeelden

  jobs:
  - job: waitForValidation
    displayName: Wait for external validation
    pool: server
    timeoutInMinutes: 4320 # job times out in 3 days
    steps:
    - task: ManualValidation@0
      timeoutInMinutes: 1440 # task times out in 1 day
      inputs:
        notifyUsers: |
          test@test.com
          example@example.com
        instructions: 'Please validate the build configuration and resume'
        onTimeout: 'resume'

In dit voorbeeld wordt een timeoutInMinutesalgemene taakeigenschap gebruikt die beschikbaar is in alle taken.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Server
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Implementeren

Delen via