Delen via

Quickstart: Bicep integreren met Azure Pipelines

Deze quickstart laat zien hoe u Bicep-bestanden integreert met Azure Pipelines voor continue integratie en continue implementatie.

Het biedt een korte inleiding tot de pijplijntaak die u nodig hebt voor het implementeren van een Bicep-bestand. Zie de Module Azure-resources implementeren met bicep en Azure Pipelines Microsoft Learn voor gedetailleerdere stappen voor het instellen van de pijplijn en het project.

Vereiste voorwaarden

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

U hebt ook 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 serviceprincipal. 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 door uw Bicep-bestand worden gebruikt. 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 worden Git repositories van Azure Repos gebruikt.

    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 een Azure Resource Group-implementatietaak of een Azure CLI-taak gebruiken om een Bicep-bestand te implementeren.

Azure Resource Manager-sjabloonimplementatietaak gebruiken

Opmerking

Vanaf de implementatietaak voor Azure Resource Manager-sjablonen versie 3.235.0 wordt het gebruik van .bicepparam-bestanden ondersteund.

Opmerking

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. Het gebruikt de taak voor sjabloonimplementatie van Azure Resource Manager om een resourcegroep te maken en een Bicep-bestand en een .bicepparam-bestand te implementeren.

    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. 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 buildpipeline wordt automatisch uitgevoerd. Ga terug naar de samenvatting voor uw build-pijplijn en monitor de status.

Azure CLI-taak gebruiken

Opmerking

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

Opmerking

Wanneer u een .bicepparam bestand met de az deployment group create opdracht gebruikt, 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 v2-taak voor de beschrijvingen van de taakinvoer. Wanneer u de taak in een air-gapped cloud gebruikt, moet u de 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.

Hulpmiddelen opruimen

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