Partager via


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.