Partager via


définition steps.task

Une étape task exécute une tâche.

Toutes les tâches prennent en charge l’ensemble suivant de propriétés communes.

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.

Définitions qui font référence à cette définition : étapes

Propriétés

chaîne task. Obligatoire en tant que première propriété.
Nom de la tâche à exécuter.

inputs dictionnaire de chaînes.
Entrées pour la tâche.

chaîne condition.
Évaluer cette expression de condition pour déterminer s’il faut exécuter cette tâche.

continueOnError booléen .
Continuer à s’exécuter même en cas d’échec ?

chaîne displayName.
nom lisible par l’homme pour la tâche.

target cible .
Environnement dans lequel exécuter cette tâche.

enabled booléen .
Exécuter cette tâche lors de l’exécution du travail ?

env dictionnaire de chaînes.
Variables à mapper dans l’environnement du processus.

chaîne name.
ID de l’étape. Valeurs acceptables : [-_A-Za-z0-9]*.

chaîne timeoutInMinutes.
Délai d’attente de cette tâche avant que le serveur ne le tue. Par exemple, pour configurer un délai d’expiration de 10 minutes, utilisez timeoutInMinutes: 10.

Remarque

Les pipelines peuvent être configurés avec un délai d’expiration au niveau du travail. Si l’intervalle de délai d’expiration du niveau du travail s’écoule avant la fin de votre étape, le travail en cours d’exécution (y compris votre étape) est arrêté, même si l’étape est configurée avec un intervalle de timeoutInMinutes plus long. Pour plus d’informations, consultez délais d’expiration.

chaîne retryCountOnTaskFailure.
Nombre de nouvelles tentatives en cas d’échec de la tâche. Sur Azure DevOps Server 2022, 2022.1 et 2022.2, les nouvelles tentatives sont prises en charge uniquement sur les travaux d’agent. Pour plus d’informations, consultez mise à jour du service Azure DevOps le 16 novembre 2021 - Nouvelles tentatives automatiques pour une tâche et mise à jour du service Azure DevOps le 14 juin 2025 - Nouvelles tentatives pour les tâches serveur.

Remarques

Tâches sont les blocs de construction d’un pipeline. Il existe un catalogue de tâches disponibles.

Si vous ne spécifiez pas de mode de commande, vous pouvez raccourcir la structure target pour :

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

Propriétés de tâche courantes

Toutes les tâches prennent en charge un ensemble de propriétés communes en plus de name et de inputs. Pour obtenir la liste des propriétés de tâche courantes, consultez la section propriétés précédente. Pour plus d’informations sur la configuration de ces propriétés, consultez options de contrôle de tâche et variables d’environnement de tâche.

En savoir plus sur les conditions , les délais d’expiration et les cibles d’étape .

Exemples

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

Voir aussi