ManualValidation@1 – Manuell validering av v1-uppgift

Artikel
12/18/2024

Pausa en pipelinekörning för att vänta på manuell interaktion. Fungerar endast med YAML-pipelines.

Syntax

# Manual validation v1
# Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@1
  inputs:
    notifyUsers: # string. Required. Notify users. 
    #approvers: # string. Approvers. 
    #allowApproversToApproveTheirOwnRuns: false # boolean. Allow approvers to approve their own run. Default: false.
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

Ingångar

notifyUsers - Meddela användare
string. Krävs.

Skicka en manuell validering väntar på e-post till en kommaavgränsad lista över specifika användare (eller grupper). Du kan skicka ett e-postmeddelande till en grupp med hjälp av syntaxen för [org name]\group namn.

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: ''.

approvers - godkännare
string.

Ange en kommaavgränsad lista över användare/grupper/projektteam som ska utföra en manuell validering. Om det inte finns några indata kan användare med behörighet att skapa köer vidta åtgärder.

allowApproversToApproveTheirOwnRuns - Tillåt godkännare att godkänna sina egna
boolean. Standardvärde: false.

Om detta är sant kan godkännaren godkänna sin egen körning.

Viktig

Funktionerna för allowApproversToApproveTheirOwnRuns distribueras fortfarande till Azure DevOps och är för närvarande inte aktiverade.

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 aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. 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.

Viktig

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.

Not

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.

Dricks

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@1
      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.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version
Körs på	Server
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Någon
variabler som kan	Någon
Agentversion	Alla agentversioner som stöds.
Aktivitetskategori	Gruppera

Dela via