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 2022 - Azure DevOps Server 2019
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. 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. Crearne una gratuitamente.
Un'organizzazione di Azure DevOps. Crearne una gratuitamente. Se il tuo team ne ha già uno, assicurati di essere un amministratore del progetto Azure DevOps che vuoi usare.
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
Ottenere il codice di esempio Java
Per iniziare, creare un fork del repository seguente nell'account GitHub.
https://github.com/MicrosoftDocs/pipelines-java
Crea la tua prima pipeline Java
Accedere all'organizzazione di Azure DevOps e passare al progetto.
Passare a Pipeline e quindi selezionare Nuova pipeline o Crea pipeline se si crea la prima pipeline.
Eseguire i passaggi della procedura guidata selezionando prima di tutto GitHub come posizione del codice sorgente.
Si potrebbe essere reindirizzati a GitHub per l'accesso. In questo caso, immettere le credenziali di GitHub.
Quando si vede l’elenco dei repository, selezionarne uno.
È possibile che si venga reindirizzati a GitHub per installare l'app Azure Pipelines. In tal caso, selezionare Approva e installa.
Azure Pipelines analizzerà il repository e consiglierà il modello di pipeline Maven .
Quando viene visualizzata la nuova pipeline, controlla il tuo file YAML per vedere cosa fa. Quando si è pronti, selezionare Salva ed esegui.
Viene richiesto di eseguire il commit di un nuovo
azure-pipelines.ymlfile nel repository. Dopo essere soddisfatto del messaggio, seleziona di nuovo Salva ed esegui.Se vuoi guardare la tua pipeline in azione, seleziona il processo di build.
Hai appena creato ed eseguito una pipeline che abbiamo creato automaticamente per te, perché il tuo codice sembrava essere adatto per il modello Maven.
È ora disponibile una pipeline YAML funzionante (
azure-pipelines.yml) nel repository che è pronta per la personalizzazione.Quando si è pronti per apportare modifiche alla pipeline, selezionarla nella pagina Pipeline e quindi Modificare il
azure-pipelines.ymlfile.
Scopri di più su come lavorare con Java nella tua pipeline.
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.
Nota
Non è possibile eliminare un'esecuzione se questa viene conservata. Se non viene visualizzato Elimina, scegliere Interrompi il mantenimento dell'esecuzione e quindi eliminare l'esecuzione. Se viene visualizzata sia l'opzione Elimina che Visualizza versioni di conservazione, uno o più criteri di conservazione configurati vengono ancora applicati all'esecuzione. Scegliere Visualizza versioni di conservazione, eliminare i criteri (vengono rimossi solo i criteri per l'esecuzione selezionata) e quindi eliminare l'esecuzione.
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:
In Azure Pipelines passare alla pagina Pipelines per visualizzare l'elenco delle pipeline. Selezionare la pipeline creata nella sezione precedente.
Selezionare
, e quindi selezionare badge di stato.Selezionare badge di stato.
Copia l'esempio di Markdown dalla sezione "Sample markdown".
Ora, con il badge Markdown nella clipboard, segui questi passaggi in GitHub:
Passare all'elenco dei file e selezionare
Readme.md. Seleziona l'icona raffigurante una matita per apportare modifiche.Incollare il badge di stato Markdown all'inizio del file.
Effettua il commit della modifica sul
mainramo.Si noti che il badge di stato viene visualizzato nella descrizione del repository.
Per configurare l'accesso anonimo alle notifiche per i progetti privati:
Passare a Impostazioni del Progetto nell'angolo in basso a sinistra della pagina
Aprire la scheda Impostazioni in Pipeline
Attivare il cursore Disabilita accesso anonimo ai badge in Generale
Nota
Anche in un progetto privato, l'accesso anonimo tramite badge è abilitato per impostazione predefinita. Con l'accesso tramite badge anonimo abilitato, gli utenti esterni all'organizzazione potrebbero essere in grado di eseguire query su informazioni quali nomi di progetto, nomi di ramo, nomi di processi e stato di compilazione tramite l'API di stato badge.
Poiché il Readme.md file è stato appena modificato in questo repository, Azure Pipelines compila automaticamente il codice, in base alla configurazione nel azure-pipelines.yml file nella radice del repository. Ritornando ad Azure Pipelines, osserva che viene visualizzata una nuova esecuzione. Ogni volta che si apporta una modifica, Azure Pipelines avvia una nuova esecuzione.
Verrà illustrato come usare l'editor classico in Azure DevOps Server 2019 per creare una build e una versione che stampa "Hello world".
Prerequisiti
- Un agente Windows auto-ospitato.
Inizializza il tuo repository
Se nel progetto è già presente un repository, è possibile passare al passaggio successivo: Ignorare l'aggiunta di uno script al repository
Passare ad Azure Repos. (L'Hub del Codice nella navigazione precedente)
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
readmefile:
Passare ad Azure Repos.
Aggiungere un file.
Nella finestra di dialogo assegnare un nome al nuovo file e crearlo.
HelloWorld.ps1Copiare e incollare questo script.
Write-Host "Hello world"Completare il commit (salvare) il file.
In questa esercitazione, l'attenzione riguarda CI/CD, quindi la parte del codice viene semplificata. Stiamo lavorando in un repository Git di Azure Repos direttamente nel tuo browser web.
Quando si è pronti per iniziare a creare e distribuire un'app reale, è possibile usare un'ampia gamma di client e servizi di controllo della versione con le build CI di Azure Pipelines. Altre informazioni.
Creazione di una pipeline di compilazione
Creare una pipeline di compilazione che stampa "Hello world".
Selezionare Azure Pipelines. Verrà visualizzata automaticamente la pagina Compilazioni.
Crea una nuova pipeline.
Per i nuovi utenti di Azure DevOps, si passerà automaticamente all'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:
Assicurarsi che l'origine, il progetto, il repository e il ramo predefinito corrispondano al percorso in cui è stato creato lo script.
Iniziare con un lavoro vuoto.
Sul lato sinistro selezionare Pipeline e specificare il nome che si vuole usare. Per il pool agenti, selezionare Hosted VS2017.
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.
Sul lato sinistro, selezionare la nuova attività script di PowerShell.
Per l'argomento Percorso script, selezionare il pulsante
per esplorare il repository e selezionare quello script creato.
Selezionare Salva e accoda e quindi Salva.
Una build pipeline è l'entità tramite cui si definisce la propria pipeline di compilazione automatizzata. Nella pipeline di compilazione componi un insieme di attività, ognuna delle quali esegue un passaggio nella compilazione. Il catalogo attività offre un set ricco di attività da cui iniziare. È anche possibile aggiungere script di PowerShell o shell alla pipeline di compilazione.
Pubblica un artefatto dal processo di build
Una compilazione tipica produce un artefatto che può quindi essere distribuito in varie fasi in una versione. Qui per illustrare la funzionalità in modo semplice, lo script verrà semplicemente pubblicato come artefatto.
Nella scheda Attività selezionare il segno più ( + ) per aggiungere un'attività al processo 1.
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.Destinazione pubblicazione artefatto: selezionare Azure Artifacts/TFS.
Gli artefatti sono i file che vuoi ottenere dalla tua compilazione. Gli artefatti possono essere quasi tutto ciò di cui il tuo team ha bisogno per testare o distribuire la tua app. Ad esempio, hai file eseguibili .DLL e .EXE e un file di simboli .PDB di un'applicazione Windows C# o C++ .NET.
Per consentirti di produrre artefatti, vengono forniti strumenti come la copia con ricerca di pattern e una directory temporanea in cui puoi riunire i tuoi artefatti prima di pubblicarli. Vedi Artefatti in Azure Pipelines.
Abilitare l'integrazione continua (CI)
Selezionare la scheda Trigger.
Abilitare l'integrazione continua.
Un trigger di integrazione continua in una pipeline di compilazione indica che il sistema deve accodare automaticamente una nuova compilazione ogni volta che viene eseguito il commit di un cambiamento al codice. È possibile rendere il trigger più generale o più specifico e anche pianificare la compilazione (ad esempio, su base notturna). Consulta Trigger di compilazione.
Salvare e accodare la compilazione
Salvare e accodare una compilazione manualmente e testare la pipeline di compilazione.
Selezionare Salva e coda e quindi selezionare Salva e coda.
Nella finestra di dialogo selezionare Salva e accoda nuovamente.
Viene accodata una nuova build sull'agente ospitato da Microsoft.
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.
Passare al riepilogo del build. Nella scheda Artefatti del build, nota che lo script viene pubblicato come artefatto.
Aggiungere alcune variabili ed eseguire il commit di una modifica allo script
Verranno passate alcune variabili di compilazione allo script per rendere la pipeline un po' più interessante. Si eseguirà quindi il commit di una modifica a uno script e si osserverà l'esecuzione automatica della pipeline CI per convalidare la modifica.
Modificare la pipeline di compilazione.
Nella scheda Attività selezionare l'attività di PowerShell script.
Aggiungere questi argomenti.
Argomenti
-greeter "$(Build.RequestedFor)" -trigger "$(Build.Reason)"
Infine, salvare la pipeline di compilazione.
Successivamente si aggiungeranno gli argomenti allo script.
Passare ai File in Azure Repos (il hub Codice nella navigazione precedente e in TFS).
Selezionare il file HelloWorld.ps1 e quindi Modificare il file.
Modificare lo script come segue:
Param( [string]$greeter, [string]$trigger ) Write-Host "Hello world" from $greeter Write-Host Trigger: $triggerEsegui il commit (salva) lo script.
Ora è possibile visualizzare i risultati delle modifiche. Passare ad Azure Pipelines e selezionare In coda. Notare che nella sezione In coda o in esecuzione una build viene attivata automaticamente dalla modifica a cui hai fatto il commit.
Selezionare la nuova compilazione creata e visualizzarne il log.
Si noti che la persona che ha modificato il codice ha il nome stampato nel messaggio di saluto. Si vede anche stampato che questa era una compilazione CI.
In questi passaggi abbiamo appena introdotto il concetto di variabili di compilazione. È stato stampato il valore di una variabile che viene automaticamente predefinita e inizializzata dal sistema. È anche possibile definire variabili personalizzate e usarle negli argomenti delle attività o come variabili di ambiente all'interno degli script. Per altre informazioni sulle variabili, vedere Variabili di compilazione.
È disponibile una pipeline di compilazione. E adesso?
È stata creata una pipeline di compilazione che compila e convalida automaticamente il codice archiviato dal team. A questo punto, è possibile continuare con la sezione successiva per informazioni sulle pipeline di versione. In alternativa, se si preferisce, è possibile passare direttamente alla creazione di una pipeline di compilazione per l'app.
Creazione di una pipeline di rilascio
Definire il processo per l'esecuzione dello script in due fasi.
Passare alla scheda Pipelines e quindi selezionare Rilasci.
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.
Seleziona l'azione per iniziare con un incarico vuoto.
Denomina la fase QA.
Nel pannello Artefatti, selezionare + Aggiungi e specificare una Origine (pipeline di compilazione). Selezionare Aggiungi.
Selezionare il fulmine per attivare la distribuzione continua e abilitare l'attivatore di distribuzione continua a destra.
Selezionare la scheda Attività e selezionare la fase di controllo di qualità .
Selezionare il segno più ( + ) per il lavoro per aggiungere un'attività al lavoro.
Nella finestra di dialogo Aggiungi attività selezionare Utilità, individuare l'attività di PowerShell e quindi selezionare il pulsante Aggiungi .
Sul lato sinistro, selezionare la nuova attività script di PowerShell.
Per l'argomento Percorso script, selezionare il pulsante
per sfogliare gli artefatti e selezionare lo script che hai creato.Aggiungere gli argomenti seguenti:
-greeter "$(Release.RequestedFor)" -trigger "$(Build.DefinitionName)"Nella scheda Pipeline selezionare la fase QA e selezionare Clona.
Rinominare la fase clonata Production.
Rinominare la pipeline di rilascio Hello world.
Salvare la pipeline di rilascio.
Una pipeline di rilascio è una raccolta di fasi in cui gli artefatti generati dalla compilazione dell'applicazione vengono distribuiti. Definisce anche la pipeline di distribuzione effettiva per ogni fase, nonché il modo in cui gli artefatti vengono alzati di livello da una fase a un'altra.
Si noti anche che sono state usate alcune variabili negli argomenti dello script. In questo caso, sono stati usati variabili di rilascio anziché le variabili di compilazione usate per la pipeline di compilazione.
Distribuire una versione
Esegui lo script in ogni fase.
Creare una nuova versione.
Quando viene visualizzata l'opzione Crea nuova versione , selezionare Crea.
Apri la versione che hai creato.
Visualizzare i log per ottenere dati in tempo reale sulla versione.
È possibile tenere traccia dello stato di avanzamento di ogni versione per verificare se è stato distribuito in tutte le fasi. È possibile tenere traccia dei commit che fanno parte di ogni versione, degli elementi di lavoro associati e dei risultati di tutte le esecuzioni di test aggiunte alla pipeline di versione.
Modifica il codice e osserva come viene distribuito automaticamente in produzione.
Verrà apportata un'altra modifica allo script. Questa volta verrà costruita automaticamente e quindi distribuita fino alla fase di produzione.
Passare all'Hub del codice; scheda File, modificare il file HelloWorld.ps1 e cambiarlo come segue:
Param( [string]$greeter, [string]$trigger ) Write-Host "Hello world" from $greeter Write-Host Trigger: $trigger Write-Host "Now that you've got CI/CD, you can automatically deploy your app every time your team checks in code."Esegui il commit (salva) lo script.
Selezionare la scheda Compilazioni per visualizzare la compilazione in coda ed eseguire.
Al termine della compilazione, selezionare la scheda Versioni , aprire la nuova versione e quindi passare a Log.
Il nuovo codice viene distribuito automaticamente nella fase di controllo di qualità e quindi nella fase di produzione .
In molti casi, è probabile che si voglia modificare la pipeline di versione in modo che la distribuzione di produzione venga eseguita solo dopo alcuni test e approvazioni. Vedere Panoramica delle approvazioni e dei controlli.
Passaggi successivi
Si è appreso come creare la prima pipeline in Azure. Altre informazioni sulla configurazione delle pipeline nel linguaggio preferito:
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 Creare repository GitHub.
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.
Per eliminare una pipeline, passare alla pagina di riepilogo per la pipeline e scegliere Elimina dal menu ... in alto a destra della pagina. Digitare il nome della pipeline da confermare e scegliere Elimina.
Sono state apprese le nozioni di base per la creazione e l'esecuzione di una pipeline. A questo momento è possibile configurare la pipeline di compilazione per il linguaggio di programmazione in uso. Procedere e creare una nuova pipeline di compilazione e questa volta usare uno dei modelli seguenti.
| Lingua | Modello da usare |
|---|---|
| .NET | ASP.NET |
| .NET Core | ASP.NET Core |
| C++ | Desktop .NET |
| Go | Vai |
| Java | Gradle |
| JavaScript | Node.js |
| Xcode | Xcode |
Domande frequenti
Dove è possibile leggere articoli su DevOps e CI/CD?
Che cos'è l'integrazione continua?
Che cos'è la Consegna Continua?
Quale sistema di controllo della versione è possibile usare?
Quando si è pronti per iniziare a usare CI/CD per l'app, è possibile usare il sistema di controllo della versione preferito:
Clienti
Servizi
- Azure Pipelines
- Provider di servizi Git come Azure Repos Git, GitHub e Bitbucket Cloud
- Subversion
Clienti
Servizi
- Azure Pipelines
- Provider di servizi Git, ad esempio 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.
Suggerimento
Se si usa l'editor di nuova compilazione, i modelli personalizzati vengono visualizzati nella parte inferiore dell'elenco.
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.
È possibile modificare e testare la bozza in base alle esigenze.
Quando si è pronti, è possibile pubblicare la bozza per unire le modifiche nella pipeline di compilazione.
In alternativa, se si decide di eliminare la bozza, è possibile eliminarla dalla scheda Tutte le pipeline illustrata sopra.
Come è possibile eliminare una pipeline?
Per eliminare una pipeline, passare alla pagina di riepilogo per la pipeline e scegliere Elimina dal menu ... in alto a destra della pagina. Digitare il nome della pipeline da confermare e scegliere Elimina.
È 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
In un repository TFVC
Specificare la versione di origine come etichetta o insieme di modifiche.
Eseguire una compilazione privata di un shelveset. (È possibile usare questa opzione su un agente ospitato da Microsoft o un agente ospitato autonomamente.)
È possibile accodare le compilazioni automaticamente o manualmente.
Quando si accoda manualmente una compilazione, è possibile, per una singola esecuzione della compilazione:
Dove è possibile ottenere altre informazioni sulle impostazioni della pipeline?
Per altre informazioni sulle impostazioni della pipeline, vedere:
Come posso creare programmaticamente una pipeline di compilazione?
Informazioni di riferimento sull'API REST: Creare una pipeline di compilazione
Nota
È possibile gestire compilazioni e pipeline di compilazione anche dalla riga di comando o dagli script usando l'Azure Pipelines CLI.