steps.task 定義

ステップによって task タスクが実行されます。

すべてのタスクで、次の一連の共通プロパティがサポートされます。

steps:
- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

この定義を参照する定義: ステップ

プロパティ

task 文字列。 最初のプロパティとして必須。
実行するタスクの名前。

inputs 文字列ディクショナリ。
タスクの入力。

condition 文字列。
この条件式を評価して、このタスクを実行するかどうかを判断します。

continueOnErrorboolean。
失敗しても実行を続けますか?

displayName 文字列。
タスクの人間が判読できる名前。

targetターゲット。
このタスクを実行する環境。

enabledboolean。
ジョブの実行時にこのタスクを実行しますか?

env 文字列ディクショナリ。
プロセスの環境にマップする変数。

name 文字列。
ステップの ID。 使用できる値: [-_A-Za-z0-9]*。

timeoutInMinutes 文字列。
サーバーによって強制終了されるまで、このタスクが完了するまでの時間。 たとえば、10 分のタイムアウトを構成するには、 を使用 timeoutInMinutes: 10します。

注意

パイプラインは、ジョブ レベルのタイムアウトで構成できます。 ステップが完了する前にジョブ・レベルのタイムアウト間隔が経過すると、ステップが長い timeoutInMinutes 間隔で構成されている場合でも、実行中のジョブ (ステップを含む) が終了します。 詳細については、「 タイムアウト」を参照してください。

retryCountOnTaskFailure 文字列。
タスクが失敗した場合の再試行回数。

注釈

タスクは、パイプラインの構成要素です。 選択できるタスクのカタログが存在します。

コマンド モードを指定しない場合は、target 構造体を次のように短縮できます。

- task:
  target: string  # container name or the word 'host'

一般的なタスクプロパティ

すべてのタスクでは、 と inputsに加えて、一連の共通プロパティがnameサポートされています。 一般的なタスク プロパティの一覧については、前の 「プロパティ 」セクションを参照してください。 これらのプロパティの構成の詳細については、「 タスクコントロールのオプション 」と「 タスク環境変数」を参照してください。

条件、タイムアウト、ステップ ターゲットの詳細を確認します。

例

steps:
- task: VSBuild@1
  displayName: Build
  timeoutInMinutes: 120
  inputs:
    solution: '**\*.sln'

関連項目

• タスク
• タスクのカタログ