Bagikan melalui

ManualValidation@1 - Tugas validasi manual v1

Jeda eksekusi alur untuk menunggu interaksi manual. Hanya berfungsi dengan alur YAML.

Sintaksis

# 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: true # boolean. Allow approvers to approve their own run. Default: true.
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

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

Input

notifyUsers - Memberi tahu pengguna
string. Diperlukan.

Kirim email tertunda validasi manual ke daftar pengguna tertentu (atau grup) yang dipisahkan koma. Anda dapat mengirim email ke grup menggunakan sintaks nama [org name]\group. Jika Anda dapat mengedit alur, Anda memiliki izin untuk menambahkan alamat email ke notifyUsers. Tidak diperlukan izin tambahan.

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


Pemberi Persetujuan
string.

Tentukan daftar pengguna/grup/tim proyek yang dipisahkan koma untuk bertindak berdasarkan validasi manual. Dengan tidak adanya input, pengguna dengan izin build antrean akan dapat mengambil tindakan.


allowApproversToApproveTheirOwnRuns - Izinkan pemberi persetujuan menyetujui eksekusi mereka sendiri
boolean. Nilai default: true.

Jika ini benar, pemberi persetujuan akan dapat menyetujui eksekusi mereka sendiri.


allowApproversToApproveTheirOwnRuns - Izinkan pemberi persetujuan menyetujui eksekusi mereka sendiri
boolean. Nilai default: false.

Jika ini benar, pemberi persetujuan akan dapat menyetujui eksekusi mereka sendiri.


Instruksi
string.

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


onTimeout - 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 yang lebih awal.


Opsi kontrol tugas

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

Variabel output

Tidak.

Komentar

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 alur YAML.

Tugas Validasi Manual memungkinkan Anda menjeda eksekusi alur dalam tahap, biasanya untuk melakukan beberapa langkah atau tindakan manual, lalu melanjutkan 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 instruksi parameter 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 timeoutInMinutes opsional, yang tersedia di properti tugas umum .

Nota

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

Ujung

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

Saat tugas Validasi Manual diaktifkan selama alur, tugas akan 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 build antrean izin 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@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'

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

Persyaratan

Syarat Deskripsi
Jenis alur YAML, Build klasik
Berjalan pada Peladen
Permintaan Tidak
Kemampuan Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah Apa pun
variabel yang Dapat Diatur Apa pun
Versi agen Semua versi agen yang didukung.
Kategori tugas Menyebarkan
  • Last updated on