types de tâches et utilisation

Dans un fichier YAML, vous spécifiez la version principale en utilisant @ dans le nom de la tâche. Par exemple, pour épingler à la version 2 de la tâche PublishTestResults :

steps:
- task: PublishTestResults@2

Les pipelines YAML ne sont pas disponibles dans TFS.

Les options de contrôle sont disponibles sous forme de clés dans la section task.

- 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.
  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.

Les options de contrôle sont disponibles sous forme de clés dans la section task.

- 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.

Les options de contrôle sont disponibles sous forme de clés dans la section task.

- 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.

Le délai d’expiration commence au démarrage de l’exécution de la tâche. Il n’inclut pas le temps de mise en file d’attente de la tâche ni le temps d’attente d’un agent.

Dans ce YAML, PublishTestResults@2 s’exécute même si l’étape précédente échoue à cause de la condition succeededOrFailed().

steps:
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x'
    architecture: 'x64'
- task: PublishTestResults@2
  inputs:
    testResultsFiles: "**/TEST-*.xml"
  condition: succeededOrFailed()

Conditions

• Uniquement lorsque toutes les dépendances directes et indirectes précédentes avec le même pool d'agents réussissent. Si vous disposez de différents pools d'agents, ces étapes ou travaux s'exécutent simultanément. Cette condition est la condition par défaut si aucune condition n'est définie dans le YAML.

• Même si une dépendance précédente échoue, à moins que l'exécution ne soit annulée. Utilisez succeededOrFailed() dans le fichier YAML pour cette condition.

• Même si une dépendance précédente échoue, et même si l'exécution est annulée. Utilisez always() dans le fichier YAML pour cette condition.

• Uniquement en cas d'échec d'une dépendance précédente. Utilisez failed() dans le fichier YAML pour cette condition.

• Conditions personnalisées, qui sont composées d’expressions

Cible d’étape

Les tâches s’exécutent dans un contexte d’exécution, qui correspond soit à l’hôte de l’agent, soit à un conteneur. Une étape individuelle peut remplacer son contexte en spécifiant un target. Les options disponibles sont le mot host pour cibler l’hôte de l’agent ainsi que tous les conteneurs définis dans le pipeline. Par exemple :

resources:
  containers:
  - container: pycontainer
    image: python:3.11

steps:
- task: SampleTask@1
  target: host
- task: AnotherTask@1
  target: pycontainer

Ici, SampleTask s’exécute sur l’hôte et AnotherTask s’exécute dans un conteneur.

Nombre de tentatives si la tâche a échoué

Utilisez retryCountOnTaskFailure pour spécifier le nombre de nouvelles tentatives en cas d’échec de la tâche. La valeur par défaut est zéro nouvelle tentative. Pour plus d’informations sur les propriétés de tâche, consultez steps.task dans le schéma YAML.

- task: <name of task>
  retryCountOnTaskFailure: <max number of retries>
   ...

Les pipelines YAML ne sont pas disponibles dans TFS.

- task: AzureCLI@2
  displayName: Azure CLI
  inputs: # Specific to each task
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

L’exemple suivant exécute l’étape script, qui est correspond à un raccourci pour la tâche de ligne de commande, suivie de la syntaxe de la tâche équivalente. Cet exemple affecte une valeur à la variable d’environnement AZURE_DEVOPS_EXT_PAT, qui est utilisée pour l’authentification auprès de l’interface CLI Azure DevOps.

# Using the script shortcut syntax
- script: az pipelines variable-group list --output table
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'List variable groups using the script step'

# Using the task syntax
- task: CmdLine@2
  inputs:
    script: az pipelines variable-group list --output table
  env:
    AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)
  displayName: 'List variable groups using the command line task'

- task: Bash@3
  inputs:
     targetType: # specific to each task
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

L'exemple suivant exécute l'étape script, qui est un raccourci pour l'étape Bash@3, suivie de la syntaxe de la tâche équivalente. Cet exemple attribue une valeur à la variable d'environnement ENV_VARIABLE_NAME et la répercute.

# Using the script shortcut syntax
- script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: "my value"
  displayName: 'echo environment variable'

# Using the task syntax
- task: Bash@2
  inputs:
    script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: "my value"
  displayName: 'echo environment variable'

Créez un fichier azure-pipelines.yml dans le répertoire de base de votre projet avec le contenu suivant.

pool:
  vmImage: ubuntu-latest

steps:
# Node install
- task: UseNode@1
  displayName: Node install
  inputs:
    version: '16.x' # The version we're installing
# Write the installed version to the command line
- script: which node

Créez un pipeline de build et exécutez-le. Observez comment la build est exécutée. Le programme d’installation de l’outil Node.js télécharge la version Node.js si elle n’est pas déjà sur l’agent. Le script de ligne de commande journalise l’emplacement de la version Node.js sur le disque.

Les pipelines YAML ne sont pas disponibles dans TFS.