Wat is het oplossen van problemen met implementaties?

Wanneer u Azure-resources implementeert met Bicep-bestanden of Azure Resource Manager-sjablonen (ARM-sjablonen), kan er een fout optreden. Er zijn hulpprogramma's voor probleemoplossing beschikbaar waarmee u syntaxisfouten vóór de implementatie kunt oplossen. Meer informatie over foutcodes en implementatiefouten vindt u in de Azure Portal, Azure PowerShell en Azure CLI. Deze documentatie helpt u bij het vinden van oplossingen voor het oplossen van fouten.

Fouttypen

Validatiefouten treden op voordat een implementatie begint en worden veroorzaakt door een onjuiste syntaxis die kan worden geïdentificeerd door een code-editor zoals Visual Studio Code. Bijvoorbeeld een verkeerd gespelde eigenschapsnaam of een functie waarvoor een argument ontbreekt.

Preflight-validatiefouten treden op wanneer een implementatieopdracht wordt uitgevoerd, maar resources niet worden geïmplementeerd in Azure. Als er bijvoorbeeld een onjuiste parameterwaarde wordt gebruikt, retourneert de implementatieopdracht een foutbericht.

Implementatiefouten kunnen alleen worden bepaald door de implementatie uit te voeren en te communiceren met uw Azure-omgeving. Voor een virtuele machine (VM) is bijvoorbeeld een netwerkinterfacekaart (NIC) vereist. Als de NIC niet bestaat wanneer de VM wordt geïmplementeerd, krijgt u een implementatiefout.

Hulpprogramma's voor probleemoplossing

Er zijn verschillende hulpprogramma's voor probleemoplossing beschikbaar om fouten op te lossen.

Syntaxisfouten

Gebruik de nieuwste versie van Visual Studio Code om syntaxisfouten vóór een implementatie te identificeren. Installeer de nieuwste versie van de extensie voor Bicep- of ARM-sjablonen.

• Bicep
• Azure Resource Manager-hulpprogramma’s

Gebruik de volgende hulpprogramma's om de aanbevolen procedures voor het ontwikkelen van uw implementatiesjablonen te volgen:

• Bicep linter
• Test-toolkit voor ARM-sjablonen

Resourceprovider en API-versie

Als u problemen met implementaties wilt oplossen, is het handig om meer te weten te komen over de eigenschappen of API-versies van een resourceprovider. Zie Resources definiëren met Bicep- en ARM-sjablonen voor meer informatie.

Foutdetails

Wanneer u implementeert, kunt u de oorzaak van fouten vinden in de Azure Portal in het implementatie- of activiteitenlogboek van een resourcegroep. Als u Azure PowerShell gebruikt, gebruikt u opdrachten zoals Get-AzResourceGroupDeploymentOperation en Get-AzActivityLog. Gebruik voor Azure CLI opdrachten zoals az deployment operation group en az monitor activity-log list.

Volgende stappen

• Zie Foutcodes zoeken voor meer informatie over het vinden van foutcodes voor implementaties en het oplossen van implementatieproblemen.
• Zie Veelvoorkomende implementatiefouten in Azure oplossen voor oplossingen op basis van de foutcode.
• Zie Quickstart: Problemen met JSON-implementaties van ARM-sjablonen oplossen of Quickstart: Problemen met Bicep-bestandsimplementaties oplossen voor een inleiding tot het vinden van de foutcode.