Crea la tua prima pipeline

Questa è una guida dettagliata all'uso di Azure Pipelines per compilare un'applicazione di esempio da un repository Git. Questa guida usa le pipeline YAML configurate con l'editor delle pipeline YAML.

Per altre informazioni sulle diverse sezioni di una pipeline YAML, vedere pipeline nello schema YAML Azure Pipelines schema YAML e Customizzare la pipeline YAML.

Se invece si vogliono usare le pipeline classiche, vedere Definire la pipeline classica. Per indicazioni sull'uso di TFVC, vedere Creare repository TFVC.

Prerequisiti - Azure DevOps

Assicurarsi di avere quanto segue:

• Un account GitHub in cui è possibile creare un repository. Creane uno gratis.

• Un'organizzazione Azure DevOps. Creane uno gratis. Qualora il team ne abbia già uno, assicura di essere un amministratore del progetto Azure DevOps che desideri utilizzare.

• Possibilità di eseguire pipeline su agenti ospitati da Microsoft. Per usare gli agenti ospitati da Microsoft, l'organizzazione Azure DevOps deve avere accesso ai processi paralleli ospitati da Microsoft. È possibile acquistare un job parallelo oppure richiedere una sovvenzione gratuita.

Crea la tua prima pipeline

https://github.com/MicrosoftDocs/pipelines-java

https://github.com/MicrosoftDocs/pipelines-dotnet-core

https://github.com/Microsoft/python-sample-vscode-flask-tutorial

https://github.com/Azure-Samples/js-e2e-express-server

Visualizzare e gestire le pipeline

È possibile visualizzare e gestire le pipeline scegliendo Pipeline dal menu a sinistra per passare alla pagina di destinazione delle pipeline.

Dalla pagina di destinazione delle pipeline è possibile visualizzare le pipeline e le esecuzioni delle pipeline, creare e importare pipeline, gestire la sicurezza e approfondire i dettagli delle pipeline e delle esecuzioni.

Scegliere Recenti per visualizzare le pipeline di esecuzione di recente (visualizzazione predefinita) o scegliere Tutti per visualizzare tutte le pipeline.

Selezionare una pipeline per gestirla e visualizzare le esecuzioni. Selezionare il numero della build dell'ultima esecuzione per visualizzarne i risultati, selezionare il nome del ramo per visualizzare il ramo di tale esecuzione, oppure selezionare il menu di scelta rapida per eseguire la pipeline ed effettuare altre azioni di gestione.

Selezionare Esecuzioni per visualizzare tutte le esecuzioni della pipeline. Facoltativamente, è possibile filtrare le esecuzioni visualizzate.

Selezionare un'esecuzione della pipeline per visualizzarne le informazioni.

È possibile scegliere di mantenere o eliminare un'esecuzione dal menu di scelta rapida. Per altre informazioni sulla conservazione delle esecuzioni, vedere Criteri di conservazione per la compilazione e il rilascio.

Visualizzare i dettagli della pipeline

La pagina dei dettagli per una pipeline consente di visualizzare e gestire la pipeline.

Screenshot della pagina dei dettagli della pipeline.

Scegliere Modifica per modificare la pipeline. Per altre informazioni, vedere Editor di pipeline YAML. È anche possibile modificare la pipeline modificando il file azure-pipelines.yml direttamente nel repository che ospita la pipeline.

Visualizzare i dettagli dell'esecuzione della pipeline

Dal riepilogo dell'esecuzione della pipeline è possibile visualizzare lo stato dell'esecuzione, sia durante l'esecuzione che al termine.

Dal riquadro di riepilogo è possibile visualizzare i dettagli del processo e della fase, scaricare gli artefatti e passare ai commit collegati, ai risultati dei test e agli elementi di lavoro.

Lavori e fasi

Nel riquadro dei lavori viene visualizzata una panoramica dello stato delle tue fasi e lavori. Questo riquadro può avere più schede a seconda che la pipeline abbia fasi e processi o solo processi. In questo esempio la pipeline ha due fasi denominate Build and Deploy. È possibile approfondire i passaggi della pipeline scegliendo il lavoro dal riquadro Fasi o Lavori.

Scegli un lavoro per vedere i passaggi di quel lavoro.

Dalla visualizzazione dei passaggi è possibile esaminare lo stato e i dettagli di ogni passaggio. Dalle altre azioni è possibile attivare o disattivare i timestamp o visualizzare un log non elaborato di tutti i passaggi della pipeline.

Annullare ed eseguire di nuovo una pipeline

Se la pipeline è in esecuzione, è possibile annullarla scegliendo Annulla. Se l'esecuzione è stata completata, è possibile eseguire nuovamente la pipeline scegliendo Esegui nuovo.

Menu Esegui altre azioni della pipeline

