Condividi tramite


az pipelines

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

Gestire Azure Pipelines.

Questo gruppo di comandi fa parte dell'estensione azure-devops.

Comandi

Nome Descrizione Tipo Stato
az pipelines agent

Gestire gli agenti.

Estensione Disponibilità generale
az pipelines agent list

Ottenere un elenco di agenti in un pool.

Estensione Disponibilità generale
az pipelines agent show

Mostra i dettagli dell'agente.

Estensione Disponibilità generale
az pipelines build

Gestire le compilazioni.

Estensione Disponibilità generale
az pipelines build cancel

Annulla se la compilazione è in esecuzione.

Estensione Disponibilità generale
az pipelines build definition

Gestire le definizioni di compilazione.

Estensione Disponibilità generale
az pipelines build definition list

Elencare le definizioni di compilazione.

Estensione Disponibilità generale
az pipelines build definition show

Ottenere i dettagli di una definizione di compilazione.

Estensione Disponibilità generale
az pipelines build list

Elencare i risultati della compilazione.

Estensione Disponibilità generale
az pipelines build queue

Richiedere (coda) una compilazione.

Estensione Disponibilità generale
az pipelines build show

Ottenere i dettagli di una compilazione.

Estensione Disponibilità generale
az pipelines build tag

Gestire i tag di compilazione.

Estensione Disponibilità generale
az pipelines build tag add

Aggiungere tag per una compilazione.

Estensione Disponibilità generale
az pipelines build tag delete

Eliminare un tag di compilazione.

Estensione Disponibilità generale
az pipelines build tag list

Ottenere i tag per una compilazione.

Estensione Disponibilità generale
az pipelines create

Creare una nuova pipeline di Azure (basata su YAML).

Estensione Disponibilità generale
az pipelines delete

Eliminare una pipeline.

Estensione Disponibilità generale
az pipelines folder

Gestire le cartelle per organizzare le pipeline.

Estensione Disponibilità generale
az pipelines folder create

Creare una cartella.

Estensione Disponibilità generale
az pipelines folder delete

Eliminare una cartella.

Estensione Disponibilità generale
az pipelines folder list

Elencare tutte le cartelle.

Estensione Disponibilità generale
az pipelines folder update

Aggiornare il nome o la descrizione di una cartella.

Estensione Disponibilità generale
az pipelines list

Elencare le pipeline.

Estensione Disponibilità generale
az pipelines pool

Gestire i pool di agenti.

Estensione Disponibilità generale
az pipelines pool list

Elencare i pool di agenti.

Estensione Disponibilità generale
az pipelines pool show

Mostra i dettagli del pool di agenti.

Estensione Disponibilità generale
az pipelines queue

Gestire le code degli agenti.

Estensione Disponibilità generale
az pipelines queue list

Elencare le code degli agenti.

Estensione Disponibilità generale
az pipelines queue show

Mostra i dettagli della coda dell'agente.

Estensione Disponibilità generale
az pipelines release

Gestire le versioni.

Estensione Disponibilità generale
az pipelines release create

Richiedere (creare) una versione.

Estensione Disponibilità generale
az pipelines release definition

Gestire le definizioni di versione.

Estensione Disponibilità generale
az pipelines release definition list

Elencare le definizioni di versione.

Estensione Disponibilità generale
az pipelines release definition show

Ottenere i dettagli di una definizione di versione.

Estensione Disponibilità generale
az pipelines release list

Elencare i risultati della versione.

Estensione Disponibilità generale
az pipelines release show

Ottenere i dettagli di una versione.

Estensione Disponibilità generale
az pipelines run

Accodamento (esecuzione) di una pipeline.

Estensione Disponibilità generale
az pipelines runs

Gestire le esecuzioni della pipeline.

Estensione Disponibilità generale
az pipelines runs artifact

Gestire gli artefatti di esecuzione della pipeline.

Estensione Disponibilità generale
az pipelines runs artifact download

Scaricare un artefatto della pipeline.

Estensione Disponibilità generale
az pipelines runs artifact list

Elencare gli artefatti associati a un'esecuzione.

Estensione Disponibilità generale
az pipelines runs artifact upload

Caricare un artefatto della pipeline.

Estensione Disponibilità generale
az pipelines runs list

Elencare le esecuzioni della pipeline in un progetto.

Estensione Disponibilità generale
az pipelines runs show

Visualizzare i dettagli di un'esecuzione della pipeline.

Estensione Disponibilità generale
az pipelines runs tag

Gestire i tag di esecuzione della pipeline.

Estensione Disponibilità generale
az pipelines runs tag add

Aggiungere tag per un'esecuzione della pipeline.

Estensione Disponibilità generale
az pipelines runs tag delete

Eliminare un tag di esecuzione della pipeline.

Estensione Disponibilità generale
az pipelines runs tag list

Ottenere i tag per un'esecuzione della pipeline.

Estensione Disponibilità generale
az pipelines show

Ottenere i dettagli di una pipeline.

Estensione Disponibilità generale
az pipelines update

Aggiornare una pipeline.

Estensione Disponibilità generale
az pipelines variable

Gestire le variabili della pipeline.

Estensione Disponibilità generale
az pipelines variable-group

Gestire i gruppi di variabili.

Estensione Disponibilità generale
az pipelines variable-group create

Creare un gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable-group delete

Eliminare un gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable-group list

Elencare i gruppi di variabili.

Estensione Disponibilità generale
az pipelines variable-group show

Visualizzare i dettagli del gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable-group update

Aggiornare un gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable-group variable

Gestire le variabili in un gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable-group variable create

Aggiungere una variabile a un gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable-group variable delete

Eliminare una variabile dal gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable-group variable list

Elencare le variabili in un gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable-group variable update

