Créer votre premier pipeline

Il s'agit d'un guide étape par étape sur l'utilisation d'Azure Pipelines pour créer un exemple d'application à partir d'un référentiel Git. Ce guide utilise des pipelines YAML configurés avec l’éditeur de pipeline YAML.

Pour plus d’informations sur les différentes sections d’un pipeline YAML, consultez le pipeline dans le schéma YAML Azure Pipelines et personnalisez votre pipeline YAML.

Si vous préférez utiliser des pipelines classiques, consultez Définition d’un pipeline classique. Pour obtenir des conseils sur l'utilisation de TFVC, consultez Créer des référentiels TFVC.

Prérequis (Azure DevOps)

Vérifiez que vous disposez des éléments suivants :

• Un compte GitHub dans lequel vous pouvez créer un référentiel. Créez-en un gratuitement.

• Une organisation Azure DevOps. Créez-en un gratuitement. Si votre équipe en a déjà une, vérifiez que vous êtes bien un administrateur du projet Azure DevOps que vous souhaitez utiliser.

• Possibilité d’exécuter des pipelines sur des agents hébergés par Microsoft. Pour utiliser des agents hébergés par Microsoft, votre organisation Azure DevOps doit avoir accès aux travaux parallèles hébergés par Microsoft. Vous pouvez acheter un travail parallèle ou demander des travaux gratuits.

Créer votre premier pipeline

https://github.com/MicrosoftDocs/pipelines-java

https://github.com/MicrosoftDocs/pipelines-dotnet-core

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

https://github.com/Azure-Samples/js-e2e-express-server

Affichage et gestion des pipelines

Pour afficher et gérer vos pipelines, choisissez Pipelines dans le menu de gauche afin d’accéder à la page d’arrivée des pipelines.

Sur la page d’arrivée des pipelines, vous pouvez afficher les pipelines et les exécutions de pipeline, créer et importer des pipelines, gérer la sécurité et explorer les informations relatives aux pipelines et aux exécutions.

Choisissez Récent pour afficher les pipelines récemment exécutés (affichage par défaut), ou Tout pour voir tous les pipelines.

Sélectionnez un pipeline pour gérer ce pipeline et afficher les exécutions. Sélectionnez soit le numéro de build de la dernière exécution pour afficher les résultats de cette build, soit le nom de la branche pour afficher la branche dans le cadre de cette exécution, soit le menu contextuel pour exécuter le pipeline et effectuer d’autres actions de gestion.

Sélectionnez Exécutions pour afficher toutes les exécutions de pipeline. Vous pouvez éventuellement filtrer les exécutions affichées.

Sélectionnez une exécution de pipeline pour afficher les informations la concernant.

Vous pouvez choisir de Conserver ou de Supprimer une exécution dans le menu contextuel. Pour plus d’informations sur la rétention des exécutions, consultez Stratégies de rétention de build et de mise en production.

Détails du pipeline

La page d’informations d’un pipeline vous permet de l’afficher et de le gérer.

Choisissez Modifier pour modifier votre pipeline. Pour plus d’informations, consultez l’éditeur de pipeline YAML. Vous pouvez également modifier votre pipeline en modifiant le fichier azure-pipelines.yml directement dans le référentiel qui héberge le pipeline.

Afficher les détails de l’exécution du pipeline

Dans le résumé de l’exécution de pipeline, vous pouvez afficher l’état de votre exécution, à la fois pendant et après.

Dans le volet Résumé, vous pouvez afficher les informations relatives au travail et à la phase, télécharger des artefacts et accéder aux commits liés, aux résultats de test et aux éléments de travail.

Travaux et phases

Le volet Travaux affiche une vue d’ensemble de l’état de vos phases et travaux. Il peut comporter plusieurs onglets selon que votre pipeline comporte des phases et des travaux, ou seulement des travaux. Dans l’exemple suivant, le pipeline se compose de deux phases nommées Build et Deploy. Pour les explorer, choisissez le travail dans le volet Phases ou Travaux.

Choisissez un travail pour afficher ses étapes.

La vue Étapes permet de passer en revue l’état et le détail de chaque étape. Dans la section Plus d'actions, vous pouvez modifier l'horodatage ou afficher un journal brut de toutes les étapes du pipeline.

Annulation et réexécution d’un pipeline

Si le pipeline est en cours d’exécution, vous pouvez l’annuler en choisissant Annuler. Une fois l’exécution terminée, choisissez Exécuter nouveau si vous souhaitez réexécuter le pipeline.

Menu Autres actions de l’exécution de pipeline

Dans le menu Plus d'actions, vous pouvez télécharger des journaux, ajouter des balises, modifier le pipeline, supprimer l'exécution et configurer la rétention pour l'exécution.

Ajout d’un badge d’état au référentiel

De nombreux développeurs aiment montrer qu’ils maintiennent la qualité de leur code à un niveau élevé en affichant un badge d’état dans leur dépôt.

Pour copier le badge d’état dans votre Presse-papiers, procédez comme suit :

