ManualValidation@0 - 手動検証 v0 タスク

構文

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

入力

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

解説

ステージ内で実行を一時停止するには、YAML パイプラインでこのタスクを使用します。 これは通常、さまざまな手動の手順またはアクションを実行するために実行され、実行が再開または拒否されます。

手動検証タスクを使用すると、ステージ内でパイプラインの実行を一時停止し、通常は何らかの手動手順またはアクションを実行してから、パイプラインを続行できます。 たとえば、パイプラインが実行時間が長く計算量の多いジョブを開始する前に、ユーザーが特定のデプロイ構成を手動で検証することが必要な場合があります。

手動検証タスクの構成には、関連情報を提供したり、ユーザーが一時停止中に実行する手動の手順を指定したりするために使用される instructions パラメーターが含まれています。 レビューを待機しているときにユーザーとユーザー グループに電子メール通知を送信するようにタスクを構成し、構成可能なタイムアウトが発生した後に自動応答 (拒否または再開) を指定できます。

タスクのタイムアウト値は、タスクの共通プロパティで使用可能な省略可能なtimeoutInMinutesパラメーターを使用して指定できます。

パイプライン中に手動検証タスクがアクティブ化されると、メッセージ バーにリンクが表示され、[手動検証] ダイアログが開きます。これには指示が含まれます。 手動の手順を実行した後、管理者またはユーザーは実行を再開するか拒否するかを選択できます。 パイプラインに対する キュー ビルド アクセス許可を持つユーザーは、実行を再開または拒否できます。

例

  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'

この例では、 を使用 timeoutInMinutes します。これは、すべてのタスクで使用できる共通のタスク プロパティ です。

要件