ManualValidation@0 — zadanie ręcznej weryfikacji w wersji 0

To zadanie służy do wstrzymania uruchomienia potoku YAML w celu oczekiwania na ręczną interakcję.

Składnia

# 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.

Dane wejściowe

notifyUsers - Powiadamianie użytkowników
string. Wymagane.

Wysyła ręczną wiadomość e-mail oczekującą na walidację do określonych użytkowników (lub grup). Tylko użytkownicy z uprawnieniami do kompilacji kolejki mogą działać na ręcznej weryfikacji. Możesz wysłać wiadomość e-mail do grupy przy użyciu [org name]\group name składni.

Te dane wejściowe zadania są wymagane, ale można określić pusty ciąg, jeśli nie chcesz powiadamiać nikogo, na przykład podczas przebiegu testu: notifyUsers: ''.

instructions - Instrukcje
string.

Określa instrukcje wyświetlane użytkownikowi podczas wznawiania lub odrzucania interwencji ręcznej. Na podstawie tych instrukcji użytkownik podejmie świadomą decyzję o tej interwencji ręcznej.

onTimeout - Upłynął limit czasu
string. Dozwolone wartości: reject, resume. Wartość domyślna: reject.

Automatycznie odrzuca lub wznawia tę ręczną walidację po oczekiwaniu na określony limit czasu lub 30 dni, w zależności od tego, która z nich jest wcześniejsza.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

Użyj tego zadania w potoku YAML, aby wstrzymać przebieg w ramach etapu. Jest to zwykle wykonywane w celu wykonania różnych ręcznych kroków lub akcji, a następnie uruchomienie jest wznawiane lub odrzucane.

Ważne

To zadanie jest obsługiwane tylko w potokach YAML i może być używane tylko w bez agenta zadania potoku YAML.

Zadanie ręcznej walidacji umożliwia wstrzymanie przebiegu potoku w ramach etapu, zazwyczaj w celu wykonania kilku ręcznych kroków lub akcji, a następnie kontynuowania potoku. Na przykład użytkownik może wymagać ręcznego zweryfikowania niektórych konfiguracji wdrożenia przed rozpoczęciem długotrwałego zadania intensywnie korzystającego z obliczeń.

Konfiguracja zadania walidacji ręcznej zawiera parametr instrukcji używany do podawania powiązanych informacji lub określania ręcznych kroków wykonywanych przez użytkownika podczas wstrzymania. Zadanie można skonfigurować tak, aby wysyłało powiadomienia e-mail do użytkowników i grup użytkowników podczas oczekiwania na przegląd i określać automatyczną odpowiedź (odrzucanie lub wznawianie) po wystąpieniu konfigurowalnego limitu czasu.

Wartość limitu czasu zadania można określić przy użyciu opcjonalnego timeoutInMinutes parametru dostępnego we wspólnych właściwościach zadania.

Uwaga

Aby zadanie było uruchamiane całkowicie, timeoutInMinutes wartość zadania (default = 60 minutes) zawierającego to zadanie powinna być wyższa niż timeoutInMinutes wartość samego zadania. Zobacz domyślne wartości limitu czasu zadania.

Porada

Zmienne umożliwiają określenie adresów e-mail w parametrze notifyUsers .

Po aktywowaniu zadania walidacji ręcznej w potoku zostanie wyświetlony pasek komunikatów z linkiem, który otwiera okno dialogowe Walidacja ręczna, zawierające instrukcje. Po wykonaniu kroków ręcznych administrator lub użytkownik może zdecydować się na wznowienie przebiegu lub odrzucenie go. Użytkownicy z uprawnieniem do kompilacji kolejki w potoku mogą wznowić lub odrzucić przebieg.

Przykłady

  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'

W tym przykładzie użyto timeoutInMinutes wspólnej właściwości zadania dostępnej we wszystkich zadaniach.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna
Działa na	Serwer
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadania	Wdrażanie