Definire la pipeline classica
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018
Nota
In Microsoft Team Foundation Server (TFS) 2018 e versioni precedenti, le pipeline di compilazione e rilascio sono chiamate definizioni, le esecuzioni vengono chiamate build, le connessioni al servizio vengono chiamate endpoint di servizio, le fasi vengono chiamate ambienti e i processi vengono chiamati fasi.
Azure Pipelines offre una pipeline altamente configurabile e gestibile per le versioni in più fasi, ad esempio sviluppo, staging, qa e produzione. offre anche l'opportunità di implementare i cancelli e le approvazioni in ogni fase specifica.
In questa esercitazione si approfondiranno i seguenti argomenti:
- Trigger di distribuzione continua
- Aggiunta di fasi
- Aggiunta di approvazioni di pre-distribuzione
- Creazione di versioni e distribuzioni di monitoraggio
Prerequisiti
Sono necessari gli elementi seguenti:
Pipeline di versione contenente almeno una fase. Se non ne hai già uno, puoi crearlo usando una delle guide introduttive e delle esercitazioni seguenti:
Due destinazioni separate in cui si distribuirà l'app. Queste potrebbero essere macchine virtuali, server Web, gruppi di distribuzione fisici locali o altri tipi di destinazione di distribuzione. In questo esempio si usano Servizio app di Azure istanze del sito Web. Se si decide di eseguire la stessa operazione, è necessario scegliere i nomi univoci, ma è consigliabile includere "QA" nel nome di uno e "Produzione" nel nome dell'altro in modo da poterli identificare facilmente. Usare il portale di Azure per creare una nuova app Web.
Trigger di distribuzione continua (CD)
L'abilitazione del trigger di distribuzione continua indicherà alla pipeline di creare automaticamente una nuova versione ogni volta che è disponibile una nuova compilazione.
In Azure Pipelines aprire la scheda Versioni . Selezionare la pipeline di versione selezionare Modifica.
Selezionare l'icona trigger di distribuzione continua nella sezione Artefatti per aprire il pannello trigger. Assicurarsi che questa operazione sia abilitata in modo che venga creata una nuova versione dopo il completamento di ogni nuova compilazione completata.
Selezionare l'icona Condizioni di pre-distribuzione nella sezione Fasi per aprire il pannello condizioni. Assicurarsi che il trigger per la distribuzione in questa fase sia impostato su Dopo la versione. Ciò significa che una distribuzione verrà avviata automaticamente quando viene creata una nuova versione da questa pipeline di versione.
È anche possibile configurare i trigger di rilascio, i trigger di fase o pianificare le distribuzioni.
Aggiungere fasi
In questa sezione verranno aggiunte due nuove fasi alla pipeline di rilascio: qa e produzione (due siti Web di servizi app Azure in questo esempio). Si tratta di uno scenario tipico in cui si distribuisce inizialmente in un server di test o di gestione temporanea e quindi in un server di produzione o in tempo reale. Ogni fase rappresenta una destinazione di distribuzione.
Selezionare la scheda Pipeline nella pipeline di versione e selezionare la fase esistente. Modificare il nome della fase in Produzione.
Selezionare l'elenco a discesa + Aggiungi e scegliere Clona fase (l'opzione clone è disponibile solo quando è selezionata una fase esistente).
In genere, si desidera usare gli stessi metodi di distribuzione con un test e una fase di produzione in modo che sia possibile assicurarsi che le app distribuite si comportano allo stesso modo. La clonazione di una fase esistente è un buon modo per assicurarsi di avere le stesse impostazioni per entrambi. È quindi sufficiente modificare le destinazioni di distribuzione.
La fase clonata avrà il nome Copia di produzione. Selezionarlo e modificare il nome in QA.
Per riorganizzare le fasi nella pipeline, selezionare l'icona Delle condizioni di pre-distribuzionenella fase di qa e impostare il trigger su Dopo la versione. Il diagramma della pipeline mostrerà quindi le due fasi in parallelo.
Selezionare l'icona Condizioni di pre-distribuzione nella fase di produzione e impostare il trigger su Dopo la fase, quindi selezionare QA nell'elenco a discesa Fasi . Il diagramma della pipeline indicherà ora che le due fasi verranno eseguite nell'ordine corretto.
Nota
È possibile configurare la distribuzione per iniziare quando una distribuzione nella fase precedente ha esito positivo . Ciò significa che la distribuzione continuerà anche se un'attività non critica specifica non è riuscita. Questa operazione viene in genere usata in una fork e nelle distribuzioni di join che vengono distribuite in fasi diverse in parallelo.
Selezionare l'elenco a discesa Attività e selezionare la fase di controllo di controllo dei dati.
A seconda delle attività in uso, modificare le impostazioni in modo che questa fase venga distribuita nella destinazione "QA". Nell'esempio verrà usata l'attività Distribuisci Servizio app di Azure, come illustrato di seguito.
Aggiungere approvazioni di pre-distribuzione
La pipeline di versione precedentemente modificata distribuisce in qa e produzione. Se la distribuzione a QA ha esito negativo, la distribuzione nell'ambiente di produzione non verrà attivata. È consigliabile verificare sempre se l'app funziona correttamente nella fase di controllo della qualità o del test prima della distribuzione in produzione. L'aggiunta di approvazioni garantisce che tutti i criteri vengano soddisfatti prima della distribuzione nella fase successiva. Per aggiungere approvazioni alla pipeline, seguire questa procedura:
Selezionare la scheda Pipeline , l'icona Condizioni di pre-distribuzione e quindi l'approvazione pre-distribuzione.
Nella casella di testo Approvatori immettere gli utenti che saranno responsabili dell'approvazione della distribuzione. È anche consigliabile deselezionare la casella di controllo L'utente che richiede una versione o una distribuzione non deve approvarla .
È possibile aggiungere tutti i responsabili di approvazione necessari, sia singoli utenti che gruppi di organizzazioni. È anche possibile configurare le approvazioni post-distribuzione selezionando l'icona "utente" a destra della fase nel diagramma della pipeline. Per altre informazioni, vedere Rilascia i cancelli e le approvazioni.
Selezionare Salva.
Creare una versione
Dopo aver completato la configurazione della pipeline di rilascio, è ora di avviare la distribuzione. A tale scopo, verrà creata manualmente una nuova versione. In genere una versione viene creata automaticamente quando è disponibile un nuovo artefatto di compilazione. Tuttavia, in questo scenario verrà creato manualmente.
Selezionare l'elenco a discesa Versione e scegliere Crea versione.
Immettere una descrizione per la versione, verificare che gli artefatti corretti siano selezionati e quindi selezionare Crea.
Verrà visualizzato un banner che indica che è stata creata una nuova versione. Selezionare il collegamento alla versione per visualizzare altri dettagli.
La pagina di riepilogo della versione mostrerà lo stato della distribuzione a ogni fase.
Altre visualizzazioni, ad esempio l'elenco delle versioni, visualizzano anche un'icona che indica che l'approvazione è in sospeso. L'icona mostra un popup contenente il nome della fase e altri dettagli quando si punta a esso. In questo modo, un amministratore può vedere quali versioni sono in attesa di approvazione, nonché lo stato generale di avanzamento di tutte le versioni.
Selezionare l'icona pending_approval per aprire il pannello della finestra di approvazione. Immettere un breve commento e selezionare Approva.
Nota
È possibile pianificare la distribuzione in una data successiva, ad esempio durante le ore non di punta. È anche possibile riassegnare l'approvazione a un utente diverso. Gli amministratori del rilascio possono accedere ed eseguire l'override di tutte le decisioni di approvazione.
Monitorare le distribuzioni
I log di distribuzione consentono di monitorare ed eseguire il debug della versione dell'applicazione. Per controllare i log della distribuzione, seguire questa procedura:
Nel riepilogo della versione passare il puntatore del mouse su una fase e selezionare Log.
Durante la distribuzione, è comunque possibile accedere alla pagina dei log per visualizzare i log attivi di ogni attività.
Selezionare qualsiasi attività per visualizzare i log per l'attività specifica. In questo modo è più semplice tenere traccia dei problemi di distribuzione ed eseguirne il debug. È anche possibile scaricare singoli log attività o un file ZIP di tutti i file di log.
Se sono necessarie informazioni aggiuntive per eseguire il debug della distribuzione, è possibile eseguire la versione in modalità di debug.