Informations de référence sur les tâches Azure Pipelines

Une tâche effectue une action dans un pipeline. Par exemple, une tâche peut créer une application, interagir avec les ressources Azure, installer un outil ou exécuter un test. Les tâches sont les blocs de construction pour définir l’automatisation dans un pipeline.

Les articles de cette section décrivent les tâches intégrées pour Azure Pipelines et spécifient la sémantique des attributs qui contiennent une signification particulière pour chaque tâche.

Reportez-vous à la référence YAML pour steps.task pour plus d’informations sur les attributs généraux pris en charge par les tâches.

Pour obtenir des didacticiels et des didacticiels sur la création de pipelines à l’aide de tâches, notamment la création de tâches personnalisées, d’extensions personnalisées et la recherche de tâches sur Visual Studio Marketplace, consultez concepts des tâches et documentation Azure Pipelines.

Libre

Ces tâches sont des open source sur GitHub. Les commentaires et les contributions sont les bienvenus. Consultez journal des modifications des tâches de pipeline pour obtenir la liste des modifications de tâche, y compris un enregistrement historique des mises à jour des tâches.

FAQ

Qu’est-ce que les alias d’entrée de tâche ?

Les entrées d’une tâche sont identifiées par un label, nameet peuvent inclure une ou plusieurs aliasesfacultatives. L’exemple suivant est un extrait du code source pour l’entrée hôtes connus de la tâche InstallSSHKey@0.

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

Avant que les pipelines YAML aient été introduits en 2019, les pipelines ont été créés et modifiés à l’aide d’un éditeur de pipeline basé sur l’interface utilisateur, et seuls les label ont été utilisés par les auteurs de pipelines pour référencer une entrée de tâche.

Lorsque des pipelines YAML ont été introduits en 2019, les auteurs de pipelines utilisant YAML ont commencé à utiliser l’entrée de tâche name pour faire référence à une entrée de tâche. Dans certains cas, les noms d’entrée de tâche n’étaient pas descriptifs. Par conséquent, aliases ont été ajoutés pour fournir des noms descriptifs supplémentaires pour les entrées de tâche.

Par exemple, la tâche InstallSSHKey@0 a une entrée hôtes connus entrée nommée hostName qui attend une entrée à partir d’un fichier known_hosts. L''étiquette d’entrée d’hôtes connus dans le concepteur de pipelines classique permet de l’effacer, mais ce n’est pas aussi clair lors de l’utilisation du nom hostName dans un pipeline YAML. Les alias d’entrée de tâche ont été introduits pour permettre aux auteurs de tâches de fournir des noms décriptifs pour leurs tâches précédemment créées et pour la tâche InstallSSHKey@0, un alias knownHostsEntrya été ajouté, tout en conservant le nom de hostName d’origine pour la compatibilité avec les pipelines existants à l’aide de ce nom.

Tous les éléments de la aliases d’une entrée de tâche sont interchangeables avec les name dans un pipeline YAML. Les deux extraits YAML suivants sont fonctionnellement identiques, avec le premier exemple utilisant l’alias knownHostsEntry et le deuxième exemple utilisant hostName.

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

À compter d’Azure DevOps Server 2019.1, l’éditeur de pipeline YAML a été introduit, qui fournit une fonctionnalité de type IntelliSense.

L’éditeur de pipeline YAML utilise la Yamlschema - Obtenir API REST pour récupérer le schéma utilisé pour la validation dans l’éditeur. Si une entrée de tâche a un alias, le schéma promeut l’alias au nom YAML principal de l’entrée de tâche, et l’alias est suggéré par IntelliSense.

L’exemple suivant est l’entrée de tâche hôtes connus pour la tâche InstallSSHKey@0 à partir du schéma YAML, avec knownHostsEntry répertoriées dans la position du nom et hostName dans la collection aliases.

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

Étant donné que l’intellisense dans l’éditeur de pipeline YAML affiche , et que le yaML généré par l’Assistant tâche utilise dans le YAML généré, la référence de tâche affiche les à partir du code source de la tâche en tant que nom YAML pour une entrée de tâche. Si une tâche a plusieurs alias (il existe quelques alias qui ont deux alias), le premier alias est utilisé comme nom.

Pourquoi la référence de tâche a-t-elle changé ?

La documentation de référence des tâches Azure Pipelines a été déplacée vers son emplacement actuel pour prendre en charge les améliorations suivantes.

• Les articles de tâche sont générés à l’aide du code source de la tâche à partir du dépôt open source des tâches Azure Pipelines .
• Les noms et alias d’entrée de tâche sont générés à partir de la source de tâche afin qu’ils soient toujours à jour.
• Les blocs de syntaxe YAML sont générés à partir de la source de tâche afin qu’ils soient à jour.
• Prend en charge les contributions de la communauté avec du contenu utilisateur intégré, comme des descriptions d’entrée de tâche améliorées, des remarques et des exemples.
• Fournit une couverture des tâches pour toutes les versions d’Azure DevOps prises en charge.
• Mise à jour de chaque sprint pour couvrir les dernières mises à jour.

Pour contribuer, consultez Contribution au contenu des tâches.

Où puis-je apprendre pas à pas comment créer mon application ?

Créer votre application

Puis-je ajouter mes propres tâches de génération ?

Oui : Ajouter une tâche de génération

Qu’est-ce que les tâches d’installation ?

Pour en savoir plus sur les tâches d’installation d’outils, consultez programmes d’installation des outils.