Guida introduttiva: Integrare Bicep con Azure Pipelines

Questa guida introduttiva illustra come integrare i file Bicep con Azure Pipelines per l'integrazione continua e la distribuzione continua.

Offre una breve introduzione all'attività della pipeline necessaria per la distribuzione di un file Bicep. Per istruzioni più dettagliate sulla configurazione della pipeline e del progetto, vedere il modulo Distribuire le risorse di Azure usando Bicep e Azure Pipelines Microsoft Learn.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

È necessaria anche un'organizzazione di Azure DevOps. Se non è disponibile, crearne uno gratuitamente. Se il team ha già un'organizzazione di Azure DevOps, assicurarsi di essere un amministratore del progetto Azure DevOps che si vuole usare.

È necessario aver configurato una connessione al servizio alla sottoscrizione di Azure. Le attività nella pipeline vengono eseguite con l'identità dell'entità servizio. Per la procedura per creare la connessione, vedere Creare un progetto DevOps.

È necessario un file Bicep che definisce l'infrastruttura per il progetto. Questo file si trova in un repository.

È necessario un file ".bicepparam" che definisce i parametri usati dal file Bicep. Questo file si trova in un repository.

Creare una pipeline

1. Nell'organizzazione di Azure DevOps selezionare Pipeline e Crea pipeline.

   

2. Specificare dove è archiviato il codice. Questo quickstart usa i repository Git di Azure Repos.

   

3. Selezionare il repository con il codice per il progetto.

   

4. Selezionare Starter pipeline (Pipeline iniziale ) per il tipo di pipeline da creare.

   

Distribuire file Bicep

È possibile usare un'attività di distribuzione di un gruppo di risorse Azure o un'attività Azure CLI per distribuire un file Bicep.

Usare l'attività Distribuzione modelli di Azure Resource Manager

1. Sostituire la pipeline iniziale con il codice YAML seguente. Utilizza l'attività di distribuzione del modello di Azure Resource Manager per creare un gruppo di risorse e distribuire un file Bicep e .bicepparam.

   trigger:
   - main
   
   name: Deploy Bicep files
   
   parameters:
   - name: azureServiceConnection
     type: string
     default: '<your-connection-name>'
   
   variables:
     vmImageName: 'ubuntu-latest'
     resourceGroupName: 'exampleRG'
     ___location: '<your-resource-group-___location>'
     templateFile: './main.bicep'
     csmParametersFile: './main.bicepparam'
   
   pool:
     vmImage: $(vmImageName)
   
   steps:
   - task: AzureResourceManagerTemplateDeployment@3
     inputs:
       deploymentScope: 'Resource Group'
       action: 'Create Or Update Resource Group'
       resourceGroupName: '$(resourceGroupName)'
       ___location: '$(___location)'
       templateLocation: 'Linked artifact'
       csmFile: '$(templateFile)'
       csmParametersFile: '$(csmParametersFile)'
       overrideParameters: '-storageAccountType Standard_LRS'
       deploymentMode: 'Incremental'
       deploymentName: 'DeployPipelineTemplate'
       connectedServiceName: '${{ parameters.azureServiceConnection }}'
   

2. Aggiornare i valori di azureServiceConnection e ___location.

3. Verificare di avere un file valido main.bicep nel repository.

4. Verificare di avere un file valido main.bicepparam nel repository che contiene un'istruzione using .

5. Seleziona Salva. La pipeline di compilazione viene eseguita automaticamente. Torna al riepilogo della pipeline di compilazione e monitora lo stato.

Usare l'attività CLI di Azure

1. Sostituire la pipeline iniziale con il codice YAML seguente. Crea un gruppo di risorse e distribuisce un .bicepparam file usando un'attività dell'interfaccia della riga di comando di Azure:

   trigger:
   - main
   
   name: Deploy Bicep files
   
   parameters:
     azureServiceConnection: '<your-connection-name>'
   
   variables:
     vmImageName: 'ubuntu-latest'
     resourceGroupName: 'exampleRG'
     ___location: '<your-resource-group-___location>'
     bicepParamFile: './main.bicepparam'
   
   pool:
     vmImage: $(vmImageName)
   
   steps:
   - task: AzureCLI@2
     inputs:
       azureSubscription: '${{ parameters.azureServiceConnection }}'
       scriptType: bash
       scriptLocation: inlineScript
       useGlobalConfig: false
       inlineScript: |
         az --version
         az group create --name $(resourceGroupName) --___location $(___location)
         az deployment group create `
           --resource-group $(resourceGroupName) `
           --parameters $(bicepParamFile) `
           --name DeployPipelineTemplate
   

   Per le descrizioni degli input dell'attività, vedere Attività Azure CLI v2. Quando si usa l'attività nel cloud isolato, è necessario impostare la proprietà useGlobalConfig dell'attività su true. Il valore predefinito è false.

2. Aggiornare i valori di azureServiceConnection e ___location.

3. Verificare di avere un file valido main.bicepparam nel repository che contiene un'istruzione using .

4. Seleziona Salva. La pipeline di compilazione viene eseguita automaticamente. Torna al riepilogo della pipeline di compilazione e monitora lo stato.

Pulire le risorse

Quando le risorse di Azure non sono più necessarie, usare l'interfaccia della riga di comando di Azure o Azure PowerShell per eliminare il gruppo di risorse di avvio rapido.

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Passaggi successivi