Hızlı Başlangıç: Bicep'i Azure Pipelines ile tümleştirme

Bu hızlı başlangıçta, sürekli tümleştirme ve sürekli dağıtım (CI/CD) için Bicep dosyalarını Azure Pipelines ile tümleştirme adımları gösterilmektedir.

Bicep dosyasını dağıtmak için ihtiyacınız olan işlem hattı görevine kısa bir giriş sağlar. İşlem hattını ve projeyi ayarlama hakkında daha ayrıntılı adımlar istiyorsanız bkz . Bicep ve Azure Pipelines kullanarak Azure kaynaklarını dağıtma.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Bir Azure DevOps kuruluşuna ihtiyacınız vardır. Yoksa ücretsiz bir tane oluşturun. Ekibinizin zaten bir Azure DevOps kuruluşu varsa, kullanmak istediğiniz Azure DevOps projesinin yöneticisi olduğunuzdan emin olun.

Azure aboneliğinizle bir hizmet bağlantısı yapılandırmış olmanız gerekir. İşlem hattındaki görevler hizmet sorumlusunun kimliği altında yürütülür. Bağlantı oluşturma adımları için bkz . DevOps projesi oluşturma.

Projenizin altyapısını tanımlayan bir Bicep dosyası gerekir. Bu dosya bir depoda.

bicep dosyanız tarafından kullanılan parametreleri tanımlayan bir bicepparam dosyası gerekir. Bu dosya bir depoda.

İşlem hattı oluşturma

1. Azure DevOps kuruluşunuzda İşlem Hatları ve İşlem hattı oluştur'u seçin.

   

2. Kodunuzun depolandığı yeri belirtin. Bu hızlı başlangıçta Azure Repos Git kullanılır.

   

3. Projenizin kodunu içeren depoyu seçin.

   

4. Oluşturulacak işlem hattı türü için Başlangıç işlem hattı'nı seçin.

   

Bicep dosyalarını dağıtma

Bicep dosyasını dağıtmak için Azure Kaynak Grubu Dağıtım görevini veya Azure CLI görevini kullanabilirsiniz.

Azure Resource Manager Şablonu Dağıtım görevini kullanma

Not

Azure Resource Manager Şablon Dağıtımı görevinin 3.235.0 sürümünden itibaren bicepparam dosyalarının kullanımı desteklenir.

Not

Görev AzureResourceManagerTemplateDeployment@3 , bicepparam kullanılırken hem Bicep hem de bicepparam dosyalarının sağlanmasını gerektirir. Bicep dosyası, modül başvuruları için desteklenen tüm konumlara başvurabilir. bicepparam dosyasının deyimindeki yerel Bicep dosyasına başvurması using gerekir.

1. Başlangıç işlem hattınızı aşağıdaki YAML ile değiştirin. Bir kaynak grubu oluşturur ve Azure Resource Manager Şablon Dağıtımı görevini kullanarak bir Bicep ve bicepparam dosyası dağıtır.

   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'
       azureSubscription: '${{ parameters.azureServiceConnection }}'
       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'
   

2. ve locationdeğerlerini azureServiceConnection güncelleştirin.

3. Deponuzda geçerli main.bicep bir dosya olduğunu doğrulayın.

4. Deponuzda using deyimi içeren geçerli main.bicepparam bir dosyanız olduğunu doğrulayın.

5. Kaydet'i seçin. Derleme işlem hattı otomatik olarak çalışır. Derleme işlem hattınızın özetine dönün ve durumunu izleyin.

Azure CLI görevini kullanma

Not

az deployment group create komutu yalnızca bicepparam dosyası gerektirir. using bicepparam dosyasındaki deyimi, Bicep dosyasına başvurmak için desteklenen herhangi bir konumu hedefleyebilir. Bicep dosyası yalnızca Azure CLI ile yerel bir disk yolundan deponuzda using gereklidir.

Not

az deployment group create komutuyla bicepparam dosyası kullandığınızda, parametreleri geçersiz kılamazsınız.

1. Başlangıç işlem hattınızı aşağıdaki YAML ile değiştirin. Bir kaynak grubu oluşturur ve Azure CLI görevi kullanarak bicepparamdosyası dağıtır:

   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
   

   Görev girişlerinin açıklamaları için bkz . Azure CLI görevi. Görevi havayla eşlenmiş bulutta kullanırken, görevin özelliğini olarak trueayarlamanız useGlobalConfig gerekir. Varsayılan değer şudur: false.

2. ve locationdeğerlerini azureServiceConnection güncelleştirin.

3. Deponuzda using deyimi içeren geçerli main.bicepparam bir dosyanız olduğunu doğrulayın.

4. Kaydet'i seçin. Derleme işlem hattı otomatik olarak çalışır. Derleme işlem hattınızın özetine dönün ve durumunu izleyin.

Kaynakları temizleme

Azure kaynaklarına artık gerek kalmadığında, hızlı başlangıç kaynak grubunu silmek için Azure CLI veya Azure PowerShell kullanın.

CLI

az group delete --name exampleRG

PowerShell

Remove-AzResourceGroup -Name exampleRG

Sonraki adımlar

GitHub Actions kullanarak Bicep dosyalarını dağıtma