Dal menu Altre azioni è possibile scaricare i log, aggiungere tag, modificare la pipeline, eliminare l'esecuzione e configurare la conservazione per l'esecuzione.

Screenshot del menu Altre azioni della pagina di riepilogo dell'esecuzione della pipeline.

Aggiungi un badge di stato al tuo repository

A molti sviluppatori piace dimostrare di mantenere alta la qualità del codice visualizzando una notifica di stato nel proprio repository.

Per copiare negli Appunti il badge di stato:

1. In Azure Pipelines passare alla pagina Pipelines per visualizzare l'elenco delle pipeline. Selezionare la pipeline creata nella sezione precedente.

2. Selezionare , e quindi selezionare badge di stato.

3. Selezionare badge di stato.

4. Copia l'esempio di Markdown dalla sezione "Sample markdown".

Ora con il badge Markdown negli appunti, segui questi passaggi in GitHub:

1. Passare all'elenco dei file e selezionare Readme.md. Seleziona l'icona raffigurante una matita per apportare modifiche.

2. Incollare il badge di stato Markdown all'inizio del file.

3. Effettua il commit della modifica sul main ramo.

4. Si noti che il badge di stato viene visualizzato nella descrizione del repository.

Per configurare l'accesso anonimo alle notifiche per i progetti privati:

1. Passare a Impostazioni del Progetto nell'angolo in basso a sinistra della pagina

2. Aprire la scheda Impostazioni in Pipeline

3. Attivare il cursore Disabilita accesso anonimo ai badge in Generale

Poiché il file è stato appena modificato in questo repository, Azure Pipelines compila automaticamente il codice, in base alla configurazione nel file />

Verrà illustrato come usare l'editor classico in Azure DevOps Server 2019 per creare una build e una versione che stampa "Hello world".

1. Passare a Azure Repos. (L'Hub del Codice nella navigazione precedente)

   file

2. Se il progetto è vuoto, verrà visualizzata una schermata che consente di aggiungere codice al repository. Scegliere la scelta inferiore per inizializzare il repository con un readme file:

   

1. Passare a Azure Repos.

2. Aggiungere un file.

   

3. Nella finestra di dialogo assegnare un nome al nuovo file e crearlo.

   HelloWorld.ps1
   

4. Copiare e incollare questo script.

   Write-Host "Hello world"
   

5. Completare il commit (salvare) il file.

1. Selezionare Azure Pipelines, verrà visualizzata automaticamente la pagina Builds.

   

2. Crea una nuova pipeline.

   

   Per i nuovi utenti Azure DevOps, verrà visualizzata automaticamente l'esperienza di creazione della pipeline YAML. Per accedere all'editor classico e completare questa guida, è necessario disattivare la funzionalità di anteprima per l'esperienza di creazione della nuova pipeline YAML:

   

   

3. Assicurarsi che l'origine, il progetto, il repository e il ramo predefinito corrispondano al percorso in cui è stato creato lo script.

4. Iniziare con un lavoro vuoto.

5. Sul lato sinistro selezionare Pipeline e specificare il nome che si vuole usare. Per il pool agenti, selezionare Hosted VS2017.

6. Sul lato sinistro selezionare il simbolo più ( + ) per aggiungere un'attività al Job 1. Sul lato destro selezionare la categoria Utilità , selezionare l'attività di PowerShell dall'elenco e quindi scegliere Aggiungi.

   

7. Sul lato sinistro, selezionare la nuova attività script di PowerShell.

8. Per l'argomento Percorso script, selezionare il pulsante per esplorare il repository e selezionare quello script creato.

   

9. Selezionare Salva e accoda e quindi Salva.

1. Nella scheda Attività selezionare il segno più ( + ) per aggiungere un'attività al processo 1.

2. Selezionare la categoria Utilità , selezionare l'attività Pubblica elementi di compilazione e quindi selezionare Aggiungi.

   

   Percorso di pubblicazione: selezionare il pulsante per esplorare e selezionare lo script creato.

   Nome artefatto: immettere drop.

   Posizione di pubblicazione degli artifact: selezionare Azure Artifacts/TFS.

1. Selezionare Salva e coda e quindi selezionare Salva e coda.

2. Nella finestra di dialogo selezionare Salva e accoda nuovamente.

   Viene accodata una nuova build sull'agente ospitato da Microsoft.

3. Viene visualizzato un collegamento alla nuova build nella parte superiore della pagina.

   

   Scegli il collegamento per guardare il nuovo build mentre accade. Dopo aver allocato l'agente, si inizierà a visualizzare i log in tempo reale della compilazione. Si noti che lo script di PowerShell viene eseguito come parte della compilazione e che "Hello world" viene stampato nella console.

   

4. Passare al riepilogo del build. Nella scheda Artefatti del build, nota che lo script viene pubblicato come artefatto.

   

Ora è possibile visualizzare i risultati delle modifiche. Passare a Azure Pipelines e selezionare Queued. Notare che nella sezione In coda o in esecuzione una build viene attivata automaticamente dalla modifica a cui hai fatto il commit.

1. Passare alla scheda Pipelines e quindi selezionare Rilasci.

2. Selezionare l'azione per creare una nuova pipeline. Se è già stata creata una pipeline di rilascio, selezionare il segno più ( + ) e quindi selezionare Crea una pipeline di rilascio.

3. Seleziona l'azione per iniziare con un incarico vuoto.

4. Denomina la fase QA.

5. Nel pannello Artefatti, selezionare + Aggiungi e specificare una Origine (pipeline di compilazione). Seleziona Aggiungi.

6. Selezionare il fulmine per attivare la distribuzione continua e abilitare l'attivatore di distribuzione continua a destra.

   

7. Selezionare la scheda Attività e selezionare la fase di controllo di qualità .

8. Selezionare il segno più ( + ) per il lavoro per aggiungere un'attività al lavoro.

9. Nella finestra di dialogo Aggiungi attività selezionare Utilità, individuare l'attività di PowerShell e quindi selezionare il pulsante Aggiungi .

10. Sul lato sinistro, selezionare la nuova attività script di PowerShell.

11. Per l'argomento Percorso script, selezionare il pulsante per sfogliare gli artefatti e selezionare lo script che hai creato.

12. Aggiungere gli argomenti seguenti:

    -greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"
    

13. Nella scheda Pipeline selezionare la fase QA e selezionare Clona.

    

14. Rinominare la fase clonata Production.

15. Rinominare la pipeline di rilascio Hello world.

    

16. Salvare la pipeline di rilascio.

1. Creare una nuova versione.

   

   Quando viene visualizzata l'opzione Crea nuova versione , selezionare Crea.

2. Apri la versione che hai creato.

   

3. Visualizzare i log per ottenere dati in tempo reale sulla versione.

   

Si è appreso come creare la prima pipeline in Azure. Altre informazioni sulla configurazione delle pipeline nel linguaggio preferito:

• .NET Core
• Go
• Java
• Node.js
• Python
• Contenitori

In alternativa, è possibile procedere alla personalizzazione della pipeline creata.

Per eseguire la pipeline in un contenitore, vedere Processi contenitore.

Per informazioni dettagliate sulla creazione di repository GitHub, vedere Build GitHub repository.

Per informazioni su come pubblicare gli artefatti della pipeline, vedere Pubblicare artefatti della pipeline.

Per informazioni sulle altre operazioni che è possibile eseguire nelle pipeline YAML, vedere Informazioni di riferimento sullo schema YAML.

Eseguire la pulizia

Se sono state create pipeline di test, è facile eliminarle al termine dell'operazione.

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]

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

