Aracılığıyla paylaş

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 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.

Önkoşullar

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

Ayrıca bir Azure DevOps kuruluşuna da ihtiyacınız vardır. Eğer bir tane yoksa, ücretsiz olarak 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ın kullandığı parametreleri tanımlayan bir '.bicepparam' dosyası gerekir. Bu dosya bir depoda.

İşlem hattı oluştur

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

    Yeni işlem hattı oluşturma işleminin ekran görüntüsü.

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

    Kod kaynağını seçme işleminin ekran görüntüsü.

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

    Depo seçme işleminin ekran görüntüsü.

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

    İşlem hattı seçme işleminin ekran görüntüsü.

Bicep dosyalarını dağıt.

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

Azure Resource Manager şablon dağıtım görevini kullanma

Uyarı

Azure Resource Manager şablon dağıtım görevi sürüm 3.235.0 itibarıyla '.bicepparam' dosyalarının kullanımı desteklenir.

Uyarı

AzureResourceManagerTemplateDeployment@3 görevi, .bicepparam kullanılırken hem Bicep hem de .bicepparam dosyalarının sağlanmasını gerektirir. Bicep dosyası, modül referansları için desteklenen tüm konumlara referans alabilir. .bicepparam dosyası using deyimindeki yerel Bicep dosyasına başvurmalıdır.

  1. Başlangıç işlem hattınızı aşağıdaki YAML ile değiştirin. Azure Resource Manager şablonu dağıtım görevini, bir kaynak grubu oluşturmak ve bir Bicep ve .bicepparam dosyasını dağıtmak için kullanı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'
    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. azureServiceConnection ve location değerlerini güncelleyin.

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

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

  5. Kaydetseçeneğini seçin. Derleme işlem hattı otomatik olarak çalışır. Derleme işlem hattınızın özetine geri dönün ve durumu izlemeye alın.

Azure CLI görevini kullanma

Uyarı

az deployment group create Komut yalnızca bir bicepparam. dosya gerektirir. using dosyasındaki .bicepparam ifadesi, Bicep dosyasına atıfta bulunmak için desteklenen herhangi bir konumu hedefleyebilir. Bicep dosyası deponuzda yalnızca Azure CLI ile yerel bir disk yolundan geldiğinde using gereklidir.

Uyarı

.bicepparam dosyasını az deployment group create komutuyla 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 .bicepparam kullanarak bir dosya 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 v2 görevi. Görevi hava boşluklu bulutta kullanırken, görevin useGlobalConfig özelliğini true olarak ayarlamanız gerekir. Varsayılan değer şudur: false.

  2. azureServiceConnection ve location değerlerini güncelleyin.

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

  4. Kaydetseçeneğini seçin. Derleme işlem hattı otomatik olarak çalışır. Derleme işlem hattınızın özetine geri dönün ve durumu izlemeye alın.

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

Sonraki adımlar

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

  • Last updated on