Créer votre premier pipeline

03/12/2020 • 17 minutes de lecture •

Dans cet article

Conditions préalables-Azure DevOps
Créer votre premier pipeline
Ajouter un badge d’État à votre référentiel
Gérer votre pipeline avec Azure CLI
Étapes suivantes
Forum aux questions

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 |
TFS 2017
Il s’agit d’un guide pas à pas d’utilisation de Azure Pipelines pour créer un référentiel
GitHub.

Conditions préalables-Azure DevOps

Un compte GitHub, dans lequel vous pouvez créer un référentiel. Si vous n’en avez
pas, vous pouvez en créer un gratuitement .
Une organisation Azure DevOps. Si vous n’en avez pas, vous pouvez en créer un
gratuitement. (Une organisation Azure DevOps est différente de celle de votre
organisation GitHub. Donnez-leur le même nom si vous souhaitez les aligner entre
eux.)
Si votre équipe en a déjà une, assurez-vous que vous êtes un administrateur du
projet Azure DevOps que vous souhaitez utiliser.
Possibilité d’exécuter des pipelines sur des agents hébergés par Microsoft. Vous
pouvez acheter un travail parallèle ou vous pouvez demander un niveau gratuit.
Pour demander un niveau gratuit, suivez les instructions de cet article. Veuillez
noter que le niveau gratuit peut prendre 2-3 jours ouvrables.

Créer votre premier pipeline

Java .NET Python JavaScript Azure CLI (Java)
 Récupérer l’exemple de code Java
Pour commencer, dupliquez le référentiel suivant dans votre compte GitHub.

＝ Copier

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

Créer votre premier pipeline Java

1. Connectez-vous à votre organisation Azure DevOps et accédez à votre projet.
2. Dans votre projet, accédez à la page Pipelines. Choisissez ensuite l’action
pour créer un pipeline.
3. Suivez les étapes de l’Assistant en sélectionnant d’abord GitHub comme
emplacement du code source.
4. Vous serez peut-être redirigé vers GitHub pour vous connecter. Si c’est le cas,
entrez vos informations d’identification GitHub.
5. Lorsque la liste des dépôts s’affiche, sélectionnez le dépôt d’exemples
d’applications de votre choix.
6. Azure Pipelines analyse votre référentiel et recommande un modèle de
pipeline Maven. Sélectionnez Enregistrer et exécuter, Valider directement sur
la branche primaire, puis choisissez à nouveau Enregistrer et exécuter.
7. Une nouvelle exécution est lancée. Attendez la fin de l’exécution.
En savoir plus sur l' utilisation de Java dans votre pipeline.

Ajouter un badge d’État à votre 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 le presse-papiers :

 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. Dans le menu contextuel du pipeline, sélectionnez le badge d’État.
3. Copiez l’exemple de démarque à partir du panneau de badge d’État.
Maintenant la démarque du badge dans le presse-papiers, effectuez les étapes
suivantes dans GitHub :
1. Accédez à la liste des fichiers et sélectionnez Readme.md . Sélectionnez l’icône de
crayon à modifier.
2. Collez la démarque d’État au début du fichier.
3. Validez la modification apportée à la master branche.

4. Notez que le badge d’État s’affiche dans la description de votre référentiel.

Pour configurer l’accès anonyme aux badges pour les projets privés :
1. Accéder aux paramètres du projet
2. Ouvrez l’onglet paramètres sous pipelines .
3. Basculer le curseur désactiver l’accès anonyme au badges sous général

７ Notes

Même dans un projet privé, l’accès au badge anonyme est activé par défaut.
Lorsque l’accès au badge anonyme est activé, les utilisateurs extérieurs à votre
organisation peuvent être en mesure d’interroger des informations telles que les
noms de projet, les noms de branche, les noms de travaux et l’état de la build via
l’API d’État du badge.

Étant donné que vous venez Readme.md de modifier le fichier dans ce référentiel, Azure
pipelines génère automatiquement votre code, en fonction de la configuration dans le
azure-pipelines.yml fichier à la racine de votre référentiel. De retour dans Azure
Pipelines, Notez qu’une nouvelle exécution s’affiche. Chaque fois que vous apportez une
modification, Azure Pipelines démarre une nouvelle exécution.

Gérer votre pipeline avec Azure CLI

Vous pouvez gérer les pipelines dans votre organisation à l’aide des az pipelines
commandes suivantes :
AZ pipelines Run: exécuter un pipeline existant
AZ pipelines Update: mettre à jour un pipeline existant
AZ pipelines Show: afficher les détails d’un pipeline existant
Ces commandes nécessitent le nom ou l’ID du pipeline que vous souhaitez gérer. Vous
pouvez obtenir l’ID d’un pipeline à l’aide de la commande AZ pipelines List .

