Esercizio - Configurare l'ambiente
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.
Prima di iniziare a lavorare alla pipeline del sito Web dell'azienda di giocattoli, è necessario configurare l'ambiente. In questa unità ci si assicurerà che gli ambienti Azure e Azure DevOps siano configurati per completare il resto di questo modulo.
Per soddisfare questi obiettivi, è necessario:
- Configurare un progetto Azure DevOps per questo modulo.
- Clonare il repository del progetto nel computer.
- Creare due gruppi di risorse in Azure.
- Creare due connessioni al servizio e ambienti in Azure Pipelines.
- Rimuovere le risorse non necessarie nel progetto di Azure DevOps creato in precedenza.
Ottenere il progetto Azure DevOps
Assicurarsi che l'organizzazione Azure DevOps sia configurata per completare il resto di questo modulo. Per la configurazione, eseguire un modello per la creazione di un progetto in Azure DevOps.
I moduli di questo percorso di apprendimento sono da seguire in successione. Ai fini dell'apprendimento, a ogni modulo è associato un progetto Azure DevOps.
Suggerimento
Anche se il modulo precedente è stato completato nel percorso di apprendimento, seguire queste istruzioni per creare un nuovo progetto. Assicurarsi di assegnargli un nuovo nome.
Eseguire il modello
Eseguire un modello che configura il progetto Azure DevOps.
Nel sito Demo Generator di Azure DevOps seguire questa procedura:
Selezionare Accedi e accettare le condizioni d’uso.
Nella pagina Crea nuovo progetto selezionare l'organizzazione Azure DevOps. Immettere quindi un nome del progetto, ad esempio toy-website-environments.
Selezionare Crea progetto.
L'esecuzione del modello richiede qualche secondo. Crea automaticamente una pipeline e un file Bicep da usare negli esercizi successivi.
Selezionare Passa al progetto per passare al progetto in Azure DevOps.
Importante
L'esercizio finale in questo modulo contiene importanti passaggi di pulizia. Assicurarsi di eseguire la procedura di pulizia anche se non si completa questo modulo.
Clonare il repository
Selezionare Repos>File.
Selezionare Clona.
Se si usa macOS, è necessaria una password speciale per clonare il repository Git. Selezionare Genera credenziali Git e copiare il nome utente e la password visualizzati in una posizione sicura.
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 da usare per il repository e quindi scegliere Seleziona il Percorso del Repository.
Poiché si usa questo repository per la prima volta, viene chiesto di accedere.
Se si usa Windows, immettere le stesse credenziali usate per accedere ad Azure DevOps in questo esercizio.
Se si usa macOS, immettere il nome utente e la password Git generati qualche istante fa.
Visual Studio Code richiede di aprire il repository. Selezionare Apri.
Accedere ad Azure
Per usare i gruppi di risorse in Azure, accedere all'account Azure dal terminale di Visual Studio Code. Assicurarsi di avere installato gli strumenti dell'interfaccia della riga di comando di Azure.
Nel menu Terminale selezionare Nuovo terminale. La finestra del terminale si apre solitamente nella parte inferiore della schermata.
Se la shell visualizzata sul lato destro della finestra del terminale è bash, significa che è aperta la shell corretta ed è possibile passare alla sezione successiva.
Se viene visualizzata una shell diversa da bash, selezionare l'elenco a discesa delle shell e quindi selezionare Git Bash (predefinita).
Nell'elenco delle shell del terminale selezionare bash e quindi selezionare il segno più per aprire un nuovo terminale che usa la shell bash.
Accedere ad Azure tramite l'interfaccia della riga di comando di Azure
Nel terminale di Visual Studio Code eseguire il comando seguente per accedere ad Azure:
az login
Nel browser visualizzato accedere al proprio account Azure.
Per usare i gruppi di risorse in Azure, accedere all'account Azure dal terminale di Visual Studio Code. Assicurarsi di aver installato Azure PowerShell.
Nel menu Terminale selezionare Nuovo terminale. La finestra del terminale si apre solitamente nella parte inferiore della schermata.
Se la shell visualizzata sul lato destro della finestra del terminale è powershell o pwsh, significa che è aperta la shell corretta ed è possibile passare alla sezione successiva.
Se viene visualizzata una shell diversa da powershell o pwsh, selezionare l'elenco a discesa delle shell e quindi selezionare PowerShell.
Nell'elenco delle shell del terminale selezionare powershell o pwsh e quindi selezionare il segno più per aprire un nuovo terminale che usa la shell powershell o pwsh.
Accedere ad Azure usando Azure PowerShell
Nel terminale di Visual Studio Code eseguire il comando seguente per accedere ad Azure:
Connect-AzAccount
Nel browser visualizzato accedere al proprio account Azure.
Creare due gruppi di risorse in Azure
Per creare i due nuovi gruppi di risorse dell'ambiente di test, eseguire i comandi dell'interfaccia della riga di comando di Azure seguenti nel terminale Visual Studio Code:
az group create --name ToyWebsiteTest --location westus3
az group create --name ToyWebsiteProduction --location westus3
Per creare i due nuovi gruppi di risorse dell'ambiente di test, eseguire i comandi di Azure PowerShell seguenti nel terminale Visual Studio Code:
New-AzResourceGroup -Name ToyWebsiteTest -Location westus3
New-AzResourceGroup -Name ToyWebsiteProduction -Location westus3
Creare connessioni al servizio in Azure Pipelines
Creare quindi due connessioni al servizio in Azure Pipelines: una per l'ambiente di test e un'altra per l'ambiente di produzione. Questo processo crea automaticamente un'entità servizio in Azure. Concede anche all'entità servizio il ruolo Collaboratore nel gruppo di risorse, che consente la distribuzione della pipeline nel gruppo di risorse.
Nel browser selezionare Project Settings (Impostazioni progetto).
Selezionare Connessioni al servizio>Crea connessione al servizio.
Selezionare Azure Resource Manager>Avanti.
Selezionare Entità servizio (automatico)>Avanti.
Nell'elenco a discesa Sottoscrizione selezionare la sottoscrizione di Azure.
Potrebbe essere visualizzata una finestra popup che richiede di accedere ad Azure. In questo caso, immettere le credenziali e accedere.
Nell'elenco a discesa Gruppo di risorse selezionare ToyWebsiteTest.
In Nome della connessione al servizio immettere ToyWebsiteTest. Assicurarsi che sia selezionata la casella di controllo Concedi l'autorizzazione di accesso a tutte le pipeline e selezionare Salva.
Suggerimento
Per semplicità, si concede a ogni pipeline l'accesso alla connessione al servizio. Quando si creano connessioni al servizio reali che funzionano con le risorse di produzione, è consigliabile limitare l'accesso solo alle pipeline che ne hanno bisogno.
Ripetere il processo precedente per creare un'altra nuova connessione al servizio denominata ToyWebsiteProduction, che viene distribuita nel gruppo di risorse denominato ToyWebsiteProduction.
Se l'elenco dei gruppi di risorse non viene aggiornato, aggiornare la pagina nel browser e riprovare.
Creare ambienti in Azure Pipelines
Nel browser passare a Pipeline>Ambienti.
Selezionare Nuovo ambiente.
Immettere Test come nome dell'ambiente.
Lasciare vuota la descrizione. Per Risorsa selezionare Nessuna. Selezionare Crea.
Nota
In Azure Pipelines gli ambienti vengono usati per abilitare le funzionalità di distribuzione. Alcune di queste funzionalità si applicano solo quando si esegue la distribuzione in Kubernetes o nelle macchine virtuali. In questo modulo tali funzionalità non vengono usate ed è possibile ignorarle.
Prima che una pipeline possa usare l'ambiente, è necessario concederle l'autorizzazione. Per semplicità, si consentirà a tutte le pipeline di accedere all'ambiente. Nelle pipeline reali è consigliabile limitare l'accesso agli ambienti solo alle pipeline che lo richiedono.
Selezionare il pulsante con tre puntini, quindi selezionare Sicurezza.
Nella sezione denominata Autorizzazioni pipeline, se è presente un pulsante denominato Limita autorizzazione, selezionarlo.
Selezionare il pulsante con i puntini di sospensione. Selezionare Apri accesso.
Selezionare la freccia sinistra due volte per tornare all'elenco degli ambienti.
Ripetere il processo per creare un altro ambiente denominato Production. Ricordarsi di impostarlo per aprire l'accesso.
Lasciare aperta la pagina dell'ambiente di produzione.
Aggiungere un controllo di approvazione all'ambiente di produzione
Nella parte superiore destra della pagina selezionare il pulsante con tre punti e quindi selezionare Approvazioni e controlli dal menu a comparsa.
Selezionare Approvazioni.
Nella casella di testo Responsabili approvazione digitare il proprio nome e selezionare se stessi.
Selezionare il pulsante freccia accanto ad Avanzate.
Si noti che, per impostazione predefinita, i responsabili approvazione possono approvare le esecuzioni attivate. Poiché si è l'unico utente che userà questa pipeline, lasciare selezionata questa casella di controllo. In altre organizzazioni potrebbe essere necessario specificare un responsabile approvazione diverso per soddisfare i requisiti di conformità.
Seleziona Crea.
Eliminare l'ambiente precedente
Nelle versioni precedenti della pipeline è stato usato un singolo ambiente denominato Sito Web. Dopo aver creato ambienti della pipeline che rappresentano i nuovi ambienti, è possibile eliminare l'ambiente della pipeline precedente.
Passare a Pipeline>Ambienti.
Selezionare l'ambiente Sito Web.
Nella parte superiore destra della pagina selezionare il pulsante con tre punti e quindi selezionare Elimina dal menu a comparsa.
Per confermare l'eliminazione seleziona Elimina.
Eliminare le variabili precedenti
Nelle versioni precedenti della pipeline è stato usato un singolo set di variabili per definire i parametri e la configurazione della distribuzione. Ora che esegue la distribuzione in più ambienti, è possibile eliminare tali variabili e sostituirle con set di variabili specifici dell'ambiente.
Passare a Pipeline>Pipeline.
Selezionare la pipeline toy-website-environments.
Seleziona il pulsante Modifica.
Selezionare il pulsante Variabili.
Selezionare il pulsante Elimina variabile per ognuna delle tre variabili.
Seleziona Salva.