az pipelines

Remarque

Cette référence fait partie de l’extension azure-devops pour Azure CLI (version 2.30.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az pipelines . En savoir plus sur les extensions.

Gérer Azure Pipelines.

Ce groupe de commandes fait partie de l’extension azure-devops.

Commandes

Nom	Description	Type	Statut
az pipelines agent	Gérer les agents.	Extension	GA
az pipelines agent list	Obtenez la liste des agents dans un pool.	Extension	GA
az pipelines agent show	Afficher les détails de l’agent.	Extension	GA
az pipelines build	Gérer les builds.	Extension	GA
az pipelines build cancel	Annule si la build est en cours d’exécution.	Extension	GA
az pipelines build definition	Créer des définitions de build.	Extension	GA
az pipelines build definition list	Répertorier les définitions de build.	Extension	GA
az pipelines build definition show	Obtenez les détails d’une définition de build.	Extension	GA
az pipelines build list	Répertorier les résultats de build.	Extension	GA
az pipelines build queue	Demander (file d’attente) une build.	Extension	GA
az pipelines build show	Obtenez les détails d’une build.	Extension	GA
az pipelines build tag	Gérer les étiquettes de build.	Extension	GA
az pipelines build tag add	Ajoutez des balises pour une build.	Extension	GA
az pipelines build tag delete	Supprimez une balise de build.	Extension	GA
az pipelines build tag list	Obtenir des balises pour une build.	Extension	GA
az pipelines create	Créez un pipeline Azure (basé sur YAML).	Extension	GA
az pipelines delete	Supprimez un pipeline.	Extension	GA
az pipelines folder	Gérer les dossiers pour organiser les pipelines.	Extension	GA
az pipelines folder create	Créez un dossier.	Extension	GA
az pipelines folder delete	Supprimez un dossier.	Extension	GA
az pipelines folder list	Répertorier tous les dossiers.	Extension	GA
az pipelines folder update	Mettez à jour un nom ou une description de dossier.	Extension	GA
az pipelines list	Répertorier les pipelines.	Extension	GA
az pipelines pool	Gérer les pools d’agents.	Extension	GA
az pipelines pool list	Répertorier les pools d’agents.	Extension	GA
az pipelines pool show	Afficher les détails du pool d’agents.	Extension	GA
az pipelines queue	Gérer les files d’attente d’agents.	Extension	GA
az pipelines queue list	Répertorier les files d’attente de l’agent.	Extension	GA
az pipelines queue show	Afficher les détails de la file d’attente de l’agent.	Extension	GA
az pipelines release	Gérer les mises en production.	Extension	GA
az pipelines release create	Demander (créer) une version.	Extension	GA
az pipelines release definition	Gérer les définitions de mise en production.	Extension	GA
az pipelines release definition list	Définitions de mise en production de liste.	Extension	GA
az pipelines release definition show	Obtenez les détails d’une définition de mise en production.	Extension	GA
az pipelines release list	Répertorier les résultats des mises en production.	Extension	GA
az pipelines release show	Obtenez les détails d’une version.	Extension	GA
az pipelines run	File d’attente (exécuter) un pipeline.	Extension	GA
az pipelines runs	Gérer les exécutions de pipeline.	Extension	GA
az pipelines runs artifact	Gérer les artefacts d’exécution de pipeline.	Extension	GA
az pipelines runs artifact download	Téléchargez un artefact de pipeline.	Extension	GA
az pipelines runs artifact list	Répertorier les artefacts associés à une exécution.	Extension	GA
az pipelines runs artifact upload	Chargez un artefact de pipeline.	Extension	GA
az pipelines runs list	Répertoriez les exécutions du pipeline dans un projet.	Extension	GA
az pipelines runs show	Afficher les détails d’une exécution de pipeline.	Extension	GA
az pipelines runs tag	Gérer les étiquettes d’exécution de pipeline.	Extension	GA
az pipelines runs tag add	Ajoutez des balises pour une exécution de pipeline.	Extension	GA
az pipelines runs tag delete	Supprimez une balise d’exécution de pipeline.	Extension	GA
az pipelines runs tag list	Obtenir des balises pour une exécution de pipeline.	Extension	GA
az pipelines show	Obtenez les détails d’un pipeline.	Extension	GA
az pipelines update	Mettez à jour un pipeline.	Extension	GA
az pipelines variable	Gérer les variables de pipeline.	Extension	GA
az pipelines variable-group	Gérer les groupes de variables.	Extension	GA
az pipelines variable-group create	Créez un groupe de variables.	Extension	GA
az pipelines variable-group delete	Supprimez un groupe de variables.	Extension	GA
az pipelines variable-group list	Répertorier les groupes de variables.	Extension	GA
az pipelines variable-group show	Afficher les détails du groupe de variables.	Extension	GA
az pipelines variable-group update	Mettez à jour un groupe de variables.	Extension	GA
az pipelines variable-group variable	Gérer les variables dans un groupe de variables.	Extension	GA
az pipelines variable-group variable create	Ajoutez une variable à un groupe de variables.	Extension	GA
az pipelines variable-group variable delete	Supprimez une variable du groupe de variables.	Extension	GA
az pipelines variable-group variable list	Répertorie les variables d’un groupe de variables.	Extension	GA
az pipelines variable-group variable update	Mettez à jour une variable dans un groupe de variables.	Extension	GA
az pipelines variable create	Ajoutez une variable à un pipeline.	Extension	GA
az pipelines variable delete	Supprimez une variable du pipeline.	Extension	GA
az pipelines variable list	Répertoriez les variables dans un pipeline.	Extension	GA
az pipelines variable update	Mettez à jour une variable dans un pipeline.	Extension	GA

az pipelines create

Créez un pipeline Azure (basé sur YAML).

az pipelines create --name
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--folder-path]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run {false, true}]
                    [--yaml-path]