Exécuter un pipeline
Vous pouvez faire une file d’attente (exécuter) un pipeline existant avec la commande
AZ pipelines Run . Pour commencer, consultez prise en main d’Azure DEVOPS CLI.

Azure CLI ＝ Copier

az pipelines run [--branch]

[--commit-id]
[--folder-path]
[--id]
[--name]
[--open]
[--org]
[--project]
[--variables]

Paramètres
branche: nom de la branche sur laquelle l’exécution du pipeline doit être mise en
file d’attente, par exemple, REFS/Heads/main.
Commit-ID: Commit-ID sur lequel l’exécution du pipeline doit être mise en file
d’attente.
dossier-Path: chemin d’accès au dossier du pipeline. La valeur par défaut est le
dossier racine.
ID: obligatoire si le nom n’est pas fourni. ID du pipeline à la file d’attente.
nom: obligatoire si l' ID n’est pas fourni, mais ignoré si l' ID est fourni. Nom du
pipeline à la file d’attente.
ouvrir: ouvre la page des résultats du pipeline dans votre navigateur Web.
org: URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation
par défaut à l’aide de az devops configure -d organization=ORG_URL .
Obligatoire si la valeur par défaut n’est pas configurée ou récupérée à l’aide de
git config . Exemple : --org https://dev.azure.com/MyOrganizationName/ .
 projet: nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide
de az devops configure -d project=NAME_OR_ID . Obligatoire si la valeur par
défaut n’est pas configurée ou récupérée à l’aide de git config .
variables: paires « nom = valeur » séparées par un espace pour les variables que
vous souhaitez définir.

Exemple
La commande suivante exécute le pipeline nommé myGithubname. pipelines-Java dans
le pipeline de branche et affiche le résultat sous forme de table.

Azure CLI ＝ Copier

az pipelines run --name myGithubname.pipelines-java --branch pipeline

--output table

Run ID Number Status Result Pipeline ID Pipeline

Name Source Branch Queued Time Reason
-------- ---------- ---------- -------- ------------- ----------
----------------- --------------- -------------------------- -----
---
123 20200123.2 notStarted 12
myGithubname.pipelines-java pipeline 2020-01-23
11:55:56.633450 manual

Mettre à jour un pipeline

Vous pouvez mettre à jour un pipeline existant avec la commande AZ pipelines Update .
Pour commencer, consultez prise en main d’Azure DEVOPS CLI.

Azure CLI ＝ Copier

az pipelines update [--branch]

[--description]
[--id]
[--name]
[--new-folder-path]
[--new-name]
[--org]
[--project]
[--queue-id]
[--yaml-path]

Paramètres
 branche: nom de la branche sur laquelle l’exécution du pipeline doit être
configurée, par exemple, REFS/Heads/main.
Description: nouvelle description du pipeline.
ID: obligatoire si le nom n’est pas fourni. ID du pipeline à mettre à jour.
nom: obligatoire si l' ID n’est pas fourni. Nom du pipeline à mettre à jour.
New-Folder-Path: nouveau chemin d’accès complet du dossier dans lequel le
pipeline est déplacé, par exemple, User1/production_pipelines.
New-Name: nouveau nom mis à jour du pipeline.
org: URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation
par défaut à l’aide de az devops configure -d organization=ORG_URL .
Obligatoire si la valeur par défaut n’est pas configurée ou récupérée à l’aide de
git config . Exemple : --org https://dev.azure.com/MyOrganizationName/ .
projet: nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide
de az devops configure -d project=NAME_OR_ID . Obligatoire si la valeur par
défaut n’est pas configurée ou récupérée à l’aide de git config .
queue-ID: ID de file d’attente du pool d’agents où le pipeline doit s’exécuter.
YAML-Path: chemin d’accès du fichier YAML du pipeline dans le référentiel.

Exemple
La commande suivante met à jour le pipeline avec l' ID 12 avec un nouveau nom et une
description, et affiche le résultat sous forme de table.

Azure CLI ＝ Copier

az pipelines update --id 12 --description "rename pipeline" --new-

name updatedname.pipelines-java --output table

ID Name Status Default Queue

---- -------------------------- -------- ------------------
12 updatedname.pipelines-java enabled Hosted Ubuntu 1604

Afficher le pipeline
Vous pouvez afficher les détails d’un pipeline existant à l’aide de la commande AZ
pipelines Show . Pour commencer, consultez prise en main d’Azure DEVOPS CLI.

Azure CLI ＝ Copier

