Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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
Selecteer in uw Azure DevOps-organisatie pijplijnen en pijplijn maken.
Geef op waar uw code is opgeslagen. In deze quickstart worden Git repositories van Azure Repos gebruikt.
Selecteer de opslagplaats met de code voor uw project.
Selecteer Starter-pijplijn voor het type pijplijn dat u wilt maken.
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.
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 }}'
Werk de waarden van
azureServiceConnection
enlocation
.Controleer of u een geldig
main.bicep
bestand in uw opslagplaats hebt.Controleer of u een geldig
main.bicepparam
bestand in uw opslagplaats hebt dat eenusing
instructie bevat.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.
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 isfalse
.Werk de waarden van
azureServiceConnection
enlocation
.Controleer of u een geldig
main.bicepparam
bestand in uw opslagplaats hebt dat eenusing
instructie bevat.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