Když nasazení prostředku Azure pomocí šablon Azure Resource Manager (šablon ARM) nebo souborů Bicep selže, je přijat kód chyby. Tento článek popisuje, jak najít kódy chyb, abyste mohli problém vyřešit. Další informace o kódech chyb najdete v tématu Běžné chyby nasazení.
Typy chyb
V souvislosti s nasazením existují 3 typy chyb:
K chybám ověřování dochází před zahájením nasazení a jsou způsobeny chybami syntaxe v souboru. Tyto chyby může identifikovat editor kódu, jako je Visual Studio Code.
K chybám předběžného ověřování dochází, když se spustí příkaz pro nasazení, ale prostředky se nenasadí. Tyto chyby se zjistí bez spuštění nasazení. Například v případě nesprávné hodnoty parametru se chyba zjistí při předběžném ověřování.
K chybám nasazení dochází během procesu nasazení a lze je zjistit pouze při posouzení průběhu nasazení ve vašem prostředí Azure.
Všechny typy chyb vrací kód chyby, který můžete použít při řešení potíží s nasazením. Chyby ověření a předběžného ověření se zobrazí v protokolu aktivit, ale ne v historii nasazení. Soubor Bicep s chybami syntaxe se nezkompiluje do formátu JSON a nezobrazí se v protokolu aktivit.
Šablony se ověřují během procesu nasazení a zobrazí se kódy chyb. Před spuštěním nasazení můžete identifikovat chyby ověřování a kontroly spuštěním ověřovacích testů pomocí Azure PowerShell nebo Azure CLI.
Šablonu ARM je možné nasadit z portálu. Pokud šablona obsahuje chyby syntaxe, při pokusu o spuštění nasazení se zobrazí chyba ověření. Další informace o nasazení portálu najdete v tématu Nasazení prostředků z vlastní šablony.
Následující příklad se pokusí nasadit účet úložiště a dojde k chybě ověření.
Výběrem zprávy zobrazíte další podrobnosti. Šablona obsahuje syntaktickou chybu s kódem InvalidTemplatechyby . Souhrn ukazuje, že výrazu chybí pravá závorka.
Ve výstupu se zobrazí kódy chyb, například InvalidTemplateDeployment nebo AccountNameInvalid , které můžete použít k řešení potíží a opravě šablony.
U souboru Bicep se ve výstupu problému ověření syntaxe zobrazí chyba parametru.
Test-AzResourceGroupDeployment: Cannot retrieve the dynamic parameters for the cmdlet.
Cannot find path '/tmp/11111111-1111-1111-1111-111111111111/main.json' because it does not exist.
Pokud chcete získat další informace o řešení potíží, použijte příkaz sestavení Bicep. Výstup zobrazí číslo řádku a sloupce každé chyby v závorkách a chybovou zprávu.
bicep build main.bicep
/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
unexpected new line character.
Další obory
Existuje Azure PowerShell rutin pro ověření šablon nasazení pro předplatné, skupinu pro správu a obory tenanta.
az deployment group validate \
--resource-group examplegroup \
--template-file azuredeploy.json
Ve výstupu se zobrazí kódy chyb, například InvalidTemplateDeployment nebo AccountNameInvalid , které můžete použít k řešení potíží a opravě šablony.
U souboru Bicep se ve výstupu zobrazí číslo řádku a sloupce každé chyby v závorkách a chybová zpráva.
az deployment group validate \
--resource-group examplegroup \
--template-file main.bicep
/azuredeploy.bicep(22,51) : Error BCP064: Found unexpected tokens in interpolated expression.
/azuredeploy.bicep(22,51) : Error BCP004: The string at this location is not terminated due to an
unexpected new line character.
Další obory
K ověření šablon nasazení pro předplatné, skupinu pro správu a obory tenanta existují příkazy Azure CLI.
Pro nasazení prostředku Azure se zpracuje několik operací. K chybám nasazení dochází, když operace projde ověřením, ale během nasazování selže. Můžete zobrazit zprávy o každé operaci nasazení a každém nasazení pro skupinu prostředků.