1. Dans Azure Pipelines, accédez à la page Pipelines pour afficher la liste des pipelines. Sélectionnez le pipeline que vous avez créé dans la section précédente.

2. Sélectionnez , puis Badge d’état.

3. Sélectionnez Badge d’état.

4. Copiez l’exemple Markdown de la section Exemple Markdown.

Maintenant que le badge Markdown est copié dans votre Presse-papiers, procédez comme suit dans GitHub :

1. Accédez à la liste des fichiers et sélectionnez Readme.md. Sélectionnez l’icône en forme de crayon pour le modifier.

2. Collez le badge d’état Markdown au début du fichier.

3. Commitez les modifications apportées à la branche main.

4. Le badge d’état apparaît dans la description de votre référentiel.

Pour configurer l’accès anonyme aux badges dans les projets privés, procédez comme suit :

1. Accédez aux Paramètres du Projet dans le coin inférieur gauche de la page

2. Ouvrez l’onglet Paramètres sous Pipelines.

3. Basculez le curseur Désactiver l’accès anonyme aux badges sous Général.

Comme vous venez de modifier le fichier Readme.md dans ce référentiel, Azure Pipelines génère automatiquement votre code, en fonction de la configuration du fichier azure-pipelines.yml qui se trouve à la racine de votre référentiel. Revenez dans Azure Pipelines : une nouvelle exécution s’affiche. Chaque fois que vous apportez une modification, Azure Pipelines lance une nouvelle exécution.

Nous allons voir comment utiliser l’éditeur classique dans Azure DevOps Server 2019 pour créer une build et une mise en production qui imprime « Hello world ».

1. Accédez à Azure Repos (le hub Code dans la navigation précédente).

   

2. Si votre projet est vide, un écran d’accueil vous aide à ajouter du code à votre référentiel. Choisissez l’option située en bas pour initialiser votre référentiel avec un fichier readme :

   

1. Accédez à Azure Repos

2. Ajoutez un fichier.

   

3. Dans la boîte de dialogue, donnez un nom à votre nouveau fichier et créez-le.

   HelloWorld.ps1
   

4. Copiez et collez ce script.

   Write-Host "Hello world"
   

5. Commitez (enregistrez) le fichier.

1. Sélectionnez Azure Pipelines pour accéder automatiquement à la page Builds.

   

2. Créer un pipeline

   

   Les nouveaux utilisateurs Azure DevOps sont automatiquement dirigés vers l’expérience de création de pipeline YAML. Pour accéder à l’éditeur classique et suivre ce guide, vous devez désactiver la fonctionnalité d’évaluation de l’expérience de création de pipeline YAML :

   

   

3. Assurez-vous que la source, le projet, le référentiel et la branche par défaut correspondent à l’emplacement dans lequel vous avez créé le script.

4. Partez d’un Travail vide.

5. Sur le côté gauche, sélectionnez Pipeline et spécifiez le Nom que vous souhaitez utiliser. Pour Pool d’agents, sélectionnez VS2017 hébergé.

6. Sur le côté gauche, sélectionnez le signe plus (+) pour ajouter une tâche au travail 1. Sur le côté droit, sélectionnez la catégorie Utilitaire, puis la tâche PowerShell dans la liste. Choisissez ensuite Ajouter.

   

7. Sur le côté gauche, sélectionnez votre nouvelle tâche de script PowerShell.

8. Pour l’argument Chemin du script, sélectionnez le bouton permettant de parcourir votre référentiel, puis le script que vous avez créé.

   

9. Sélectionnez Enregistrer et mettre en file d’attente, puis Enregistrer.

1. Dans l’onglet Tâches, sélectionnez le signe plus (+) pour ajouter une tâche au travail 1.

2. Sélectionnez la catégorie Utilitaire, puis la tâche Publier les artefacts de build. Choisissez ensuite Ajouter.

   

   Chemin de la publication : sélectionnez le bouton pour parcourir les fichiers et sélectionnez le script que vous avez créé.

   Nom de l’artefact : entrez drop.

   Emplacement de publication des artefacts : sélectionnez Azure Artifacts/TFS.

1. Sélectionnez Enregistrer et mettre en file d’attente, puis Enregistrer et mettre en file d’attente.

2. Dans la boîte de dialogue, sélectionnez de nouveau Enregistrer et mettre en file d’attente.

   Cette action a pour effet de mettre en file d’attente une nouvelle build sur l’agent hébergé par Microsoft.

3. Le lien de la nouvelle build apparaît en haut de la page.

   

   Sélectionnez le lien pour suivre le déroulement de la nouvelle build. Les journaux d’activité de la build commencent à apparaître une fois l’agent alloué. Le script PowerShell est exécuté dans le cadre de la build, et le message « Hello world » est imprimé dans la console.

   

4. Accédez au résumé de la build. Dans l’onglet Artefacts de la build, le script est publié en tant qu’artefact.

   

Vous pouvez maintenant voir les résultats de vos modifications. Accédez à Azure Pipelines et sélectionnez En file d’attente. Sous la section En file d’attente ou en cours d’exécution, une build est automatiquement déclenchée par la modification que vous avez commitée.

