ManualValidation@1 – úloha ručního ověření v1

Článek
12/18/2024

Pozastavte spuštění kanálu a počkejte na ruční interakci. Funguje jenom s kanály YAML.

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.

Vstupy

notifyUsers - oznámit uživatelům
string. Požadovaný.

Odeslání ručně čekajícího ověření e-mailu do seznamu oddělených čárkami konkrétních uživatelů (nebo skupin). E-mail můžete skupině poslat pomocí syntaxe názvu [org name]\group.

Tento vstup úkolu je povinný, ale můžete zadat prázdný řetězec, pokud nechcete nikoho informovat, například během testovacího spuštění: notifyUsers: ''.

approvers - schvalovatelé
string.

Zadejte čárkami oddělený seznam uživatelů, skupin nebo projektových týmů, které budou pracovat s ručním ověřením. Uživatelé s oprávněním k sestavení fronty nebudou moct provádět žádné vstupy.

allowApproversToApproveTheirOwnRuns - Povolit schvalovatelům schvalovat vlastní spuštění
boolean. Výchozí hodnota: false.

Pokud je to pravda, schvalovatel bude moct schválit své vlastní spuštění.

Důležitý

Funkce pro allowApproversToApproveTheirOwnRuns se stále nasazuje do Azure DevOps a aktuálně není povolená.

instructions - pokyny
string.

Určuje pokyny, které se uživateli zobrazí při obnovení nebo odmítnutí ručního ověření. Na základě těchto pokynů uživatel provede informované rozhodnutí o tomto ručním ověření.

onTimeout - Při vypršení časového limitu
string. Povolené hodnoty: reject, resume. Výchozí hodnota: reject.

Automatické odmítnutí nebo obnovení tohoto ručního ověření po čekání na uplynutí zadaného časového limitu nebo 30 dnů podle toho, co nastane dříve.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádný.

Poznámky

Tuto úlohu můžete použít v kanálu YAML k pozastavení spuštění v rámci fáze. Obvykle se to provede za účelem provedení různých ručních kroků nebo akcí a pak se spuštění obnoví nebo odmítne.

Důležitý

Tato úloha je podporována pouze v kanálech YAML a dá se použít pouze v úlohách bez agentů kanálu YAML.

Úloha ručního ověření umožňuje pozastavit spuštění kanálu v rámci fáze, obvykle provést některé ruční kroky nebo akce a potom pokračovat v kanálu. Uživatel může například muset ručně ověřit určité konfigurace nasazení před spuštěním dlouhotrvající úlohy náročné na výpočty.

Konfigurace úlohy ručního ověření obsahuje pokyny parametr, který slouží k poskytování souvisejících informací nebo k určení ručních kroků, které uživatel provede během pozastavení. Úkol můžete nakonfigurovat tak, aby odesílal e-mailová oznámení uživatelům a skupinám uživatelů, když čeká na revizi, a po konfigurovatelném vypršení časového limitu zadejte automatickou odpověď (odmítnutí nebo obnovení).

Hodnotu časového limitu úkolu můžete zadat pomocí volitelného parametru timeoutInMinutes, který je k dispozici v společných vlastnostech úkolu.

Poznámka

Aby se úloha spustila úplně, měla by být hodnota timeoutInMinutes úlohy (default = 60 minutes) obsahující tento úkol vyšší než timeoutInMinutes hodnota samotného úkolu. Viz výchozí hodnoty časového limitu úlohy.

Spropitné

Proměnné můžete použít k zadání e-mailových adres v parametru notifyUsers.

Když je úloha ručního ověření aktivována během kanálu, zobrazí panel zpráv s odkazem, který otevře dialogové okno ručního ověření, které obsahuje pokyny. Po provedení ručních kroků může správce nebo uživatel pokračovat ve spuštění nebo ho odmítnout. Uživatelé s buildy fronty oprávnění k kanálu můžou spuštění obnovit nebo odmítnout.

Příklady

  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'

Tento příklad používá timeoutInMinutes, což je společná vlastnost úkolu k dispozici ve všech úkolech.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení
Běží na	Server
požadavky	Žádný
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	Všechny podporované verze agenta.
Kategorie úkolu	Nasadit

Sdílet prostřednictvím