definição steps.task

Uma etapa task executa uma tarefa.

Todas as tarefas dão suporte ao seguinte conjunto de propriedades comuns.

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.

Definições que fazem referência a essa definição: etapas

Propriedades

task cadeia de caracteres. Obrigatório como primeira propriedade.
Nome da tarefa a ser executada.

inputs dicionário de cadeias de caracteres.
Entradas para a tarefa.

condition cadeia de caracteres.
Avaliar essa expressão de condição para determinar se essa tarefa deve ser executada.

continueOnError booliano.
Continuar em execução mesmo em caso de falha?

displayName cadeia de caracteres.
nome legível para a tarefa.

target de destino.
Ambiente no qual executar essa tarefa.

enabled booliano.
executar essa tarefa quando o trabalho for executado?

env dicionário de cadeias de caracteres.
variáveis a serem mapeadas para o ambiente do processo.

name cadeia de caracteres.
ID da etapa. Valores aceitáveis: [-_A-Za-z0-9]*.

timeoutInMinutes cadeia de caracteres.
hora de aguardar a conclusão dessa tarefa antes que o servidor a mate. Por exemplo, para configurar um tempo limite de 10 minutos, use timeoutInMinutes: 10.

Observação

Os pipelines podem ser configurados com um tempo limite de nível de trabalho. Se o intervalo de tempo limite do nível do trabalho se esgotar antes da conclusão da etapa, o trabalho em execução (incluindo a etapa) será encerrado, mesmo que a etapa esteja configurada com um intervalo de timeoutInMinutes mais longo. Para obter mais informações, consulte Timeouts.

retryCountOnTaskFailure cadeia de caracteres.
Número de repetições se a tarefa falhar. No Azure DevOps Server 2022, 2022.1 e 2022.2, as novas tentativas têm suporte apenas em trabalhos de agente. Para obter mais informações, consulte atualização de serviço do Azure DevOps em 16 de novembro de 2021 – Repetições automáticas de uma tarefa e atualização de serviço do Azure DevOps em 14 de junho de 2025 – Novas tentativas de tarefas de servidor.

Observações

Tarefas são os blocos de construção de um pipeline. Há um catálogo de tarefas disponíveis para escolha.

Se você não especificar um modo de comando, poderá reduzir a estrutura target para:

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

Propriedades comuns da tarefa

Todas as tarefas dão suporte a um conjunto de propriedades comuns, além de name e inputs. Para obter uma lista de propriedades comuns da tarefa, consulte a seção Propriedades do anterior. Para obter mais informações sobre como configurar essas propriedades, consulte Opções de controle de tarefa e Variáveis de ambiente de tarefa.

Saiba mais sobre condições, tempos limitee destinos de etapa.

Exemplos

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

Consulte também

• Tarefas
• Catálogo de tarefas