Partager via

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

Gérer la stratégie de génération.

Commandes

Nom Description Type État
az repos policy build create

Créez une stratégie de génération.

 Extension GA
az repos policy build update

Mettez à jour la stratégie de génération.

 Extension GA

az repos policy build create

Créez une stratégie de génération.

az repos policy build create --blocking {false, true}
                             --branch
                             --build-definition-id
                             --display-name
                             --enabled {false, true}
                             --manual-queue-only {false, true}
                             --queue-on-source-update-only {false, true}
                             --repository-id
                             --valid-duration
                             [--branch-match-type {exact, prefix}]
                             [--detect {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]

Paramètres obligatoires

--blocking

Indique si la stratégie doit être bloquante ou non.

Valeurs acceptées: false, true
--branch

Branche sur laquelle cette stratégie doit être appliquée. Par exemple : master.

--build-definition-id

ID de définition de build.

--display-name

Nom d’affichage de cette stratégie de build pour identifier la stratégie. Par exemple : « Stratégie de file d’attente manuelle ».

--enabled

Indique si la stratégie est activée ou non.

Valeurs acceptées: false, true
--manual-queue-only

Indique s’il faut autoriser uniquement la file d’attente manuelle des builds.

Valeurs acceptées: false, true
--queue-on-source-update-only

File d’attente uniquement sur la mise à jour source.

Valeurs acceptées: false, true
--repository-id

ID du référentiel sur lequel appliquer la stratégie.

--valid-duration

Durée de validité de la stratégie (en minutes).

Paramètres facultatifs

--branch-match-type

Détermine la façon dont l’argument branche est utilisé pour appliquer une stratégie. Si la valeur est « exacte », la stratégie est appliquée sur une branche qui a une correspondance exacte sur l’argument --branch. Si la valeur est « préfixe », la stratégie est appliquée dans tous les dossiers de branche qui correspondent au préfixe fourni par l’argument --branch.

Valeurs acceptées: exact, prefix
Valeur par défaut: exact
--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/.

--path-filter

Filtrez les chemins d’accès sur lesquels la stratégie est appliquée. Prend en charge les chemins absolus, wild carte s et plusieurs chemins séparés par « ; ». Exemple : /WebApp/Models/Data.cs, /WebApp/* ou *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--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 repos policy build update

Mettez à jour la stratégie de génération.

az repos policy build update --id
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--detect {false, true}]
                             [--display-name]
                             [--enabled {false, true}]
                             [--manual-queue-only {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

Paramètres obligatoires

--id --policy-id

ID de la stratégie.

Paramètres facultatifs

--blocking

Indique si la stratégie doit être bloquante ou non.

Valeurs acceptées: false, true
--branch

Branche sur laquelle cette stratégie doit être appliquée. Par exemple : master.

--branch-match-type

Détermine la façon dont l’argument branche est utilisé pour appliquer une stratégie. Si la valeur est « exacte », la stratégie est appliquée sur une branche qui a une correspondance exacte sur l’argument --branch. Si la valeur est « préfixe », la stratégie est appliquée dans tous les dossiers de branche qui correspondent au préfixe fourni par l’argument --branch.

Valeurs acceptées: exact, prefix
--build-definition-id

ID de définition de build.

--detect

Détectez automatiquement l’organisation.

Valeurs acceptées: false, true
--display-name

Nom d’affichage de cette stratégie de build pour identifier la stratégie. Par exemple : « Stratégie de file d’attente manuelle ».

--enabled

Indique si la stratégie est activée ou non.

Valeurs acceptées: false, true
--manual-queue-only

Indique s’il faut autoriser uniquement la file d’attente manuelle des builds.

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

--path-filter

Filtrez les chemins d’accès sur lesquels la stratégie est appliquée. Prend en charge les chemins absolus, wild carte s et plusieurs chemins séparés par « ; ». Exemple : /WebApp/Models/Data.cs, /WebApp/* ou *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--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-on-source-update-only

File d’attente uniquement sur la mise à jour source.

Valeurs acceptées: false, true
--repository-id

ID du référentiel sur lequel appliquer la stratégie.

--valid-duration

Durée de validité de la stratégie (en minutes).

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.