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
Azure DevOps kuruluşunuzda İşlem Hatları ve İşlem hattı oluştur'u seçin.
Kodunuzun depolandığı yeri belirtin. Bu hızlı başlangıçta Azure Repos Git kullanılır.
Projenizin kodunu içeren depoyu seçin.
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.
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'
ve
location
değerleriniazureServiceConnection
güncelleştirin.Deponuzda geçerli
main.bicep
bir dosya olduğunu doğrulayın.Deponuzda using deyimi içeren geçerli
main.bicepparam
bir dosyanız olduğunu doğrulayın.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.
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 bicepparam dosyası 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
true
ayarlamanızuseGlobalConfig
gerekir. Varsayılan değer şudur:false
.ve
location
değerleriniazureServiceConnection
güncelleştirin.Deponuzda using deyimi içeren geçerli
main.bicepparam
bir dosyanız olduğunu doğrulayın.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.
az group delete --name exampleRG