Aggiornare una variabile in un gruppo di variabili.

Estensione Disponibilità generale
az pipelines variable create

Aggiungere una variabile a una pipeline.

Estensione Disponibilità generale
az pipelines variable delete

Eliminare una variabile dalla pipeline.

Estensione Disponibilità generale
az pipelines variable list

Elencare le variabili in una pipeline.

Estensione Disponibilità generale
az pipelines variable update

Aggiornare una variabile in una pipeline.

Estensione Disponibilità generale

az pipelines create

Creare una nuova pipeline di Azure (basata su YAML).

az pipelines create --name
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--folder-path]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run {false, true}]
                    [--yaml-path]

Esempio

Creare una pipeline di Azure dal contesto del repository di estrazione locale

Repository name/url (--repository), type (--repository-type) and branch name (--branch) will be detected from the local git repository
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'

Creare una pipeline di Azure per un repository ospitato in Github usando l'URL clone

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master

Creare una pipeline di Azure per un repository ospitato nell'organizzazione GitHub SampleOrg, il nome del repository SampleRepo

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github

Creare una pipeline di Azure per un repository ospitato in un repository di Azure nello stesso progetto

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit

Creare una pipeline di Azure per un repository con il file yaml della pipeline già archiviato nel repository

Service connection required for non Azure Repos can be optionally provided in the command to run it non interatively
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master --yml-path azure-pipelines.yml [--service-connection SERVICE_CONNECTION]

Parametri necessari

--name

Nome della nuova pipeline.

Parametri facoltativi

--branch

Nome del ramo per il quale verrà configurata la pipeline. Se omesso, verrà rilevato automaticamente dal repository locale.

--description

Descrizione per la nuova pipeline.

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--folder-path

Percorso della cartella in cui deve essere creata la pipeline. Il valore predefinito è la cartella radice. ad esempio "user1/test_pipelines".

--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 della coda nei pool di agenti disponibili. Se non specificato, verrà rilevato automaticamente.

--repository

Repository per il quale deve essere configurata la pipeline. Può essere l'URL clone del repository Git o il nome del repository per azure Repos o Owner/RepoName in caso di repository GitHub. Se omesso, verrà rilevato automaticamente dall'URL remoto del repository Git locale. Se il nome è indicato invece dell'URL, è necessario anche l'argomento --repository-type.

--repository-type

Tipo di repository. Se omesso, verrà rilevato automaticamente dall'URL remoto del repository locale. 'tfsgit' per Azure Repos, 'github' per il repository GitHub.

valori accettati: github, tfsgit
--service-connection

ID della connessione al servizio creata per il repository per il repository GitHub. Usare il comando az devops service-endpoint -h per creare/elencare service_connections. Non obbligatorio per Azure Repos.

--skip-first-run --skip-run

Specificare questo flag per impedire che la prima esecuzione venga attivata dal comando . Se l'esecuzione viene ignorata, il comando restituirà una pipeline. In caso contrario, verrà restituita un'esecuzione della pipeline.

valori accettati: false, true
--yaml-path --yml-path

Percorso del file yaml delle pipeline nel repository (se yaml è già presente nel repository).

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

Eliminare una pipeline.

az pipelines delete --id
                    [--detect {false, true}]
                    [--org]
                    [--project]
                    [--yes]

Parametri necessari

--id

ID della pipeline.

Parametri facoltativi

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

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

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
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 pipelines list

Elencare le pipeline.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

Parametri facoltativi

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--folder-path

Se specificato, filtra le definizioni in questa cartella.

--name

Limitare i risultati alle pipeline con questo nome o a partire da questo nome. Esempi: "FabCI" o "Fab*".

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

--query-order

Ordine dei risultati.

valori accettati: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None
--repository

Limitare i risultati alle pipeline associate a questo repository.

--repository-type

Limitare i risultati alle pipeline associate a questo tipo di repository. È obbligatorio passare l'argomento 'repository' insieme a questo argomento.

valori accettati: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol
--top

Numero massimo di pipeline da elencare.

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

Accodamento (esecuzione) di una pipeline.

az pipelines run [--branch]
                 [--commit-id]
                 [--detect {false, true}]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org]
                 [--parameters]
                 [--project]
                 [--variables]

Parametri facoltativi

--branch

Nome del ramo in cui deve essere accodata l'esecuzione della pipeline. Esempio: refs/heads/master o master o refs/pull/1/merge o refs/tags/tag.

--commit-id

Commit-id in cui deve essere accodata l'esecuzione della pipeline.

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--folder-path

Percorso della cartella della pipeline. Il valore predefinito è la cartella a livello radice.

--id

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

--name

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

--open

Aprire la pagina dei risultati della pipeline 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/.

--parameters

Spaziare coppie "name=value" separate per i parametri da impostare.

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

--variables

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

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

Ottenere i dettagli di una pipeline.

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

Parametri facoltativi

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--folder-path

Percorso della cartella della pipeline. Il valore predefinito è la cartella a livello radice.

--id

ID della pipeline.

--name

Nome della pipeline. Ignorato se viene specificato --id.

--open

Aprire la pagina di riepilogo della pipeline 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

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

Aggiornare una pipeline.

az pipelines update --id
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

Parametri necessari

--id

ID della pipeline da aggiornare.

Parametri facoltativi

--branch

Nome del ramo per il quale verrà configurata la pipeline.

--description

Nuova descrizione per la pipeline.

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--new-folder-path

Nuovo percorso completo della cartella in cui spostare la pipeline. ad esempio "user1/production_pipelines".

--new-name

Nuovo nome aggiornato della pipeline.

--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 di agenti in cui deve essere eseguita la pipeline.

--yaml-path --yml-path

Percorso del file yaml delle pipeline nel repository.

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.