Partager via

az repos policy build

Note

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 az repos policy build commande. Apprenez-en davantage 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 --organization]
                             [--path-filter]
                             [--project]

Paramètres obligatoires

--blocking

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

Propriété Valeur
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 complet de cette stratégie de génération 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.

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

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

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

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

Propriété Valeur
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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété Valeur
Valeur par défaut: exact
Valeurs acceptées: exact, prefix
--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. 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, les caractères génériques 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 si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az repos policy build update

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

az repos policy build update --id --policy-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 --organization]
                             [--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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--blocking

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

Propriété Valeur
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.

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

ID de définition de build.

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--display-name

Nom complet de cette stratégie de génération 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.

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

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

Propriété Valeur
Valeurs acceptées: false, true
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. 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, les caractères génériques 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 si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--queue-on-source-update-only

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

Propriété Valeur
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 la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False