Condividi tramite

az repos policy build

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-devops per l'interfaccia della riga di comando di Azure (versione 2.30.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az repos policy build . Altre informazioni sulle estensioni.

Gestire i criteri di compilazione.

Comandi

Nome Descrizione Tipo Status
az repos policy build create

Creare criteri di compilazione.

 Estensione Disponibilità generale
az repos policy build update

Aggiornare i criteri di compilazione.

 Estensione Disponibilità generale

az repos policy build create

Creare criteri di compilazione.

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]

Parametri necessari

--blocking

Indica se il criterio deve essere bloccato o meno.

Valori accettati: false, true
--branch

Ramo in cui applicare questo criterio. Ad esempio: master.

--build-definition-id

ID definizione di compilazione.

--display-name

Nome visualizzato per questo criterio di compilazione per identificare i criteri. Ad esempio: 'Manual queue policy'.

--enabled

Indica se il criterio è abilitato o meno.

Valori accettati: false, true
--manual-queue-only

Indica se consentire solo la coda manuale di compilazioni.

Valori accettati: false, true
--queue-on-source-update-only

Coda solo all'aggiornamento dell'origine.

Valori accettati: false, true
--repository-id

ID del repository in cui applicare i criteri.

--valid-duration

Durata della validità dei criteri (in minuti).

Parametri facoltativi

--branch-match-type

Determina la modalità di utilizzo dell'argomento del ramo per applicare un criterio. Se il valore è "esatto", i criteri verranno applicati a un ramo che ha una corrispondenza esatta nell'argomento --branch. Se il valore è "prefisso", il criterio viene applicato in tutte le cartelle di rami che corrispondono al prefisso fornito dall'argomento --branch.

Valori accettati: exact, prefix
Valore predefinito: exact
--detect

Rilevare automaticamente l'organizzazione.

Valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--path-filter

Filtrare i percorsi in cui vengono applicati i criteri. Supporta percorsi assoluti, caratteri jolly e più percorsi separati da ';'. Esempio: /WebApp/Models/Data.cs, /WebApp/* o *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az repos policy build update

Aggiornare i criteri di compilazione.

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]

Parametri necessari

--id --policy-id

ID del criterio.

Parametri facoltativi

--blocking

Indica se il criterio deve essere bloccato o meno.

Valori accettati: false, true
--branch

Ramo in cui applicare questo criterio. Ad esempio: master.

--branch-match-type

Determina la modalità di utilizzo dell'argomento del ramo per applicare un criterio. Se il valore è "esatto", i criteri verranno applicati a un ramo che ha una corrispondenza esatta nell'argomento --branch. Se il valore è "prefisso", il criterio viene applicato in tutte le cartelle di rami che corrispondono al prefisso fornito dall'argomento --branch.

Valori accettati: exact, prefix
--build-definition-id

ID definizione di compilazione.

--detect

Rilevare automaticamente l'organizzazione.

Valori accettati: false, true
--display-name

Nome visualizzato per questo criterio di compilazione per identificare i criteri. Ad esempio: 'Manual queue policy'.

--enabled

Indica se il criterio è abilitato o meno.

Valori accettati: false, true
--manual-queue-only

Indica se consentire solo la coda manuale di compilazioni.

Valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--path-filter

Filtrare i percorsi in cui vengono applicati i criteri. Supporta percorsi assoluti, caratteri jolly e più percorsi separati da ';'. Esempio: /WebApp/Models/Data.cs, /WebApp/* o *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--queue-on-source-update-only

Coda solo all'aggiornamento dell'origine.

Valori accettati: false, true
--repository-id

ID del repository in cui applicare i criteri.

--valid-duration

Durata della validità dei criteri (in minuti).

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.