Definire la pipeline classica

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Pipelines offre una pipeline altamente configurabile e gestibile per le versioni in più fasi, ad esempio sviluppo, gestione temporanea, controllo di qualità e produzione. offre anche l'opportunità di implementare controlli e 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

Saranno necessari gli elementi seguenti:

  • Pipeline di versione che contiene almeno una fase. Se non è già disponibile, è possibile crearlo seguendo una delle guide introduttive e le esercitazioni seguenti:

  • Due destinazioni separate in cui si distribuirà l'app. Possono trattarsi di macchine virtuali, server Web, gruppi di distribuzione fisici locali o altri tipi di destinazione della distribuzione. In questo esempio vengono usati app Azure istanze del sito Web del servizio. Se si decide di eseguire la stessa operazione, sarà necessario scegliere 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.

  1. In Azure Pipelines aprire la scheda Versioni . Selezionare la pipeline di versione selezionare Modifica.

    modificare la pipelin della versione

  2. Selezionare l'icona trigger distribuzione continua nella sezione Artefatti per aprire il pannello del trigger. Assicurarsi che questa opzione sia abilitata in modo che venga creata una nuova versione dopo il completamento di ogni nuova compilazione completata.

    trigger di distribuzione continua

  3. 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 il rilascio. Ciò significa che una distribuzione verrà avviata automaticamente quando viene creata una nuova versione da questa pipeline di versione.

    condizioni di pre-distribuzione

    È anche possibile configurare trigger di rilascio, trigger di fase o pianificare distribuzioni.

Aggiungere fasi

In questa sezione verranno aggiunte due nuove fasi alla pipeline di versione: 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 staging e quindi in un server live o di produzione. Ogni fase rappresenta una destinazione di distribuzione.

  1. Selezionare la scheda Pipeline nella pipeline di versione e selezionare la fase esistente. Modificare il nome della fase in Produzione.

    Scelta di una fase esistente dalla scheda Pipeline e modifica del nome in Produzione nel pannello Fase

  2. Selezionare l'elenco a discesa + Aggiungi e scegliere Clona fase (l'opzione clone è disponibile solo quando è selezionata una fase esistente).

    Selezione della fase clonazione

    In genere, si vogliono 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 comportino 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.

  3. La fase clonata avrà il nome Copia di produzione. Selezionarlo e modificare il nome in QA.

    modifica del nome della fase in QA

  4. Per riorganizzare le fasi nella pipeline, selezionare l'icona Condizioni di pre-distribuzione nella fase di controllo di qualità e impostare il trigger su Dopo il rilascio. Il diagramma della pipeline mostrerà quindi le due fasi in parallelo.

    riorganizzazione delle fasi

  5. 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.

    Selezione di trigger e fasi di controllo di qualità

    Nota

    È possibile configurare la distribuzione per l'avvio quando una distribuzione nella fase precedente ha esito positivo parzialmente . Ciò significa che la distribuzione continuerà anche se un'attività specifica non critica non è riuscita. Questa operazione viene in genere usata in distribuzioni di fork e join che vengono distribuite in diverse fasi in parallelo.

  6. Selezionare l'elenco a discesa Attività e selezionare la fase qa .

    Elenco a discesa Attività e selezione della fase qa

  7. 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à Deploy app Azure Service come illustrato di seguito.

    Uso dell'attività Distribuisci servizio app di Azure

Aggiungere approvazioni di pre-distribuzione

La pipeline di versione modificata in precedenza viene distribuita in qa e produzione. Se la distribuzione al controllo di qualità ha esito negativo, la distribuzione nell'ambiente di produzione non verrà attivata. È consigliabile verificare sempre se l'app funziona correttamente nella fase di controllo di qualità o test prima della distribuzione nell'ambiente di 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:

  1. Selezionare la scheda Pipeline , l'icona Condizioni di pre-distribuzione e i responsabili approvazione pre-distribuzione.

    Pannello responsabili approvazione pre-distribuzione

  2. Nella casella di testo Responsabili approvazione 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 approvarlo .

    Aggiunta di responsabili approvazione pre-distribuzione

    È possibile aggiungere tutti i responsabili approvazione necessari, sia singoli utenti che gruppi di organizzazioni. È anche possibile configurare le approvazioni post-distribuzione selezionando l'icona "utente" sul lato destro della fase nel diagramma della pipeline. Per altre informazioni, vedere Rilascia controlli e approvazioni.

  3. Seleziona Salva.

    Salvataggio della pipeline di versione

Creare una versione

Ora che l'installazione della pipeline di versione è stata completata, è possibile 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.

  1. Selezionare l'elenco a discesa Versione e scegliere Crea versione.

    creare una nuova versione

  2. Immettere una descrizione per la versione, verificare che siano selezionati gli artefatti corretti e quindi selezionare Crea.

    Creare un nuovo pannello di rilascio

  3. Verrà visualizzato un banner che indica che è stata creata una nuova versione. Selezionare il collegamento versione per visualizzare altri dettagli.

    versione creata correttamente

  4. La pagina di riepilogo della versione mostrerà lo stato della distribuzione in ogni fase.

    Stato della distribuzione

    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é l'avanzamento complessivo di tutte le versioni.

    Visualizzazione elenco delle versioni

  5. Selezionare l'icona pending_approval per aprire il pannello della finestra di approvazione. Immettere un breve commento e selezionare Approva.

    approvazione della distribuzione

Nota

È possibile pianificare la distribuzione in un secondo momento, 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:

  1. Nel riepilogo della versione passare il puntatore del mouse su una fase e selezionare Log.

    log di distribuzione

    Durante la distribuzione, è comunque possibile accedere alla pagina dei log per visualizzare i log in tempo reale di ogni attività.

  2. Selezionare un'attività per visualizzare i log per l'attività specifica. In questo modo è più semplice tracciare ed eseguire il debug dei problemi di distribuzione. È anche possibile scaricare singoli log attività o un file ZIP di tutti i file di log.

    download dei log

  3. Se sono necessarie informazioni aggiuntive per eseguire il debug della distribuzione, è possibile eseguire la versione in modalità di debug.

Passaggio successivo