Vad är distributionsfelsökning?

När du distribuerar Azure-resurser med Bicep-filer eller Azure Resource Manager-mallar (ARM-mallar) kan det uppstå ett fel. Det finns felsökningsverktyg som hjälper dig att lösa syntaxfel före distributionen. Du kan få mer information om felkoder och distributionsfel från Azure Portal, Azure PowerShell och Azure CLI. Den här dokumentationen hjälper dig att hitta lösningar för att felsöka fel.

Feltyper

Valideringsfel inträffar innan en distribution påbörjas och orsakas av felaktig syntax som kan identifieras av en kodredigerare som Visual Studio Code. Till exempel ett felstavat egenskapsnamn eller en funktion som saknar ett argument.

Valideringsfel före start inträffar när ett distributionskommando körs men resurser inte distribueras i Azure. Om till exempel ett felaktigt parametervärde används returnerar distributionskommandot ett felmeddelande.

Distributionsfel kan bara fastställas genom att försöka distribuera och interagera med din Azure-miljö. En virtuell dator (VM) kräver till exempel ett nätverkskort (NIC). Om nätverkskortet inte finns när den virtuella datorn distribueras får du ett distributionsfel.

Verktyg för felsökning

Det finns flera tillgängliga felsökningsverktyg för att lösa fel.

Syntaxfel

Använd den senaste versionen av Visual Studio Code för att identifiera syntaxfel före en distribution. Installera den senaste versionen av tillägget för Bicep- eller ARM-mallar.

• Bicep
• Azure Resource Manager-verktyg

Om du vill följa metodtipsen för att utveckla dina distributionsmallar använder du följande verktyg:

• Bicep-linter
• Testverktyg för ARM-mallar

Resursprovider och API-version

Om du vill felsöka distributioner är det bra att lära dig mer om en resursproviders egenskaper eller API-versioner. Mer information finns i Definiera resurser med Bicep- och ARM-mallar.

Felinformation

När du distribuerar kan du hitta orsaken till fel från Azure Portal i resursgruppens distributions- eller aktivitetslogg. Om du använder Azure PowerShell använder du kommandon som Get-AzResourceGroupDeploymentOperation och Get-AzActivityLog. För Azure CLI använder du kommandon som az deployment operation group och az monitor activity-log list.

Nästa steg

• Mer information om hur du hittar felkoder för distribution och felsöker distributionsproblem finns i Hitta felkoder.
• Lösningar baserade på felkoden finns i Felsöka vanliga Azure-distributionsfel.
• En introduktion till att hitta felkoden finns i Snabbstart: Felsöka JSON-distributioner för ARM-mallar eller Snabbstart: Felsöka Bicep-fildistributioner.