Partage via


Éditeur de pipeline YAML

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Azure Pipelines fournit un éditeur de pipeline YAML que vous pouvez utiliser pour créer et modifier vos pipelines. L’éditeur YAML est basé sur l’éditeur Monaco. L’éditeur fournit des outils tels que la prise en charge d’Intellisense et un assistant de tâches pour fournir des conseils lors de la modification d’un pipeline.

Cet article vous montre comment modifier vos pipelines à l’aide de l’éditeur de pipeline YAML, mais vous pouvez également modifier des pipelines en modifiant le fichier azure-pipelines.yml directement dans le référentiel de votre pipeline à l’aide de l’éditeur de texte de votre choix, ou à l’aide d’un outil comme Visual Studio Code et de l’extension Azure Pipelines pour VS Code.

Important

L’éditeur de pipeline YAML a été introduit dans Azure DevOps Server 2019 Update 1. Si vous utilisez Azure DevOps Server 2019 RTW, l’éditeur de pipeline YAML décrit dans cet article n’est pas disponible, mais vous pouvez modifier votre YAML à l’aide de l’éditeur de texte de votre choix et le vérifier dans le référentiel de votre pipeline.

Modifier un pipeline YAML

Pour accéder à l’éditeur de pipeline YAML, procédez comme suit.

  1. Connectez-vous à votre organisation (https://dev.azure.com/{yourorganization}).

  2. Sélectionnez votre projet, choisissez Pipelines>Pipelines, puis sélectionnez le pipeline que vous souhaitez modifier.

    Azure Pipelines s’appuie sur Azure DevOps Server 2019 Update 1.

  3. Choisissez Modifier.

    Bouton Modifier YAML Azure Pipelines dans Azure DevOps Server 2019 Update 1.

  4. Apportez des modifications à votre pipeline à l’aide des raccourcis clavier IntelliSense et de l’assistant Tâche pour obtenir des conseils.

    Éditeur de pipeline YAML dans Azure DevOps Server * 2019.1.

Pour accéder à l’éditeur de pipeline YAML, procédez comme suit.

  1. Connectez-vous à votre organisation (https://dev.azure.com/{yourorganization}).

  2. Sélectionnez votre projet, choisissez Pipelines, puis sélectionnez le pipeline que vous souhaitez modifier. Vous pouvez parcourir les pipelines par Récents, Tous et Exécutions. Pour plus d’informations, consultez Afficher et gérer vos pipelines.

    Page d’arrivée Azure Pipelines.

  3. Choisissez Modifier.

    Bouton Modifier YAML Azure Pipelines.

  4. Apportez des modifications à votre pipeline à l’aide d’IntelliSense et de l’assistant Tâche pour obtenir des conseils.

    Éditeur de pipeline YAML.

  1. Choisissez Enregistrer. Vous pouvez valider directement dans votre branche, ou créer une branche et éventuellement démarrer une demande de tirage (pull request).

    Fenêtre d’enregistrement de l’éditeur de pipeline YAML.

  1. Sélectionnez Valider et sauvegarder. Vous pouvez valider directement dans votre branche, ou créer une branche et éventuellement démarrer une demande de tirage (pull request).

    Capture d’écran montrant l’éditeur de pipeline YAML valider et enregistrer la fenêtre.

Utiliser les raccourcis clavier

L’éditeur de pipeline YAML fournit plusieurs raccourcis clavier, que nous montrons dans les exemples suivants.

  • Choisissez Ctrl+Espace pour la prise en charge d’IntelliSense pendant que vous modifiez le pipeline YAML.

    Éditeur de pipeline YAML IntelliSense.

  • Choisissez F1 (Fn+F1 sur Mac) pour afficher la palette de commandes et afficher les raccourcis clavier disponibles.

    Palette de commandes de l’éditeur de pipeline YAML.

Utiliser l’assistant Tâche

L’assistant Tâche fournit une méthode pour ajouter des tâches à votre pipeline YAML.

  • Pour afficher l’assistant Tâche, modifiez votre pipeline YAML et choisissez Afficher l’assistant.

    Afficher l’assistant Demander pour modifier les pipelines YAML.

  • Pour masquer l’assistant Tâche, choisissez Masquer l’assistant.

    Masquer l’assistant Tâche pour modifier les pipelines YAML.

  • Pour utiliser l’assistant Tâche, parcourez ou recherchez des tâches dans le volet Tâches.

    Recherche dans l’assistant Tâche.

  • Sélectionnez la tâche souhaitée et configurez ses entrées.

    Ajouter l’assistant Tâche.

  • Choisissez Ajouter pour insérer la tâche YAML dans votre pipeline.

Assistant Tâche ajouté dans Azure DevOps Server 2019.

  • Modifiez le YAML inséré pour apporter d’autres modifications de configuration à la tâche.

Assistant Tâche ajouté.

  • Vous pouvez modifier le YAML pour apporter davantage de modifications de configuration à la tâche, ou vous pouvez choisir Paramètres au-dessus de la tâche dans l’éditeur de pipeline YAML pour configurer la tâche insérée dans l’assistant Tâche.

Valider

Validez vos modifications pour détecter les erreurs de syntaxe dans votre pipeline qui l’empêchent de démarrer. Choisissez Autres actions>Valider.

Valider et télécharger l’intégralité de YAML.

Azure Pipelines valide vos pipelines chaque fois que vous sauvegardez. Sélectionnez Valider et sauvegarder pour valider votre pipeline avant la sauvegarde. En cas d’erreur, vous pouvez annuler ou sauvegardez quand même. Pour enregistrer votre pipeline sans validation, sélectionnez Sauvegarder sans validation.

Capture d’écran montrant le bouton Valider et enregistrer.

Azure Pipelines détecte les définitions de variables incorrectes définies au niveau du pipeline, de l’étape et du travail et détecte les conditions YAML incorrectes définies au niveau du pipeline, de l’étape et du travail.

Télécharger le fichier YAML complet

Vous pouvez afficher un aperçu du document YAML entièrement analysé sans valider ou exécuter le pipeline. Choisissez Autres actions>Télécharger l’intégralité de YAML.

Valider et télécharger l’intégralité de YAML.

Téléchargez l’API REST Azure DevOps pour Azure Pipelines et lancez un téléchargement du YAML rendu à partir de l’éditeur.

Gérer les variables de pipeline

Vous pouvez gérer les variables de pipeline à partir de votre pipeline YAML et à partir de l’interface utilisateur des paramètres de pipeline.

Avec Azure DevOps 2019 Update 1, vous pouvez gérer vos variables de pipeline à l’aide de l’interface utilisateur des paramètres de pipeline.

Pour gérer les variables de pipeline, procédez comme suit.

  1. Modifiez votre pipeline YAML et choisissez Variables pour gérer les variables de pipeline.

    Bouton Gérer les variables de pipeline.

  2. Choisissez parmi les fonctions suivantes :

    • Nouvelle variable : pour ajouter votre première variable.
    • Ajouter : pour ajouter des variables ultérieures.
    • Nom de la variable pour modifier une variable.
    • Supprimer : pour supprimer une variable.

    Gérer les variables de pipeline dans l’éditeur YAML.

Pour gérer les variables de pipelines dans l’interface utilisateur des paramètres du pipeline, procédez comme suit.

  1. Modifiez le pipeline et choisissez Autres actions>Déclencheurs.

    Interface utilisateur des paramètres du pipeline.

  2. Choisissez Variables.

    Interface utilisateur des paramètres du pipeline pour les variables.

Pour plus d’informations sur l’utilisation des variables du pipeline, consultez Définir des variables.

Configurer le pool d’agents par défaut

Si un pipeline YAML ne spécifie pas de pool d’agents, le pool d’agents configuré dans le paramètre Pool d’agents par défaut pour YAML est utilisé. Ce pool est également utilisé pour les tâches de nettoyage post-exécution.

Pour afficher et configurer le paramètre Pool d’agents par défaut pour le YAML :

  1. Modifiez le pipeline et choisissez Autres actions>Déclencheurs.

    Capture d’écran du menu d’interface utilisateur des paramètres de pipeline.

  2. Choisissez YAML, puis sélectionnez le pool d’agents souhaité à l’aide de la liste déroulante Pool d’agents par défaut pour YAML.

    Capture d’écran du pool d’agents par défaut pour les pipelines YAML.

Le Pool d’agents par défaut pour YAML est configuré par pipeline.

Gérer les paramètres à l’aide de l’interface utilisateur des paramètres de pipeline

Certains paramètres de pipeline YAML sont configurés à l’aide de l’interface utilisateur des paramètres de pipeline au lieu du fichier YAML.

  1. Modifiez le pipeline et choisissez Autres actions>Déclencheurs.

    Capture d’écran du menu d’interface utilisateur des paramètres de pipeline.

  2. Dans l’interface utilisateur des paramètres de pipeline, choisissez l’onglet du paramètre à configurer.

    Capture d’écran de l’interface utilisateur des paramètres de pipeline pour les déclencheurs.

Afficher et modifier des modèles

Remarque

Cette fonctionnalité est disponible à partir d’Azure DevOps Server 2022.1.

Les modèles sont une fonctionnalité couramment utilisée au sein des pipelines YAML. Il s’agit d’un moyen simple de partager des extraits de code de pipeline et d’un mécanisme puissant pour vérifier et appliquer la sécurité et la gouvernance dans votre pipeline. Auparavant, l’éditeur ne prenait pas en charge les modèles, de sorte que les auteurs de pipelines YAML ne pouvaient pas obtenir d’aide IntelliSense. À présent, Azure Pipelines prend en charge un éditeur YAML, pour lequel nous effectuons un aperçu de la prise en charge. Pour activer cette préversion, accédez à la préversion des fonctionnalités dans votre organisation Azure DevOps, puis activez l’éditeur de modèles YAML.

Important

Cette fonctionnalité présente les limitations suivantes.

  • Si le modèle a des paramètres requis qui ne sont pas fournis en tant qu’entrées dans le fichier YAML principal, la validation échoue et vous invite à fournir ces entrées.

  • Vous ne pouvez pas créer un nouveau modèle à partir de l’éditeur. Vous pouvez uniquement utiliser ou modifier des modèles existants.

Lorsque vous modifiez votre fichier principal YAML Azure Pipelines, vous pouvez inclure ou étendre un modèle. Lorsque vous entrez le nom de votre modèle, vous pouvez être invité à valider votre modèle. Une fois validé, l’éditeur YAML comprend le schéma du modèle, y compris les paramètres d’entrée.

Modèle YAML.

Après validation, vous pouvez accéder au modèle en choisissant Afficher le modèle, ce qui ouvre le modèle dans un nouvel onglet du navigateur. Vous pouvez apporter des modifications au modèle à l’aide de toutes les fonctionnalités de l’éditeur YAML.

Étapes suivantes