Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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 |