Quickstart: Bicep integreren met Azure Pipelines

  • Artikel

Deze quickstart laat zien hoe u Bicep-bestanden integreert met Azure Pipelines voor continue integratie en continue implementatie (CI/CD).

Het biedt een korte inleiding tot de pijplijntaak die u nodig hebt voor het implementeren van een Bicep-bestand. Zie Azure-resources implementeren met Bicep en Azure Pipelines als u meer gedetailleerde stappen wilt uitvoeren voor het instellen van de pijplijn en het project.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

U hebt een Azure DevOps-organisatie nodig. Als u dit niet hebt, kunt u er gratis een maken. Als uw team al een Azure DevOps-organisatie heeft, moet u ervoor zorgen dat u een beheerder bent van het Azure DevOps-project dat u wilt gebruiken.

U moet een serviceverbinding met uw Azure-abonnement hebben geconfigureerd. De taken in de pijplijn worden uitgevoerd onder de identiteit van de service-principal. Zie Een DevOps-project maken voor stappen voor het maken van de verbinding.

U hebt een Bicep-bestand nodig dat de infrastructuur voor uw project definieert. Dit bestand bevindt zich in een opslagplaats.

U hebt een bicepparam-bestand nodig dat de parameters definieert die worden gebruikt door uw bicep-bestand. Dit bestand bevindt zich in een opslagplaats.

Pijplijn maken

  1. Selecteer in uw Azure DevOps-organisatie pijplijnen en pijplijn maken.

    Schermopname van het maken van een nieuwe pijplijn.

  2. Geef op waar uw code is opgeslagen. In deze quickstart wordt Gebruikgemaakt van Azure Repos Git.

    Schermopname van het selecteren van de codebron.

  3. Selecteer de opslagplaats met de code voor uw project.

    Schermopname van het selecteren van de opslagplaats.

  4. Selecteer Starter-pijplijn voor het type pijplijn dat u wilt maken.

    Schermopname van het selecteren van een pijplijn.

Bicep-bestanden implementeren

U kunt de azure-resourcegroepimplementatietaak of Azure CLI-taak gebruiken om een Bicep-bestand te implementeren.

Azure Resource Manager-sjabloonimplementatietaak gebruiken

Notitie

Vanaf versie 3.235.0 van de azure Resource Manager-sjabloonimplementatietaak wordt het gebruik van bicepparam-bestanden ondersteund.

Notitie

Voor de AzureResourceManagerTemplateDeployment@3 taak moeten zowel Bicep- als bicepparam-bestanden worden opgegeven bij het gebruik van bicepparam. Het Bicep-bestand kan verwijzen naar alle ondersteunde locaties voor moduleverwijzingen. Het bicepparam-bestand moet verwijzen naar het lokale Bicep-bestand in de using instructie.

  1. Vervang uw starterspijplijn door de volgende YAML. Er wordt een resourcegroep gemaakt en een Bicep- en bicepparam-bestand geïmplementeerd met behulp van de azure Resource Manager-sjabloonimplementatietaak.

    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. Werk de waarden van azureServiceConnection en location.

  3. Controleer of u een geldig main.bicep bestand in uw opslagplaats hebt.

  4. Controleer of u een geldig main.bicepparam bestand in uw opslagplaats hebt dat een using-instructie bevat.

  5. Selecteer Opslaan. De build-pijplijn wordt automatisch uitgevoerd. Ga terug naar de samenvatting voor uw build-pijplijn en bekijk de status.

Azure CLI-taak gebruiken

Notitie

De opdracht az deployment group create vereist alleen een bicepparam-bestand. De using instructie in het bicepparam-bestand kan zich richten op elke ondersteunde locatie om te verwijzen naar het Bicep-bestand. Een Bicep-bestand is alleen vereist in uw opslagplaats wanneer using u een lokaal schijfpad met Azure CLI gebruikt.

Notitie

Wanneer u een bicepparam-bestand gebruikt met de opdracht az deployment group create, kunt u parameters niet overschrijven.

  1. Vervang uw starterspijplijn door de volgende YAML. Er wordt een resourcegroep gemaakt en een bicepparam-bestand geïmplementeerd met behulp van een Azure CLI-taak:

    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

    Zie De Azure CLI-taak voor de beschrijvingen van de taakinvoer. Wanneer u de taak in de lucht-gapped cloud gebruikt, moet u de useGlobalConfig eigenschap van de taak instellen op true. De standaardwaarde is false.

  2. Werk de waarden van azureServiceConnection en location.

  3. Controleer of u een geldig main.bicepparam bestand in uw opslagplaats hebt dat een using-instructie bevat.

  4. Selecteer Opslaan. De build-pijplijn wordt automatisch uitgevoerd. Ga terug naar de samenvatting voor uw build-pijplijn en bekijk de status.

Resources opschonen

Wanneer de Azure-resources niet meer nodig zijn, gebruikt u de Azure CLI of Azure PowerShell om de quickstart-resourcegroep te verwijderen.

az group delete --name exampleRG

Volgende stappen

Bicep-bestanden implementeren met behulp van GitHub Actions