az pipelines show [--folder-path]

[--id]
[--name]
[--open]
 [--org]
[--project]

Paramètres
dossier-Path: chemin d’accès au dossier du pipeline. La valeur par défaut est le
dossier racine.
ID: obligatoire si le nom n’est pas fourni. ID du pipeline pour afficher les détails.
nom: obligatoire si le nom n’est pas fourni, mais ignoré si l' ID est fourni. Nom du
pipeline pour afficher les détails.
ouvrir: Ouvrez la page Résumé du pipeline dans votre navigateur Web.
org: URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation
par défaut à l’aide de az devops configure -d organization=ORG_URL .
Obligatoire si la valeur par défaut n’est pas configurée ou récupérée à l’aide de
git config . Exemple : --org https://dev.azure.com/MyOrganizationName/ .
projet: nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide
de az devops configure -d project=NAME_OR_ID . Obligatoire si la valeur par
défaut n’est pas configurée ou récupérée à l’aide de git config .

Exemple
La commande suivante affiche les détails du pipeline avec l' ID 12 et retourne le résultat
sous forme de table.

Azure CLI ＝ Copier

az pipelines show --id 12 --output table

ID Name Status Default Queue

---- -------------------------- -------- ------------------
12 updatedname.pipelines-java enabled Hosted Ubuntu 1604

Étapes suivantes
Vous venez d’apprendre à créer votre premier pipeline dans Azure. En savoir plus sur la
configuration des pipelines dans le langage de votre choix :
.NET Core
Go
Java
Node.JS
 Python
Containers
Vous pouvez aussi procéder à la personnalisation du pipeline que vous venez de créer.
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éer des
référentiels GitHub.
Pour savoir ce que vous pouvez 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, ils sont faciles à supprimer lorsque vous n’en
avez plus besoin.

Browser Interface CLI Azure DevOps

Pour supprimer un pipeline, accédez à la page Résumé de ce pipeline, puis

choisissez supprimer dans le menu ... en haut à droite de la page. Tapez le nom du
pipeline à confirmer, puis choisissez supprimer.

Forum aux questions

Où puis-je lire des articles sur DevOps et CI/CD ?
Qu’est-ce que l’intégration continue ?
Qu’est-ce que la livraison continue ?
Qu’est-ce que DevOps ?

Quels types de contrôle de version puis-je utiliser ?

Quand vous êtes prêt à vous familiariser avec CI/CD pour votre application, vous pouvez
utiliser le système de contrôle de version de votre choix :
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 que GitHub et bitbucket Cloud
Subversion

Comment puis-je supprimer un pipeline ?

Pour supprimer un pipeline, accédez à la page Résumé de ce pipeline, puis choisissez
supprimer dans le menu ... en haut à droite de la page. Tapez le nom du pipeline à
confirmer, puis choisissez supprimer.

Que puis-je faire d’autre lorsque j’ai mis en file

d’attente une build ?
Vous pouvez faire en file d’attente les builds automatiquement ou manuellement.
Lorsque vous mettrez manuellement en file d’attente une build, vous pouvez, pour une
seule exécution de la build :
Spécifiez le pool dans lequel la build va.
Ajoutez et modifiez des variables.
Ajoutez des demandes.
 Dans un dépôt git
Créer une branche ou une balise .
Générez une validation.

Où puis-je en savoir plus sur les paramètres de

pipeline de build ?
Pour en savoir plus sur les paramètres de pipeline de build, consultez :
Obtention des sources
Tâches
Variables
Déclencheurs
Rétention
History

Comment faire par programmation de créer un

pipeline de build ?
Référence de l’API REST : créer un pipeline de build

７ Notes

Vous pouvez également gérer les builds et les pipelines de génération à partir de la
ligne de commande ou des scripts à l’aide de l' interface CLI Azure pipelines.

Puis-je utiliser une seule commande sur la ligne de

commande pour exécuter plusieurs pipelines dans
Azure DevOps Services ?
Actuellement, les API Azure CLI et Azure n’offrent pas de commandes qui exécutent
plusieurs pipelines à partir de la ligne de commande. Vous pouvez utiliser des
commandes de Azure CLI pour répertorier tous les pipelines et définitions et fournir une
seule version ou ID de build en tant que paramètre. Toutes les commandes sont conçues
pour fonctionner pour des exécutions indépendantes de pipelines indépendants, et
elles nécessitent des demandes d’ID uniques qui n’autorisent qu’une seule valeur
unique. Pour en savoir plus sur les déclencheurs de pipeline, consultez spécifier les
événements qui déclenchent des pipelines.
Cette page est-elle utile ?
 Yes  No