Esercizio - Creare ed eseguire una pipeline semplice
Importante
Per eseguire questo esercizio è necessario disporre di una propria sottoscrizione di Azure e questo potrebbe comportare dei costi. Se non hai ancora una sottoscrizione di Azure, crea un account gratuito prima di iniziare.
Si vuole automatizzare la distribuzione degli aggiornamenti nel sito Web dell'azienda. Come primo passaggio, si crea una pipeline semplice in Azure DevOps.
In questo esercizio si vedrà come:
- Creare un'organizzazione e un progetto di Azure DevOps.
- Creare una pipeline semplice.
- Eseguire la pipeline semplice.
Creare un progetto in Azure DevOps
In un browser passare a dev.azure.com. Accedere o creare un nuovo account.
Se è stato creato un nuovo account, seguire le istruzioni per creare un'organizzazione di Azure DevOps. Azure DevOps chiede quindi di creare un nuovo progetto. Continuare con il passaggio successivo per configurare il progetto.
Se è stato eseguito l'accesso a un'organizzazione di Azure DevOps esistente, selezionare Nuovo progetto per creare un nuovo progetto.
Nel riquadro Crea un progetto per iniziare immettere i dettagli seguenti per il nuovo progetto:
- Nome progetto: usare un nome significativo ma breve. Per questo esercizio immettere toy-website.
- Descrizione: immettere una descrizione dello scopo del progetto. Per questo esercizio immettere Toy company website.
- Visibilità: è possibile usare Azure DevOps per creare repository pubblici e privati. In questo caso, il repository deve essere privato perché i file del sito Web aziendale devono essere accessibili solo a persone all'interno dell'organizzazione. Sarà possibile concedere l'accesso ad altri utenti in un secondo momento.
La configurazione del progetto dovrebbe essere simile a questo esempio:
Seleziona Crea progetto.
Clonare il repository
Nel riquadro iniziale o nel menu delle risorse selezionare Repos.
Se si usa macOS, è necessaria una password speciale per clonare il repository Git. Selezionare Generate Git credentials (Genera credenziali Git) e copiare il nome utente e la password visualizzati in una posizione sicura.
In Clona nel computer selezionare Clona in VS Code. Se viene richiesto di consentire l'apertura di Visual Studio Code, selezionare Apri.
Se viene visualizzata una finestra di dialogo che richiede di consentire a un'estensione di aprire l'URI del repository, selezionare Apri.
Creare una cartella nel dispositivo locale da usare per questo repository e quindi selezionare Seleziona come percorso del repository.
Se si usa questo repository per la prima volta, viene chiesto di accedere.
Per Windows immettere le stesse credenziali usate per accedere ad Azure DevOps in questo esercizio.
Per macOS immettere il nome utente e la password Git generati qualche istante fa.
Visual Studio Code richiede di aprire il repository. Selezionare Apri.
Installare l'estensione di Azure Pipelines
Microsoft pubblica un'estensione di Azure Pipelines per Visual Studio Code. L'estensione consente di scrivere i file YAML delle pipeline. È consigliabile installare questa estensione, in modo che i file YAML vengano convalidati durante il lavoro.
In Visual Studio Code selezionare Visualizza>Estensioni (il tasto di scelta rapida è CTRL+MAIUSC+X).
Nella casella Cerca immettere Azure Pipelines e quindi selezionare l'estensione Azure Pipelines pubblicata da Microsoft. Selezionare Installa.
Creare una definizione di pipeline YAML
Dopo aver creato l'organizzazione, il progetto e il repository, si è pronti per creare una definizione di pipeline semplice.
In Visual Studio Code aprire Esplora risorse.
In Explorer passare il puntatore del mouse sulla cartella del progetto TOY-WEBSITE e selezionare l'icona Nuova cartella. Assegnare alla cartella il nome deploy.
Selezionare la cartella deploy e nel progetto TOY-WEBSITE selezionare l'icona Nuovo file. Assegnare al file il nome azure-pipelines.yml.
Il file YML è aperto nel pannello principale. Incollare il codice della definizione di pipeline seguente nel file:
trigger: none pool: vmImage: ubuntu-latest jobs: - job: steps: - script: echo Hello world! displayName: 'Placeholder step'Salvare le modifiche apportate al file.
Aprire una finestra del terminale di Visual Studio Code selezionando Terminale>Nuovo terminale.
Una finestra del terminale si apre solitamente nella parte inferiore della schermata.
Per eseguire il commit e il push del file azure-pipelines.yml nel repository Git, incollare questo codice nel pannello terminale e quindi premere INVIO.
git add deploy/azure-pipelines.yml git commit -m "Add initial pipeline definition" git push
Configurare la pipeline in Azure Pipelines
La definizione della pipeline è stata creata. Ora registrare la pipeline con Azure Pipelines.
Nel menu delle risorse della sessione di Azure DevOps selezionare Pipelines e nel riquadro, Crea la prima pipeline, selezionare Crea pipeline.
Nel riquadro Dov'è il codice? della scheda Connetti selezionare Azure Repos Git.
Nel riquadro Seleziona un repository della scheda Seleziona selezionare toy-website.
Nel riquadro Configura la pipeline della scheda Configura selezionare File YAML di Azure Pipelines esistente.
Nel riquadro Seleziona un file YAML esistente, della scheda nell'elenco a discesa Percorso, selezionare /deploy/azure-pipelines.yml e quindi Continua.
Il riquadro Esamina il codice YAML della pipelinedella scheda Revisione mostra la definizione della pipeline YAML come nuova pipeline.
Suggerimento
L'interfaccia Web di Azure Pipelines include un editor che è possibile usare per gestire la definizione della pipeline. In questo modulo si lavora con il file di definizione in Visual Studio Code, ma è possibile esplorare l'editor di Azure Pipelines per vedere come funziona.
Selezionare Esegui.
Azure Pipelines crea la pipeline e avvia una prima esecuzione.
Verificare l'esecuzione della pipeline
Importante
Se è la prima volta che si usano le pipeline in questa organizzazione di Azure DevOps, potrebbe essere visualizzato un errore che indica:
Non è stato acquistato o concesso alcun parallelismo ospitato.
Per proteggersi da un uso improprio, Azure DevOps richiede che le nuove organizzazioni vengano approvate prima di poter usare gli agenti della pipeline ospitata da Microsoft senza alcun addebito.
All'avvio dell'esecuzione della pipeline, una pagina visualizza le informazioni sull'esecuzione.
Ogni esecuzione della pipeline include un identificatore. È possibile usare questo identificatore per trovare un'esecuzione della pipeline specifica.
Inizialmente lo stato del processo viene visualizzato come In coda. È possibile che la pipeline non venga avviata immediatamente. Il processo viene aggiunto a una coda per un agente. Quando è disponibile un agente, Azure Pipelines assegna l'agente e avvia il processo. Lo stato del processo diventa quindi In esecuzione.
La pagina include il nome del ramo e l'identificatore per il commit Git usato dall'esecuzione. Queste informazioni indicano la versione del contenuto del repository usata dalla pipeline.
Aggiornare la pagina fino a quando lo stato del processo non cambia in Operazione completata. In Processi selezionare quindi Processo.
La pagina delle informazioni sul processo mostra il log dei passaggi eseguiti dalla pipeline. Il passaggio Segnaposto è elencato nei passaggi del menu a sinistra.
L'elenco di passaggi del processo include quelli che non sono stati creati dall'utente. Questi passaggi vengono creati automaticamente da Azure Pipelines. In alcune organizzazioni potrebbero essere visualizzati anche i passaggi che l'organizzazione include automaticamente in tutte le pipeline. È possibile selezionare qualsiasi passaggio per visualizzare il file di log di tale passaggio.
Selezionare il passaggio Esegui checkout di website@main in s.
Il log di ogni passaggio fornisce informazioni dettagliate su ciò che è esattamente successo durante l'esecuzione della pipeline. Le informazioni dei log sono utili se è necessario diagnosticare un problema relativo a una pipeline. Non si ha accesso diretto all'agente che ha eseguito i passaggi.
In questo caso, il contenuto del repository è stato scaricato da Azure Repos nel file system dell'agente.
Selezionare Placeholder step (Passaggio segnaposto).
Il log per questo passaggio include il contenuto dello script così come è stato creato nel file YAML della pipeline e il testo di output
Hello world!ottenuto eseguendo lo script.
Collegare l'esecuzione della pipeline a un commit
È bene comprendere come creare un riferimento incrociato tra un'esecuzione della pipeline e il commit contenuto nell'esecuzione. Il collegamento di un'esecuzione della pipeline a un commit consente di tracciare la cronologia delle distribuzioni e di diagnosticare i problemi. Azure DevOps offre diversi modi per collegare un'esecuzione della pipeline a un commit. In questa procedura, si vedrà come esaminare manualmente la cronologia dei commit.
Per tornare alla panoramica del repository, nel menu della risorsa DevOps selezionare Repos>Commit.
L'identificatore del commit è lo stesso di cui si è preso nota per l'esecuzione della pipeline. Azure Pipelines visualizza anche lo stato dell'esecuzione della pipeline associata al commit.
Selezionare il commit. L'elenco dei file modificati e delle modifiche apportate dal commit è evidenziato in verde, che indica che tutto il testo è nuovo.