Condividi tramite

az pipelines 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 pipelines build . Altre informazioni sulle estensioni.

Gestire le compilazioni.

Comandi

Nome Descrizione Tipo Status
az pipelines build cancel

Annulla se la compilazione è in esecuzione.

 Estensione GA
az pipelines build definition

Gestire le definizioni di compilazione.

 Estensione GA
az pipelines build definition list

Elencare le definizioni di compilazione.

 Estensione GA
az pipelines build definition show

Ottenere i dettagli di una definizione di compilazione.

 Estensione GA
az pipelines build list

Elencare i risultati della compilazione.

 Estensione GA
az pipelines build queue

Richiedere (coda) una compilazione.

 Estensione GA
az pipelines build show

Ottenere i dettagli di una compilazione.

 Estensione GA
az pipelines build tag

Gestire i tag di compilazione.

 Estensione GA
az pipelines build tag add

Aggiungere tag per una compilazione.

 Estensione GA
az pipelines build tag delete

Eliminare un tag di compilazione.

 Estensione GA
az pipelines build tag list

Ottenere i tag per una compilazione.

 Estensione GA

az pipelines build cancel

Annulla se la compilazione è in esecuzione.

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

Parametri necessari

--build-id

ID della compilazione.

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--open

Aprire la pagina dei risultati della compilazione nel Web browser.

Valore predefinito: False
--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/.

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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az pipelines build list

Elencare i risultati della compilazione.

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]

Parametri facoltativi

--branch

Filtrare in base alle compilazioni per questo ramo.

--definition-ids

ID (spazi separati) di definizioni per cui elencare le compilazioni.

--detect

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

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

--reason

Limitare le compilazioni con questo motivo.

Valori accettati: all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset
--requested-for

Limite alle compilazioni richieste per questo utente o gruppo.

--result

Limite alle compilazioni con questo risultato.

Valori accettati: canceled, failed, none, partiallySucceeded, succeeded
--status

Limite alle compilazioni con questo stato.

Valori accettati: all, cancelling, completed, inProgress, none, notStarted, postponed
--tags

Limite alle compilazioni con ognuno dei tag specificati. Spazio separato.

--top

Numero massimo di compilazioni da elencare.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az pipelines build queue

Richiedere (coda) una compilazione.

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

Parametri facoltativi

--branch

Ramo da compilare. Obbligatorio se nella definizione non è configurato un ramo predefinito. Esempio: refs/heads/master o master o refs/pull/1/merge o refs/tags/tag.

--commit-id

ID commit del ramo da compilare.

--definition-id

ID della definizione da accodare. Obbligatorio se --name non viene specificato.

--definition-name

Nome della definizione da accodare. Ignorato se viene specificato --id.

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--open

Aprire la pagina dei risultati della compilazione nel Web browser.

Valore predefinito: False
--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/.

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

ID coda del pool che verrà usato per accodare la compilazione.

--variables

Spaziare coppie "name=value" separate per le variabili da impostare.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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

az pipelines build show

Ottenere i dettagli di una compilazione.

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

Parametri necessari

--id

ID della compilazione.

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--open

Aprire la pagina dei risultati della compilazione nel Web browser.

Valore predefinito: False
--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/.

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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'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 posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

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