ManualValidation@0 - Tugas validasi manual v0

Artikel
06/11/2024

Gunakan tugas ini untuk menjeda eksekusi alur YAML untuk menunggu interaksi manual.

Sintaks

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

Input

notifyUsers - Memberi tahu pengguna
string. Wajib diisi.

Mengirim email tertunda validasi manual ke pengguna (atau grup) tertentu. Hanya pengguna dengan izin build antrean yang dapat bertindak berdasarkan validasi manual. Anda dapat mengirim email ke grup menggunakan sintaks.[org name]\group name

Input tugas ini diperlukan, tetapi Anda dapat menentukan string kosong jika Anda tidak ingin memberi tahu siapa pun, misalnya selama uji coba: notifyUsers: ''.

instructions - Petunjuk
string.

Menentukan instruksi yang ditampilkan kepada pengguna saat melanjutkan atau menolak intervensi manual. Berdasarkan instruksi ini, pengguna akan membuat keputusan berdasarkan informasi tentang intervensi manual ini.

onTimeout - Pada waktu habis
string. Nilai yang diizinkan: reject, resume. Nilai default: reject.

Secara otomatis menolak atau melanjutkan validasi manual ini setelah tertunda untuk batas waktu yang ditentukan, atau 30 hari, mana pun yang lebih awal.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini dalam alur YAML untuk menjeda eksekusi dalam tahap. Ini biasanya dijalankan untuk melakukan berbagai langkah atau tindakan manual dan kemudian eksekusi dilanjutkan atau ditolak.

Penting

Tugas ini hanya didukung dalam alur YAML dan hanya dapat digunakan dalam pekerjaan tanpa agen dari alur YAML.

Tugas Validasi Manual memungkinkan Anda menjeda eksekusi alur dalam tahap, biasanya untuk melakukan beberapa langkah atau tindakan manual, lalu melanjutkan dengan alur. Misalnya, pengguna mungkin perlu memvalidasi konfigurasi penyebaran tertentu secara manual sebelum alur memulai pekerjaan intensif komputasi yang berjalan lama.

Konfigurasi tugas Validasi Manual menyertakan parameter instruksi yang digunakan untuk memberikan informasi terkait atau untuk menentukan langkah manual yang dijalankan pengguna selama jeda. Anda dapat mengonfigurasi tugas untuk mengirim pemberitahuan email ke pengguna dan grup pengguna saat menunggu peninjauan dan menentukan respons otomatis (tolak atau lanjutkan) setelah batas waktu yang dapat dikonfigurasi terjadi.

Anda dapat menentukan nilai batas waktu untuk tugas menggunakan parameter opsional timeoutInMinutes , yang tersedia di properti tugas umum.

Catatan

Agar tugas berjalan sepenuhnya, timeoutInMinutes nilai pekerjaan (default = 60 minutes) yang berisi tugas ini harus lebih tinggi dari timeoutInMinutes nilai tugas itu sendiri. Lihat nilai batas waktu pekerjaan default.

Tip

Anda dapat menggunakan variabel untuk menentukan alamat email dalam notifyUsers parameter .

Saat tugas Validasi Manual diaktifkan selama alur, tugas menampilkan bilah pesan dengan tautan yang membuka dialog Validasi manual, yang berisi instruksi. Setelah melakukan langkah-langkah manual, administrator atau pengguna dapat memilih untuk melanjutkan eksekusi atau menolaknya. Pengguna dengan izin build Antrean pada alur dapat melanjutkan atau menolak eksekusi.

Contoh

  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'

Contoh ini menggunakan timeoutInMinutesyang merupakan properti tugas umum yang tersedia di semua tugas.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Server
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	Semua versi agen yang didukung.
Kategori tugas	Sebarkan

Bagikan melalui