Partager via

az pipelines build

  • Référence

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 de build az pipelines. En savoir plus sur les extensions.

Gérer les builds.

Commandes

Nom Description Type État
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 build cancel

Annule si la build est en cours d’exécution.

az pipelines build cancel --build-id
                          [--detect {false, true}]
                          [--open]
                          [--org]
                          [--project]

Paramètres obligatoires

--build-id

ID de la build.

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

Valeurs acceptées: false, true
--open

Ouvrez la page des résultats de build 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 build list

Répertorier les résultats de build.

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--reason {all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset}]
                        [--requested-for]
                        [--result {canceled, failed, none, partiallySucceeded, succeeded}]
                        [--status {all, cancelling, completed, inProgress, none, notStarted, postponed}]
                        [--tags]
                        [--top]

Paramètres facultatifs

--branch

Filtrez par builds pour cette branche.

--definition-ids

ID (séparés par l’espace) des définitions pour répertorier les builds.

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

--reason

Limitez-vous aux builds avec cette raison.

Valeurs acceptées: all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset
--requested-for

Limite aux builds demandées pour cet utilisateur ou ce groupe.

--result

Limitez les builds avec ce résultat.

Valeurs acceptées: canceled, failed, none, partiallySucceeded, succeeded
--status

Limitez les builds avec cet état.

Valeurs acceptées: all, cancelling, completed, inProgress, none, notStarted, postponed
--tags

Limite aux builds avec chacune des balises spécifiées. Espace séparé.

--top

Nombre maximal de builds à 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 build queue

Demander (file d’attente) une build.

az pipelines build queue [--branch]
                         [--commit-id]
                         [--definition-id]
                         [--definition-name]
                         [--detect {false, true}]
                         [--open]
                         [--org]
                         [--project]
                         [--queue-id]
                         [--variables]

Paramètres facultatifs

--branch

Branche à générer. Obligatoire s’il n’existe pas de branche par défaut configuré sur la définition. Exemple : refs/heads/master ou master ou refs/pull/1/merge ou refs/tags/tag.

--commit-id

ID de validation de la branche à générer.

--definition-id

ID de la définition à mettre en file d’attente. Obligatoire si --name n’est pas fourni.

--definition-name

Nom de la définition à mettre en file d’attente. Ignoré si --id est fourni.

--detect

Détectez automatiquement l’organisation.

Valeurs acceptées: false, true
--open

Ouvrez la page des résultats de build 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.

--queue-id

ID de file d’attente du pool qui sera utilisé pour mettre en file d’attente la build.

--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 build show

Obtenez les détails d’une build.

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

Paramètres obligatoires

--id

ID de la build.

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

Valeurs acceptées: false, true
--open

Ouvrez la page des résultats de build 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.