ManualValidation@0 – úloha ručního ověření v0

Článek
06/11/2024

Pomocí této úlohy můžete pozastavit spuštění kanálu YAML a čekat na ruční interakci.

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.

Vstupy

notifyUsers - Upozorňovat uživatele
string. Povinná hodnota.

Odešle e-mail čekající na ruční ověření konkrétním uživatelům (nebo skupinám). S ručním ověřením můžou pracovat jenom uživatelé s oprávněním k sestavení fronty. Pomocí syntaxe můžete skupině [org name]\group name poslat e-mail.

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

instructions - Pokyny
string.

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

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

Automaticky odmítne nebo obnoví toto ruční ověření po čekání na zadaný časový limit nebo 30 dnů podle toho, co nastane dříve.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tuto úlohu použijte v kanálu YAML k pozastavení spuštění v rámci fáze. Obvykle se provádí 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 podporovaná jenom v kanálech YAML a dá se použít jenom v úloze kanálu YAML bez agentů .

Úloha Ruční 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 pak pokračovat v kanálu. Uživatel může například muset ručně ověřit určité konfigurace nasazení, než kanál spustí dlouho běžící výpočetně náročnou úlohu.

Konfigurace úlohy Ruční ověření obsahuje parametr instrukcí , který se používá k poskytování souvisejících informací nebo k určení ručních kroků, které uživatel provede během pozastavení. Úlohu můžete nakonfigurovat tak, aby uživatelům a skupinám uživatelů posílala e-mailová oznámení, když čeká na kontrolu, a určit automatickou odpověď (odmítnutí nebo obnovení) po uplynutí konfigurovatelného časového limitu.

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

Poznámka

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

Tip

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

Když je úloha Ruční ověření aktivována během kanálu, zobrazí panel zpráv s odkazem, který otevře dialogové okno Ruční ověření, které obsahuje pokyny. Po provedení ručních kroků se správce nebo uživatel může rozhodnout, jestli má spuštění pokračovat, nebo ho odmítnout. Uživatelé s oprávněním k sestavení fronty v kanálu můžou spuštění pokračovat 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@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'

V tomto příkladu se používá timeoutInMinutesspolečná vlastnost úkolu , která je k dispozici ve všech úkolech.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení
Spustí se	Server
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	Všechny podporované verze agenta.
Kategorie úloh	Nasazení

Sdílet prostřednictvím