Exemples

Créer un pipeline Azure à partir d’un contexte de référentiel case activée out local

Repository name/url (--repository), type (--repository-type) and branch name (--branch) will be detected from the local git repository
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'

Créer un pipeline Azure pour un référentiel hébergé sur Github à l’aide de l’URL de clonage

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master

Créer un pipeline Azure pour un référentiel hébergé sur l’organisation Github SampleOrg, nom de dépôt SampleRepo

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github

Créer un pipeline Azure pour un référentiel hébergé dans un dépôt Azure dans le même projet

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit

Créer un pipeline Azure pour un référentiel avec le yaml de pipeline déjà case activée dans le référentiel

Service connection required for non Azure Repos can be optionally provided in the command to run it non interatively
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master --yml-path azure-pipelines.yml [--service-connection SERVICE_CONNECTION]

Paramètres obligatoires

--name

Nom du nouveau pipeline.

Paramètres facultatifs

--branch

Nom de branche pour lequel le pipeline sera configuré. S’il est omis, il est détecté automatiquement à partir du référentiel local.

--description

Description du nouveau pipeline.

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true

--folder-path

Chemin du dossier dans lequel le pipeline doit être créé. La valeur par défaut est le dossier racine. par exemple « user1/test_pipelines ».

--org --organization

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 n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

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 s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--queue-id

ID de la file d’attente dans les pools d’agents disponibles. Est détecté automatiquement s’il n’est pas spécifié.

--repository

Référentiel pour lequel le pipeline doit être configuré. Peut être l’URL du dépôt Git ou le nom du référentiel pour un dépôt Azure Repos ou Propriétaire/RepoName dans le cas du dépôt GitHub. S’il est omis, il est détecté automatiquement à partir de l’URL distante du dépôt git local. Si le nom est mentionné au lieu de l’URL, l’argument --repository-type est également requis.

--repository-type

Type de référentiel. S’il est omis, il est détecté automatiquement à partir de l’URL distante du référentiel local. « tfsgit » pour Azure Repos, « github » pour le dépôt GitHub.

valeurs acceptées: github, tfsgit

--service-connection

