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

Wstrzymaj przebieg potoku, aby poczekać na interakcję ręczną. Działa tylko z potokami YAML.

Składnia

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

Wejścia

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

Wyślij wiadomość e-mail oczekującą na ręczną walidację do rozdzielonej przecinkami listy określonych użytkowników (lub grup). Możesz wysłać wiadomość e-mail do grupy przy użyciu składni nazwy [org name]\group.

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

approvers - osoby zatwierdzające
string.

Określ rozdzieloną przecinkami listę użytkowników/grup/zespołów projektu, które będą działać w celu ręcznego sprawdzania poprawności. W przypadku braku danych wejściowych użytkownicy z uprawnieniami do kompilacji kolejki będą mogli podejmować działania.

allowApproversToApproveTheirOwnRuns - Zezwalaj osobam zatwierdzających na zatwierdzanie własnych przebiegu
boolean. Wartość domyślna: false.

Jeśli tak jest, osoba zatwierdzająca będzie mogła zatwierdzić własny przebieg.

Ważny

Funkcja allowApproversToApproveTheirOwnRuns jest nadal wdrażana w usłudze Azure DevOps i obecnie nie jest włączona.

instructions - Instrukcje
string.

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

onTimeout - 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 zadaniami

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

Zmienne wyjściowe

Żaden.

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żny

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

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

Konfiguracja zadania ręcznej weryfikacji zawiera instrukcje parametru używanego do dostarczania 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, gdy oczekuje na przegląd, i określić automatyczną odpowiedź (odrzucanie lub wznawianie) po wystąpieniu konfigurowalnego limitu czasu.

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

Nuta

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

Napiwek

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

Gdy zadanie ręcznej walidacji jest aktywowane podczas potoku, wyświetla pasek komunikatu z linkiem, który otwiera okno dialogowe Ręczne sprawdzanie poprawności, które zawiera instrukcje. Po wykonaniu czynności ręcznych administrator lub użytkownik może wznowić przebieg lub odrzucić go. Użytkownicy z Queue kompilują uprawnienia do potoku mogą wznawiać lub odrzucać przebieg.

Przykłady

  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'

W tym przykładzie użyto timeoutInMinutes, która jest wspólną właściwością zadań dostępną we wszystkich zadaniach.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa na	Serwer
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadań	Wdrożyć