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

Prérequis

• Un agent Windows autohébergé

Initialisation du référentiel localement

Si votre projet comporte déjà un référentiel, vous pouvez passer à l’étape suivante, Ajout d’un script au référentiel.

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 :

   

Ajout d’un script au référentiel

Créez un script PowerShell qui imprime Hello world.

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.

Dans ce tutoriel, nous nous concentrons sur l’intégration continue et la livraison continue. C’est pourquoi nous nous en tenons à une partie code simple. Nous travaillons dans un référentiel Azure Repos Git directement dans votre navigateur web.

Dès que vous souhaiterez commencer à créer et déployer une application réelle, vous pourrez utiliser un large éventail de clients et de services de gestion de version avec les builds CI Azure Pipelines. Plus d’informations

Créer un pipeline de build

Créez un pipeline de build qui imprime « Hello world ».

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.

Un pipeline de build est l’entité qui permet de définir un pipeline de build automatisé. Dans le pipeline de build, vous composez un ensemble de tâches dont chacune effectue une étape de votre build. Le catalogue de tâches fournit un ensemble complet de tâches pour vous permettre de commencer. Vous pouvez également ajouter des scripts PowerShell ou shell à votre pipeline de build.

Publication d’un artefact à partir de la build

Une build classique produit un artefact qui peut ensuite être déployé sur différentes phases d’une mise en production. Pour illustrer simplement la fonctionnalité, nous nous contenterons ici de publier le script en tant qu’artefact.

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.

Les artefacts sont les fichiers que la build devra produire. Ils représentent presque tout ce dont votre équipe a besoin pour tester et déployer votre application. Par exemple, parmi eux figurent des fichiers exécutables .DLL et .EXE, ainsi qu’un fichier de symboles .PDB d’une application .NET Windows C# ou C++.

Des outils vous sont fournis pour vous permettre de produire des artefacts, notamment la copie avec critères spéciaux et un répertoire intermédiaire dans lequel vous pouvez rassembler vos artefacts avant de les publier (cf. Artefacts dans Azure Pipelines).

Activation de l’intégration continue (CI)

1. Sélectionnez l’onglet Déclencheurs.

2. Activez Intégration continue.

Un déclencheur d’intégration continue sur un pipeline de build indique que le système doit automatiquement mettre en file d’attente une nouvelle build chaque fois qu’une modification de code est commitée. Vous pouvez rendre le déclencheur plus général ou plus spécifique, et également planifier votre build, par exemple la nuit (cf. Déclencheurs de build).

Enregistrement de la build et mise en file d’attente

Enregistrez manuellement la build, mettez-la en file d’attente et testez votre pipeline de build.

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.

   

Ajout de variables et commit d’une modification du script

Nous allons passer certaines variables de build au script pour rendre notre pipeline un peu plus intéressant. Ensuite, nous commiterons une modification du script et regarderons le pipeline CI s’exécuter automatiquement pour valider la modification.

1. Modifiez votre pipeline de build.

2. Dans l’onglet Tâches, sélectionnez la tâche de script PowerShell.

3. Ajoutez les arguments suivants.

Arguments

-greeter "$(Build.RequestedFor)" -trigger "$(Build.Reason)"

Enfin, enregistrez le pipeline de build.

Vous allez maintenant ajouter les arguments à votre script.

1. Accédez à vos Fichiers dans Azure Repos (hub Code dans la navigation précédente et TFS).

2. Sélectionnez le fichier HelloWorld.ps1, puis sélectionnez Modifier pour modifier le fichier.

3. Modifiez le script comme suit :

   Param(
   [string]$greeter,
   [string]$trigger
   )
   Write-Host "Hello world" from $greeter
   Write-Host Trigger: $trigger
   

4. Commitez (enregistrez) le script.

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. Sélectionnez la nouvelle build et affichez son journal.

2. Le nom de la personne qui a modifié le code s’imprime dans le message d’accueil. Vous pouvez également constater qu’il s’agissait d’une build CI.

Nous venons au cours de ces étapes d’introduire le concept de variables de build. Nous avons imprimé la valeur d’une variable qui est automatiquement prédéfinie et initialisée par le système. Vous pouvez également définir des variables personnalisées et les utiliser dans des arguments de vos tâches ou comme variables d’environnement dans vos scripts. Pour plus d’informations sur les variables, consultez Variables de build.

Après la création du pipeline de build, Quelle est l’étape suivante ?

Vous avez créé un pipeline de build qui génère et valide automatiquement le code archivé par votre équipe. À ce stade, vous pouvez passer soit à la section suivante pour en savoir plus sur les pipelines de mise en production, soit directement à la création d’un pipeline de build pour votre application.

Créer un pipeline de mise en production

Définissez le processus d’exécution du script en deux phases.

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.

Un pipeline de mise en production consiste en une collection de phases sur lesquelles sont déployés les artefacts de build de l’application. Il définit également le pipeline de déploiement proprement dit de chaque phase, ainsi que la façon dont les artefacts sont promus d’une phase à l’autre.

Notez également que nous avons utilisé certaines variables dans nos arguments de script, en l’occurrence des variables de mise en production au lieu des variables de build du pipeline de build précédent.

Déploiement d’une mise en production

Exécutez le script à chaque phase.

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 pouvez suivre la progression de chaque mise en production pour voir si elle a été déployée sur toutes les phases. Vous avez aussi la possibilité d’effectuer un suivi des commits qui font partie de chaque mise en production, des éléments de travail associés et des résultats des séries de tests que vous avez ajoutées au pipeline de mise en production.

Modification du code et déploiement automatique en production

Nous allons apporter une autre modification au script. Cette fois, il se générera automatiquement, puis sera déployé jusqu’en phase de production.

1. Accédez à l’onglet Fichiers du hub Code, puis modifiez le fichier HelloWorld.ps1 comme suit :

   Param(
   [string]$greeter,
   [string]$trigger
   )
   Write-Host "Hello world" from $greeter
   Write-Host Trigger: $trigger
   Write-Host "Now that you've got CI/CD, you can automatically deploy your app every time your team checks in code."
   

2. Commitez (enregistrez) le script.

3. Sélectionnez l’onglet Builds pour voir la mise en file d’attente et l’exécution de la build.

4. Une fois la build terminée, sélectionnez l’onglet Mises en production, ouvrez la nouvelle mise en production, puis accédez à Journaux.

Le nouveau code est déployé automatiquement dans la phase AQ, puis dans la phase Production.

Dans la plupart des cas, il est judicieux de modifier le pipeline de mise en production afin que le déploiement en production ne se produise qu’une fois les tests et les approbations en place (cf. Vue d’ensemble des approbations et des accès contrôlés).

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
• conteneurs

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.

Vous avez appris les principes de base de la création et de l’exécution d’un pipeline. Vous pouvez maintenant configurer votre pipeline de build pour le langage de programmation que vous utilisez. Créez un nouveau pipeline de build, cette fois selon l’un des modèles suivants.

• 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

• Clients

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

• Services

  • Azure Pipelines
  • Fournisseurs de services Git tels que 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.

Vous pouvez si nécessaire modifier et tester votre brouillon.

Dès que vous le souhaitez, vous pouvez publier le brouillon pour fusionner les modifications dans votre pipeline de build.

Si vous décidez d’ignorer le brouillon, vous pouvez le supprimer dans l’onglet Tout le pipeline ci-dessus.

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.

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

  • Spécifiez la version source sous forme d’étiquette ou d’ensemble de modifications.

  • Exécutez une build privée d’un jeu de réservations (cette option peut être utilisée sur un agent hébergé par Microsoft ou sur un agent autohébergé).

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