Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
Questo articolo descrive come gestire le pipeline esistenti nel progetto Azure DevOps usando i comandi az pipelines seguenti:
- az pipelines list per elencare le pipeline in un progetto
- az pipelines show per visualizzare i dettagli di una pipeline
- az pipelines run per eseguire una pipeline
- az pipelines update per l'aggiornamento di una pipeline
- az pipelines delete per eliminare una pipeline
Nota
L'estensione dell'interfaccia della riga di comando di Azure DevOps è disponibile solo per Azure DevOps Services e non supporta alcuna versione di Azure DevOps Server.
Azure DevOps CLI extension (Estensione dell'interfaccia della riga di comando di Azure DevOps)
Il gruppo di comandi az-pipelines fa parte dell'estensione DevOps per l'interfaccia della riga di comando di Azure, che richiede la versione 2.30.0 o successiva. L'estensione Azure DevOps viene installata automaticamente la prima volta che si esegue un azure pipelines comando. Per altre informazioni su come iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.
È anche possibile usare i parametri globali dell'interfaccia della riga di comando di Azure, ad esempio debug, helponly-show-errorsqueryoutpute verbose, nei comandi dell'interfaccia della riga di comando di Azure DevOps. Il valore table per il parametro --output globale presenta l'output in un formato amichevole. Per altre informazioni, vedere Formati di output per i comandi dell'interfaccia della riga di comando di Azure.
È possibile impostare l'organizzazione di Azure DevOps predefinita per i comandi dell'interfaccia della riga di comando di Azure DevOps usando az devops configure --defaults organization=<YourOrganizationURL>o usare il --detect true parametro per rilevare automaticamente l'organizzazione. È possibile configurare il progetto Azure DevOps predefinito usando az devops configure -d project=<Project Name or ID>.
Se non si rileva l'organizzazione o non si configura un'organizzazione o un progetto predefinito, oppure se non si selezionano l'organizzazione e il progetto tramite git config, è necessario specificare i parametri org e project in ogni comando.
Elencare le pipeline esistenti
I comandi della pipeline run, show, update e delete richiedono o il name o il id della pipeline che si desidera gestire. Se si usa id, il name parametro viene ignorato. Per ottenere un elenco di pipeline di progetto, inclusi i relativi ID, usare il comando az pipelines list . È possibile filtrare o formattare l'elenco dei risultati usando i parametri.
Ad esempio, il comando seguente elenca le pipeline di progetto con nomi che iniziano con python*, in formato tabella.
az pipelines list --name python* --output table
Risultato:
ID Path Name Status Default Queue
---- ------ -------------------------- -------- ---------------
17 \ python-sample-vscode-flask disabled Azure Pipelines
24 \ python-sample-get-started enabled Azure Pipelines
Per informazioni di riferimento sul comando completo, vedere az pipelines list.
Visualizzare i dettagli per una pipeline
Per visualizzare i dettagli di una pipeline esistente, usare il comando az pipelines show . Ad esempio, il comando seguente mostra i dettagli della pipeline con ID di 12, e apre la pagina di riepilogo della pipeline nel browser Web.
az pipelines show --id 12 --open
Per informazioni di riferimento complete sui comandi, vedere az pipelines show.
Eseguire una pipeline
Per accodare ed eseguire una pipeline esistente, usare il comando az pipelines run . È possibile impostare parameters e variables da usare nell'esecuzione.
Ad esempio, il comando seguente esegue la pipeline con name di myGithubname.pipelines-java nel branch pipeline, imposta il valore della variabile var1 su 100 per l'esecuzione e restituisce i risultati nel formato table.
az pipelines run --name myGithubname.pipelines-java --branch pipeline --variables var1=100 --output table
Risultato:
Run ID Number Status Result Pipeline ID Pipeline Name Source Branch Queued Time Reason
-------- ---------- ---------- -------- ------------- --------------------------- --------------- -------------------------- --------
123 20200123.2 notStarted 12 myGithubname.pipelines-java pipeline 2020-01-23 11:55:56.633450 manual
Per informazioni di riferimento complete sui comandi, vedere az pipelines run.
Aggiornare una pipeline
Per aggiornare una pipeline esistente, usare il comando az pipelines update . Ad esempio, il comando seguente aggiorna la pipeline con l'oggetto id di 12 con un nuovo nome e una nuova descrizione e restituisce il risultato in formato tabella.
az pipelines update --id 12 --description "rename pipeline" --new-name updatedname.pipelines-java --output table
Risultato:
ID Name Status Default Queue
---- -------------------------- -------- ------------------
12 updatedname.pipelines-java enabled Hosted Ubuntu 1604
Per informazioni di riferimento complete sui comandi, vedere az pipelines update.
Eliminare una pipeline
Per eliminare una pipeline, eseguire il comando az-pipelines-delete . Ad esempio, il comando seguente elimina la pipeline con ID di 12 e non richiede conferma. Se non si include il parametro --yes, per impostazione predefinita viene richiesta una conferma.
az pipelines delete --id 12 --yes
Per informazioni di riferimento complete sui comandi, vedere az pipelines delete.
Creare e configurare pipeline a livello di codice
Per usare l'interfaccia della riga di comando di Azure DevOps per creare una pipeline YAML, vedere az pipelines create. Per eseguire i comandi dell'interfaccia della riga di comando di Azure nelle pipeline YAML, vedere Interfaccia della riga di comando di Azure DevOps in Azure Pipelines YAML.
È possibile creare pipeline YAML per compilare, configurare, testare e distribuire app nel linguaggio preferito. Per altre informazioni, vedere gli articoli seguenti:
- Compilare, testare e distribuire app .NET Core
- Compilare e testare progetti Go
- Sviluppare app Java
- Compilare e pubblicare un pacchetto Node.js
- Compilare e pubblicare un'app Python
- Creare un'immagine del contenitore per distribuire le app
- Personalizza la tua pipeline
Azure DevOps Services REST API
È possibile creare applicazioni o servizi personalizzati che si integrano con Azure DevOps usando le API REST per effettuare chiamate HTTP dirette. Per altre informazioni, vedere Azure DevOps Services REST API Reference (Informazioni di riferimento sull'API REST di Azure DevOps Services). È anche possibile usare le librerie client per queste API.
Ignorare una fase in un'esecuzione della pipeline
È possibile utilizzare il comando az rest con l'API REST Run Pipeline per ignorare una fase in un'esecuzione della pipeline usando il parametro stagesToSkip.
Ad esempio:
az rest --method post `
--uri https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=7.1-preview.1 `
--body "{'stagesToSkip': [''], 'resources': {'repositories': {'self': {'refName': 'refs/heads/{branch}'}}}}" `
--resource 499b84ac-1321-427f-aa17-267ca6975798
Per altre informazioni, vedere Usare l'API REST di Azure con Azure CLI.