Esercitazione: Distribuire ambienti in CI/CD usando Azure Pipelines
Questa esercitazione descrive come integrare Gli ambienti di distribuzione di Azure (ADE) nella pipeline CI/CD di Azure Pipelines.
L'integrazione continua e il recapito continuo (CI/CD) è un approccio di sviluppo software che consente ai team di automatizzare il processo di compilazione, test e distribuzione delle modifiche software. CI/CD consente di rilasciare le modifiche software più frequentemente e con maggiore attendibilità.
Prima di iniziare questa esercitazione, acquisire familiarità con le risorse e i concetti degli ambienti di distribuzione esaminando i concetti chiave per gli ambienti di distribuzione di Azure.
In questa esercitazione apprenderai a:
- Creare e configurare un repository Azure Repos
- Connessione il catalogo al dev center
- Configurare la connessione al servizio
- Creare una pipeline
- Crea un ambiente
- Testare la pipeline CI/CD
Prerequisiti
- Un account Azure con una sottoscrizione attiva.
- Autorizzazioni di proprietario nella sottoscrizione di Azure.
- Una sottoscrizione di Azure DevOps.
- Creare un account gratuitamente.
- Un'organizzazione e un progetto di Azure DevOps.
- Ambienti di distribuzione di Azure.
- Dev Center e progetto.
- Catalogo di esempio collegato al dev center.
Creare e configurare un repository Azure Repos
- Accedere all'organizzazione di Azure DevOps (
https://dev.azure.com/<your-organization>
) e selezionare il progetto. Sostituire il segnaposto di testo con l'identificatore<your-organization>
del progetto. - Selezionare Repos>File.
- In Importa un repository selezionare Importa.
- In Importare un repository Git selezionare o immettere quanto segue:
- Tipo di repository: Git
- CLONE URL (URL clone): https://github.com/Azure/deployment-environments
Configurare i tipi di ambiente
I tipi di ambiente definiscono i diversi tipi di ambienti che i team di sviluppo possono distribuire. È possibile applicare impostazioni diverse per ogni tipo di ambiente. È possibile creare tipi di ambiente a livello di dev center e fare riferimento a livello di progetto.
Creare tipi di ambiente dev center:
Accedere al portale di Azure.
In Dev Center selezionare il dev center.
Nel menu a sinistra in Configurazione ambiente selezionare Tipi di ambiente e quindi selezionare Crea.
Seguire questa procedura per creare tre tipi di ambiente: Sandbox, FunctionApp, WebApp. In Crea tipo di ambiente immettere le informazioni seguenti e quindi selezionare Aggiungi.
Nome valore Nome Immettere un nome per il tipo di ambiente. Tag Immettere un nome di tag e un valore di tag. Verificare che il tipo di ambiente sia stato aggiunto controllando le notifiche di portale di Azure.
Creare tipi di ambiente di progetto:
Nel menu a sinistra in Gestisci selezionare Progetti e quindi selezionare il progetto da usare.
Nel menu a sinistra in Configurazione dell'ambiente selezionare Tipi di ambiente e quindi selezionare Aggiungi.
Usare la procedura seguente per aggiungere i tre tipi di ambiente: Sandbox, FunctionApp, WebApp. In Aggiungi tipo di ambiente al <nome> del progetto immettere o selezionare le informazioni seguenti:
Nome valore Type Selezionare un tipo di ambiente a livello di dev center da abilitare per il progetto specifico. Sottoscrizione di distribuzione Selezionare la sottoscrizione in cui viene creato l'ambiente. Identità della distribuzione Selezionare un'identità assegnata dal sistema o un'identità gestita assegnata dall'utente per eseguire distribuzioni per conto dell'utente. Autorizzazioni per i ruoli autore dell'ambiente Risorse dell'ambiente> Selezionare i ruoli per concedere l'accesso alle risorse dell'ambiente. Autorizzazioni per le risorse>dell'ambiente Accesso aggiuntivo Selezionare gli utenti o i gruppi di Microsoft Entra da assegnare a ruoli specifici nelle risorse dell'ambiente. Tag Immettere un nome di tag e un valore di tag. Questi tag vengono applicati a tutte le risorse create come parte dell'ambiente. Verificare che il tipo di ambiente sia stato aggiunto controllando le notifiche di portale di Azure.
Configurare una connessione al servizio
In Azure Pipelines si crea una connessione al servizio nel progetto Azure DevOps per accedere alle risorse nella sottoscrizione di Azure. Quando si crea la connessione al servizio, Azure DevOps crea un oggetto entità servizio Microsoft Entra.
Accedere all'organizzazione di Azure DevOps (
https://dev.azure.com/<your-organization>
) e selezionare il progetto. Sostituire il segnaposto di testo con l'identificatore<your-organization>
del progetto.Selezionare Impostazioni progetto>Connessioni> servizio+ Nuova connessione al servizio.
Nel riquadro Nuova connessione al servizio selezionare Azure Resource Manager e quindi selezionare Avanti.
Selezionare il metodo di autenticazione dell'entità servizio (automatico) e quindi selezionare Avanti.
Immettere i dettagli della connessione al servizio e quindi selezionare Salva per creare la connessione al servizio.
Campo Valore Livello di ambito Sottoscrizione. Abbonamento Selezionare la sottoscrizione di Azure che ospita la risorsa di Dev Center. Gruppo di risorse Selezionare il gruppo di risorse che contiene la risorsa di Dev Center. Nome connessione del servizio Immettere un nome univoco per la connessione al servizio. Concedere l'autorizzazione di accesso a tutte le pipeline Selezionato. Nell'elenco delle connessioni al servizio selezionare quella creata in precedenza e quindi selezionare Gestisci entità servizio. Il portale di Azure viene aperto in una scheda separata del browser e mostra i dettagli dell'entità servizio.
Nella portale di Azure copiare il valore Nome visualizzato. Questo valore viene usato nel passaggio successivo per concedere le autorizzazioni per l'esecuzione di test di carico all'entità servizio.
Concedere l'accesso alla connessione al servizio al progetto ADE
Gli ambienti di distribuzione di Azure usano il controllo degli accessi in base al ruolo per concedere autorizzazioni per l'esecuzione di attività specifiche nella risorsa DIE. Per apportare modifiche da una pipeline CI/CD, si concede il ruolo utente Ambienti di distribuzione all'entità servizio.
- Nel portale di Azure passare al progetto ADE.
- Selezionare Controllo di accesso (IAM)>Aggiungi>assegnazione di ruolo.
- Nella scheda Ruolo selezionare Ambiente di distribuzione Utente nell'elenco dei ruoli della funzione di processo.
- Nella scheda Membri selezionare Seleziona membri e quindi usare il nome visualizzato copiato in precedenza per cercare l'entità servizio.
- Selezionare l'entità servizio e quindi selezionare Seleziona.
- Nella scheda Rivedi e assegna selezionare Rivedi e assegna per aggiungere l'assegnazione di ruolo.
È ora possibile usare la connessione al servizio nella definizione del flusso di lavoro di Azure Pipelines per accedere agli ambienti ADE.
Concedere all'account l'accesso al progetto DIE
Per visualizzare gli ambienti creati da altri utenti, inclusa la connessione al servizio, è necessario concedere all'account l'accesso in lettura al progetto DIE.
- Nel portale di Azure passare al progetto ADE.
- Selezionare Controllo di accesso (IAM)>Aggiungi>assegnazione di ruolo.
- Nella scheda Ruolo selezionare Lettore ambienti di distribuzione nell'elenco dei ruoli della funzione di processo.
- Nella scheda Membri selezionare Seleziona membri e quindi cercare il proprio account.
- Selezionare l'account dall'elenco e quindi selezionare Seleziona.
- Nella scheda Rivedi e assegna selezionare Rivedi e assegna per aggiungere l'assegnazione di ruolo.
È ora possibile visualizzare gli ambienti creati dal flusso di lavoro di Azure Pipelines.
Configurare una pipeline
Modificare il azure-pipelines.yml
file nel repository Azure Repos per personalizzare la pipeline.
Nella pipeline si definiscono i passaggi per creare l'ambiente. In questa pipeline si definiscono i passaggi per creare l'ambiente come processo, ovvero una serie di passaggi eseguiti in sequenza come unità.
Per personalizzare la pipeline:
- Specificare l'Connessione del servizio da usare e la pipeline usa l'interfaccia della riga di comando di Azure per creare l'ambiente.
- Usare uno script inline per eseguire un comando dell'interfaccia della riga di comando di Azure che crea l'ambiente.
L'interfaccia della riga di comando di Azure è uno strumento da riga di comando che fornisce un set di comandi per l'uso delle risorse di Azure. Per altre informazioni sui comandi dell'interfaccia della riga di comando di Azure, vedere az devcenter.
Nel progetto Azure DevOps selezionare Repos>Files (File repository).
Nel riquadro File selezionare
azure-pipelines.yml
file dalla.ado
cartella .azure-pipelines.yml
Nel file modificare il contenuto esistente con il codice seguente:Sostituire
<AzureServiceConnectionName>
con il nome della connessione al servizio creata in precedenza.In sostituire ognuno dei segnaposto seguenti con i valori appropriati per l'ambiente
Inline script
Azure:Segnaposto Valore <dev-center-name>
Nome del dev center. <project-name>
Nome del progetto. <catalog-name>
Nome del catalogo. <environment-definition-name>
Non modificare. Definisce la definizione dell'ambiente utilizzata. <environment-type>
Tipo di ambiente. <environment-name>
Specificare un nome per il nuovo ambiente. <parameters>
Non modificare. Fa riferimento al file JSON che definisce i parametri per l'ambiente.
Seleziona Esegui commit per salvare le modifiche.
Nel riquadro Commit changes (Commit changes) immettere un messaggio di commit e quindi selezionare Commit (Commit).
Creare un ambiente usando una pipeline
Eseguire quindi la pipeline per creare l'ambiente ADE.
- Nel progetto Azure DevOps selezionare Pipeline.
- Selezionare la pipeline creata in precedenza e quindi selezionare Esegui pipeline.
- È possibile controllare lo stato di avanzamento dell'esecuzione della pipeline selezionando il nome della pipeline e quindi selezionando Esecuzioni. Selezionare l'esecuzione per visualizzare i dettagli dell'esecuzione della pipeline.
- È anche possibile controllare lo stato di avanzamento della creazione dell'ambiente nel portale di Azure selezionando il dev center, selezionando il progetto e quindi selezionando Ambienti.
È possibile inserire questo processo in un punto qualsiasi in una pipeline di integrazione continua e/o recapito continuo (CD). Introduzione alla documentazione di Azure Pipelines per altre informazioni sulla creazione e la gestione delle pipeline.
Pulire le risorse
Al termine delle risorse create in questa esercitazione, è possibile eliminarle per evitare addebiti.
Usare il comando seguente per eliminare l'ambiente creato in questa esercitazione:
az devcenter dev environment delete --dev-center <DevCenterName> --project-name <DevCenterProjectName> --name <DeploymentEnvironmentInstanceToCreateName> --yes