Gestire le pipeline con l'interfaccia della riga di comando di Azure DevOps
Azure DevOps Services | 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 aggiornare 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 az-pipelines gruppo di comandi fa parte dell'estensione DevOps all'interfaccia della riga di comando di Azure, che richiede l'interfaccia della riga di comando di Azure 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, queryoutputhelponly-show-errorse verbose, nei comandi dell'interfaccia della riga di comando di Azure DevOps. Il table valore per il parametro globale presenta l'output --output in un formato descrittivo. 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 si configura un'organizzazione o un progetto predefinito oppure si seleziona l'organizzazione e il progetto tramite git config, è necessario specificare i org parametri e project in ogni comando.
Elencare le pipeline esistenti
I runcomandi della pipeline , show, updatee delete richiedono o name id della pipeline che si vuole 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
Output:
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 e 12apre la pagina di riepilogo della pipeline nel Web browser.
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 in myGithubname.pipelines-java name nel pipeline ramo , imposta il valore della variabile var1 su 100 per l'esecuzione e restituisce il formato.table
az pipelines run --name myGithubname.pipelines-java --branch pipeline --variables var1=100 --output table
Output:
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
Output:
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 e 12non richiede conferma. Se non si include il --yes parametro , per impostazione predefinita viene richiesto il prompt dei comandi per la 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
- Compilare app Java
- Compilare e pubblicare un pacchetto Node.js
- Compilare e pubblicare un'app Python
- Creare un'immagine del contenitore per distribuire le app
- Personalizzare la 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 usare il comando az rest con l'API REST Della pipeline di esecuzione per ignorare una fase in un'esecuzione della pipeline usando il stagesToSkip parametro .
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 l'interfaccia della riga di comando di Azure.