Partilhar via


definição steps.task

Uma etapa task executa uma tarefa.

Todas as tarefas suportam o 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 esta definição: etapas

Propriedades

task string. Obrigatório como primeira propriedade.
Nome da tarefa a ser executada.

inputs dicionário de cordas.
Entradas para a tarefa.

condition string.
Avalie essa expressão de condição para determinar se essa tarefa deve ser executada.

continueOnError booleano.
Continuar a correr mesmo em caso de falha?

displayName string.
Nome legível por humanos para a tarefa.

target alvo.
Ambiente no qual executar esta tarefa.

enabled booleano.
Executar esta tarefa quando o trabalho é executado?

env dicionário de cordas.
Variáveis a serem mapeadas no ambiente do processo.

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

timeoutInMinutes string.
Tempo para esperar que esta tarefa seja concluída 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 decorrer 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 maior. Para obter mais informações, consulte Tempos limite.

retryCountOnTaskFailure string.
Número de novas tentativas se a tarefa falhar. No Azure DevOps Server 2022, 2022.1 e 2022.2, as novas tentativas são suportadas apenas em trabalhos de agente. Para obter mais informações, consulte atualização do serviço Azure DevOps 16 de novembro de 2021 - Repetições automáticas para um de tarefas e atualização do serviço Azure DevOps 14 de junho de 2025 - Repetições para 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á encurtar a estrutura target para:

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

Propriedades comuns da tarefa

Todas as tarefas suportam um conjunto de propriedades comuns, além de name e inputs. Para obter uma lista de propriedades de tarefas comuns, 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 etapas alvos.

Exemplos

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

Ver também