steps.task definition

Un paso task ejecuta una tarea.

Todas las tareas admiten el siguiente conjunto de propiedades comunes.

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.

Definiciones que hacen referencia a esta definición: pasos

Propiedades

task cadena. Obligatorio como primera propiedad.
Nombre de la tarea que se va a ejecutar.

inputs diccionario de cadenas.
Entradas para la tarea.

condition cadena.
Evaluar esta expresión de condición para determinar si se debe ejecutar esta tarea.

continueOnError booleano .
Continuar ejecutándose incluso en caso de error?

displayName cadena.
nombre legible para la tarea.

target de destino .
entorno en el que se va a ejecutar esta tarea.

enabled booleano .
Ejecutar esta tarea cuando se ejecuta el trabajo?

env diccionario de cadenas.
variables que se van a asignar al entorno del proceso.

name cadena.
identificador del paso. Valores aceptables: [-_A-Za-z0-9]*.

timeoutInMinutes cadena.
Tiempo de espera para que se complete esta tarea antes de que el servidor lo mate. Por ejemplo, para configurar un tiempo de espera de 10 minutos, use timeoutInMinutes: 10.

Nota:

Las canalizaciones se pueden configurar con un tiempo de espera de nivel de trabajo. Si el intervalo de tiempo de espera del nivel de trabajo transcurre antes de que se complete el paso, se finaliza el trabajo en ejecución (incluido el paso), incluso si el paso está configurado con un intervalo de timeoutInMinutes más largo. Para obtener más información, vea Tiempos de espera.

retryCountOnTaskFailure cadena.
Número de reintentos si se produce un error en la tarea. En Azure DevOps Server 2022, 2022.1 y 2022.2, los reintentos solo se admiten en trabajos del agente. Para obtener más información, consulte actualización del servicio Azure DevOps el 16 de noviembre de 2021: reintentos automáticos para una tarea y actualización del servicio Azure DevOps el 14 de junio de 2025: reintentos para tareas de servidor.

Observaciones

tareas son los bloques de creación de una canalización. Hay un catálogo de tareas disponible para elegir.

Si no especifica un modo de comando, puede acortar la estructura de target a:

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

Propiedades comunes de la tarea

Todas las tareas admiten un conjunto de propiedades comunes además de name y inputs. Para obtener una lista de las propiedades de tarea comunes, consulte la sección propiedades de anterior. Para obtener más información sobre cómo configurar estas propiedades, consulte opciones de control de tareas y Variables de entorno de tarea.

Obtenga más información sobre las condiciones de , los tiempos de espera y los destinos de paso de .

Ejemplos

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

Consulte también

• Tareas
• Catálogo de tareas