1. Accédez à l’onglet Pipelines, puis sélectionnez Mises en production.

2. Sélectionnez l’action permettant de créer un Nouveau pipeline. S’il existe déjà un pipeline de mise en production, sélectionnez le signe plus (+), puis Créer un pipeline de mise en production.

3. Sélectionnez l’action permettant de partir d’un Travail vide.

4. Nommez la phase AQ.

5. Dans le panneau Artefacts, sélectionnez + Ajouter et spécifiez une Source (pipeline de build). Sélectionnez Ajouter.

6. Sélectionnez l’éclair pour déclencher le déploiement continu, puis activez le déclencheur de déploiement continu sur la droite.

   

7. Sélectionnez l’onglet Tâches, puis votre phase AQ.

8. Sélectionnez le signe plus (+) associé au travail pour ajouter une tâche au travail.

9. Dans la boîte de dialogue Ajouter des tâches, sélectionnez Utilitaire, recherchez la tâche PowerShell, puis sélectionnez son bouton Ajouter.

10. Sur le côté gauche, sélectionnez votre nouvelle tâche de script PowerShell.

11. Pour l’argument Chemin du script, sélectionnez le bouton permettant de parcourir vos artefacts, puis le script que vous avez créé.

12. Ajoutez les arguments suivants :

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    

13. Dans l’onglet Pipeline, sélectionnez la phase AQ, puis Cloner.

    

14. Renommez la phase clonée Production.

15. Renommez le pipeline de mise en production Hello world.

    

16. Enregistrez le pipeline de mise en production.

1. Créez une mise en production.

   

   Lorsque Créer une mise en production s’affiche, sélectionnez Créer.

2. Ouvrez la mise en production que vous avez créée.

   

3. Affichez les journaux pour obtenir des données en temps réel sur la mise en production.

   

Vous avez appris à créer votre premier pipeline dans Azure. Maintenant, Apprenez-en plus sur la configuration des pipelines dans la langue de votre choix :

• .NET Core
• Go
• Java
• Node.JS
• Python
• Containers

Vous pouvez également personnaliser le pipeline que vous avez créé.

Pour exécuter votre pipeline dans un conteneur, consultez Travaux de conteneur.

Pour plus d’informations sur la création de référentiels GitHub, consultez Création de référentiels GitHub.

Pour apprendre à publier vos artefacts de pipeline, consultez Publication d’artefacts de pipeline.

Pour savoir ce qu’il est possible de faire d’autre dans les pipelines YAML, consultez Informations de référence sur le schéma YAML.

Nettoyage

Si vous avez créé des pipelines de test, il est facile de les supprimer lorsque vous les avez terminés.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

az pipelines list --output table

ID    Path    Name           Status    Default Queue
----  ------  -------------  --------  ------------------
6     \       FabrikamFiber  enabled   Hosted Ubuntu 1604

az pipelines delete --id 6

Are you sure you want to delete this pipeline? (y/n): y
Pipeline 6 was deleted successfully.

• Clients

  • Visual Studio Code pour Windows, macOS et Linux
  • Visual Studio avec Git pour Windows ou Visual Studio pour Mac
  • Eclipse
  • Xcode
  • IntelliJ
  • Ligne de commande

• Services

  • Azure Pipelines
  • Fournisseurs de services Git tels qu'Azure Repos Git, GitHub et Bitbucket Cloud
  • Subversion

Comment répliquer un pipeline ?

Si vous souhaitez répliquer le modèle de votre pipeline dans d’autres pipelines, clonez-le, exportez-le ou enregistrez-le en tant que modèle.

Une fois que vous avez cloné le pipeline, vous pouvez y apporter des modifications, puis l’enregistrer.

Après avoir exporté un pipeline, vous avez la possibilité de l’importer dans l’onglet Tous les pipelines.

Les membres de votre équipe peuvent suivre le modèle créé dans de nouveaux pipelines.

Comment utiliser les brouillons ?

Si vous modifiez un pipeline de build et que vous souhaitez tester certaines modifications qui ne sont pas encore prêtes pour la production, vous pouvez l’enregistrer en tant que brouillon.

Que peut-on faire d’autre lors de la mise en file d’attente d’une build ?

Les builds peuvent être mises en file d’attente automatiquement ou manuellement.

Lorsque vous mettez une build en file d’attente manuellement, vous pouvez, pour une seule exécution de celle-ci, effectuer les actions suivantes :

• Spécifiez le pool dans lequel ira la build.

• Ajoutez et modifiez certaines variables.

• Ajoutez des demandes.

• Effectuez les actions suivantes dans un référentiel Git :

  • Générez une branche ou une balise.

  • Générez un commit.

Pour plus d’informations sur les paramètres des pipelines, consultez les pages suivantes :

• Récupération des sources
• Tâches
• Variables
• Déclencheurs
• Rétention
• History

Comment créer programmatiquement un pipeline de build ?

Informations de référence sur l’API REST : Créer un pipeline de build