Partager via


Migrer votre pipeline classique vers YAML

Azure DevOps Services

Démarrez avec Azure Pipelines en convertissant votre pipeline classique existant pour utiliser YAML. Avec un pipeline YAML, vous pouvez implémenter votre stratégie CI/CD en tant que code et consulter son historique, comparer les versions, rendre responsable, annoter, etc.

Lorsque vous convertissez votre pipeline Classic, vous obtenez deux pipelines. Vous aurez un nouveau pipeline YAML et un pipeline classique qui peut être retiré. L'historique d'exécution de votre pipeline classique reste dans le pipeline classique.

Prérequis

Assurez-vous de disposer des éléments suivants avant de commencer.

  • Compte Azure avec un abonnement actif. Créez un compte gratuitement.
  • Organisation Azure DevOps active. Inscrivez-vous à Azure Pipelines.
  • Pipeline de travail qui utilise l’éditeur de l’interface utilisateur (IU) classique.
  • Exemple de fichier de pipeline YAML dans votre code. Créez un exemple de pipeline YAML dans la section suivante.

Créer un exemple de pipeline YAML

Procédez comme suit pour créer un exemple de pipeline YAML, que vous allez mettre à jour ultérieurement à l’aide de votre code exporté à partir de l’éditeur d’IU classique.

  1. Connectez-vous à votre organisation (https://dev.azure.com/{yourorganization}) et sélectionnez votre projet.

  2. Sélectionnez Pipelines, puis Nouveau pipeline.

    Deux boutons pour sélectionner la création d’un pipeline.

  3. Sélectionnez l’emplacement de votre code source en tant que GitHub ou Git Azure Repos.

    Liste des sélections possibles pour votre code source.

  4. Sélectionnez un dépôt.

    Page sur laquelle vous sélectionnez un référentiel pour votre pipeline de code source.

  5. Dans la page Configurer votre pipeline, sélectionnez Pipeline de démarrage.

    Liste des modèles à choisir pour configurer votre nouveau pipeline.

  6. Sélectionnez Enregistrer et exécuter.

    Page de revue sur laquelle vous sélectionnez Enregistrer et exécuter.

  7. Saisissez votre message de validation, sélectionnez Valider directement dans la branche primaire, puis sélectionnez à nouveau Enregistrer et exécuter. Une nouvelle exécution démarre et est validée dans le référentiel. Attendez la fin de l’exécution.

    Message de validation pour valider dans la branche primaire, puis pour sélectionner le bouton Enregistrer et exécuter.

Exporter votre pipeline classique

Procédez comme suit pour exporter votre pipeline classique vers un fichier YAML que vous pouvez utiliser dans l’éditeur.

  1. Accédez à Pipelines>Pipelines.

  2. Ouvrez votre pipeline classique dans le concepteur de construction classique.

  3. Sélectionnez les points de suspension (…), puis sélectionnez Exporter vers YAML.

    Capture d’écran du menu contextuel, pour exporter votre pipeline vers YAML.

  4. Ouvrez le fichier YAML téléchargé dans votre éditeur de code.

  5. Si votre pipeline YAML inclut des variables définies dans l’IU classique, définissez à nouveau les variables dans l’IU de vos paramètres de pipeline ou dans votre fichier YAML. Pour plus d’informations, consultez Définir des variables.

  6. Passez en revue les planifications cron dans votre fichier YAML. Par défaut, les planifications cron dans YAML sont au format UTC. Dans les pipelines classiques, elles sont dans le fuseau horaire de l’organisation. Pour en savoir plus, consultez Configurer les planifications pour les pipelines.

  7. Utilisez l’assistant de tâche pour apporter d’autres modifications au fichier YAML. L’assistant de tâche est un volet sur le côté droit de l’écran, qui vous permet de créer et de modifier correctement les étapes YAML.

    Configurer votre tâche de pipeline avec l’assistant de tâche.

  8. Enregistrez et exécutez votre pipeline.

Nettoyer les ressources

Si vous ne souhaitez plus utiliser cet exemple de pipeline, supprimez-le de votre projet. La suppression est permanente et inclut toutes les builds et tous les artefacts associés.

  1. Sélectionnez les points de suspension (…) et sélectionnez Supprimer.

  2. Saisissez le nom de votre pipeline pour le supprimer définitivement, puis sélectionnez Supprimer.

Forum aux questions

Existe-t-il une tâche dans les pipelines YAML pour créer des éléments de travail en cas d'échec de la construction ?

Les pipelines YAML n’ont pas de paramètre Créer un élément de travail en cas d’échec comme les pipelines de build classiques. Quelques options sont à votre disposition pour créer cette fonctionnalité vous-même.

Étapes suivantes

Découvrez les différences de fonctionnalités entre les pipelines YAML et classiques.