az pipelines list --output table

ID    Path    Name           Status    Default Queue
----  ------  -------------  --------  ------------------
6     \       FabrikamFiber  enabled   Hosted Ubuntu 1604

az pipelines delete --id 6

Are you sure you want to delete this pipeline? (y/n): y
Pipeline 6 was deleted successfully.

• Clienti

  • Visual Studio Code per Windows, macOS e Linux
  • Visual Studio con Git per Windows o Visual Studio per Mac
  • Eclissi
  • Xcode
  • IntelliJ
  • Riga di comando

• Servizi

  • Azure Pipelines
  • Provider di servizi Git, ad esempio Azure Repos Git, GitHub e Bitbucket Cloud
  • Subversion

Come posso replicare una pipeline?

Se la pipeline ha un modello che si vuole replicare in altre pipeline, clonarlo, esportarlo o salvarlo come modello.

Dopo aver clonato una pipeline, è possibile apportare modifiche e quindi salvarla.

Dopo aver esportato una pipeline, è possibile importarla dalla scheda Tutte le pipeline.

Dopo aver creato un modello, i membri del team possono usarlo per seguire il modello nelle nuove pipeline.

Come lavoro con le bozze?

Se si sta modificando una pipeline di compilazione e si vogliono testare alcune modifiche non ancora pronte per l'ambiente di produzione, è possibile salvarla come bozza.

Quali altre cose posso fare quando accodo una build?

È possibile accodare le compilazioni automaticamente o manualmente.

Quando si accoda manualmente una compilazione, è possibile, per una singola esecuzione della compilazione:

• Specificare il pool in cui viene inserita la compilazione.

• Aggiungere e modificare alcune variabili.

• Aggiungi richieste.

• In un repository Git

  • Creare un ramo o un tag.

  • Compilare un commit.

Per altre informazioni sulle impostazioni della pipeline, vedere:

• Recupero di origini
• Attività
• Variabili
• Trigger
• Conservazione
• Cronologia

Come posso creare programmaticamente una pipeline di compilazione?

Informazioni di riferimento sull'API REST: Creare una pipeline di compilazione