ID de la connexion de service créée pour le dépôt pour le dépôt GitHub. Utilisez la commande az devops service-endpoint -h pour créer/répertorier des service_connections. Non requis pour Azure Repos.

--skip-first-run --skip-run

Spécifiez cet indicateur pour empêcher la première exécution déclenchée par la commande. La commande retourne un pipeline si l’exécution est ignorée, sinon elle génère une exécution de pipeline.

valeurs acceptées: false, true

--yaml-path --yml-path

Chemin d’accès du fichier yaml pipelines dans le dépôt (si yaml est déjà présent dans le référentiel).

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az pipelines delete

Supprimez un pipeline.

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

Paramètres obligatoires

--id

ID du pipeline.

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true

--org --organization

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 n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

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 s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az pipelines list

Répertorier les pipelines.

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]

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true

--folder-path

Si elle est spécifiée, filtre les définitions sous ce dossier.

--name

Limitez les résultats aux pipelines portant ce nom ou en commençant par ce nom. Exemples : « FabCI » et « Fab* ».

--org --organization

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 n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

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 s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--query-order

Ordre des résultats.

valeurs acceptées: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None

--repository

Limitez les résultats aux pipelines associés à ce référentiel.

--repository-type

Limitez les résultats aux pipelines associés à ce type de référentiel. Il est obligatoire de passer l’argument « référentiel » avec cet argument.

valeurs acceptées: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol

--top

Nombre maximal de pipelines à répertorier.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az pipelines run

File d’attente (exécuter) un pipeline.

az pipelines run [--branch]
                 [--commit-id]
                 [--detect {false, true}]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org]
                 [--parameters]
                 [--project]
                 [--variables]

Paramètres facultatifs

--branch

Nom de la branche sur laquelle l’exécution du pipeline doit être mise en file d’attente. Exemple : refs/heads/master ou master ou refs/pull/1/merge ou refs/tags/tag.

--commit-id

Id de validation sur lequel l’exécution du pipeline doit être mise en file d’attente.

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true

--folder-path

Chemin d’accès au dossier du pipeline. La valeur par défaut est le dossier de niveau racine.

--id

ID du pipeline à mettre en file d’attente. Obligatoire si --name n’est pas fourni.

--name

Nom du pipeline à mettre en file d’attente. Ignoré si --id est fourni.

--open

Ouvrez la page de résultats du pipeline dans votre navigateur web.

valeur par défaut: False

--org --organization

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 n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--parameters

Paires « name=value » séparées par l’espace pour les paramètres que vous souhaitez définir.

--project -p

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 s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--variables

Paires « name=value » séparées par l’espace pour les variables que vous souhaitez définir.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az pipelines show

Obtenez les détails d’un pipeline.

az pipelines show [--detect {false, true}]
                  [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org]
                  [--project]

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true

--folder-path

Chemin d’accès au dossier du pipeline. La valeur par défaut est le dossier de niveau racine.

--id

ID du pipeline.

--name

Nom du pipeline. Ignoré si --id est fourni.

--open

Ouvrez la page récapitulative du pipeline dans votre navigateur web.

valeur par défaut: False

--org --organization

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 n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

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 s’il n’est pas configuré par défaut ou récupéré via la configuration git.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az pipelines update

Mettez à jour un pipeline.

az pipelines update --id
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

Paramètres obligatoires

--id

ID du pipeline à mettre à jour.

Paramètres facultatifs

--branch

Nom de branche pour lequel le pipeline sera configuré.

--description

Nouvelle description du pipeline.

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true

--new-folder-path

Nouveau chemin complet du dossier vers lequel déplacer le pipeline. par exemple, « user1/production_pipelines ».

--new-name

Nouveau nom mis à jour du pipeline.

--org --organization

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 n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

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 s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--queue-id

ID de file d’attente du pool d’agents où le pipeline doit s’exécuter.

--yaml-path --yml-path

Chemin d’accès du fichier yaml pipelines dans le dépôt.

Paramètres globaux

--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc

valeur par défaut: json

--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.