Dela via


ManualValidation@0 – Uppgift för manuell validering v0

Använd den här uppgiften för att pausa en YAML-pipelinekörning för att vänta på manuell interaktion.

Syntax

# Manual validation v0
# 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.
# 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.

Ingångar

notifyUsers - Meddela användare
string. Obligatoriskt.

Skickar ett e-postmeddelande om väntande manuell validering till specifika användare (eller grupper). Endast användare med behörighet att skapa köer kan utföra en manuell validering. Du kan skicka ett e-postmeddelande till en grupp med hjälp av syntaxen [org name]\group name .

Den här uppgiftsinmatningen krävs, men du kan ange en tom sträng om du inte vill meddela någon, till exempel under en testkörning: notifyUsers: ''.


instructions - instruktioner
string.

Anger de instruktioner som visas för användaren när du återupptar eller avvisar den manuella valideringen. Baserat på dessa instruktioner fattar användaren ett välgrundat beslut om den här manuella valideringen.


onTimeout - Vid tidsgräns
string. Tillåtna värden: reject, resume. Standardvärde: reject.

Avvisar eller återupptar automatiskt den här manuella valideringen när den är väntande för den angivna tidsgränsen, eller 30 dagar, beroende på vilket som inträffar tidigare.


Alternativ för uppgiftskontroll

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften i en YAML-pipeline för att pausa en körning inom en fas. Detta körs vanligtvis för att utföra olika manuella steg eller åtgärder och sedan återupptas eller avvisas körningen.

Viktigt!

Den här uppgiften stöds endast i YAML-pipelines och kan endast användas i ett agentlöst jobb av en YAML-pipeline.

Med manuell validering aktivitet kan du pausa en pipelinekörning inom en fas, vanligtvis för att utföra några manuella steg eller åtgärder och sedan fortsätta med pipelinen. Användaren kan till exempel behöva verifiera vissa distributionskonfigurationer manuellt innan pipelinen startar ett tidskrävande beräkningsintensivt jobb.

manuell validering aktivitetskonfiguration innehåller en instruktioner parameter som används för att ange relaterad information eller för att ange de manuella steg som användaren kör under pausen. Du kan konfigurera uppgiften att skicka e-postaviseringar till användare och användargrupper när den väntar på en granskning och ange det automatiska svaret (avvisa eller återuppta) efter att en konfigurerbar tidsgräns har inträffat.

Du kan ange tidsgränsvärdet för aktiviteten med hjälp av den valfria parametern timeoutInMinutes som finns i vanliga uppgiftsegenskaper.

Anmärkning

För att aktiviteten ska köras helt måste timeoutInMinutes värdet för jobbet (default = 60 minutes) som innehåller den här aktiviteten vara högre än timeoutInMinutes värdet för själva aktiviteten. Se standardvärden för tidsgräns för jobb.

Tips/Råd

Du kan använda variabler för att ange e-postadresser i parametern notifyUsers.

När den manuella verifieringsaktiviteten aktiveras under en pipeline visas ett meddelandefält med en länk som öppnar dialogrutan Manuell validering, som innehåller instruktionerna. När du har utfört de manuella stegen kan administratören eller användaren välja att återuppta körningen eller avvisa den. Användare med Queue bygger behörighet på pipelinen kan återuppta eller avvisa körningen.

Exempel

  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'

I det här exemplet används timeoutInMinutes som är en gemensam uppgiftsegenskap tillgänglig i alla aktiviteter.

Kravspecifikation

Krav Beskrivning
Pipelinetyper YAML, klassisk version
Körs på Server
Krav Ingen
Kapaciteter Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion Alla agentversioner som stöds.
Aktivitetskategori Rulla ut