Vyhledání kódů chyb

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 běžných chybách 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. Editor kódu, jako je Visual Studio Code, může tyto chyby identifikovat.
• Při spuštění příkazu nasazení dojde k chybám předběžného ověření, kvůli kterým se prostředky 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í.
• Během procesu nasazení dochází k chybám nasazení a lze je najít pouze posouzením 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.

K identifikaci chyb syntaxe můžete použít Visual Studio Code s nejnovějším rozšířením Bicep nebo rozšířením Nástrojů Azure Resource Manageru.

Chyby ověření

Šablony se ověřují během procesu nasazení a zobrazují se kódy chyb. Před spuštěním nasazení můžete identifikovat ověření a předběžné chyby spuštěním ověřovacích testů pomocí Azure PowerShellu nebo Azure CLI.

Portál

Š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ích 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 chybu syntaxe s kódem chyby InvalidTemplate. Souhrn zobrazuje, že výraz neobsahuje pravou závorku.

Prostředí PowerShell

Pokud chcete před nasazením spustit Test-AzResourceGroupDeployment, ověřte šablonu ARM.

Test-AzResourceGroupDeployment `
  -ResourceGroupName examplegroup `
  -TemplateFile 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 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 zobrazuje číslo řádku a sloupce jednotlivých chyb 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

Existují rutiny Azure PowerShellu pro ověřování šablon nasazení pro obory předplatného, skupiny pro správu a tenanta.

Rozsah	Cmdlety
Předplatné	Testování – nasazení dat
Manažerská skupina	Nasazení testovací skupiny AzManagementGroup
Nájemník	Testovací nasazení – AzTenantDeployment

Azure CLI

Pokud chcete před nasazením ověřit šablonu ARM, spusťte příkaz az deployment group validate.

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 jednotlivých chyb 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 dispozici jsou příkazy Azure CLI pro ověření šablon nasazení pro rozsahy předplatného, skupiny pro správu a tenanta.

Rozsah	Příkazy
Předplatné	az deployment sub validate
Manažerská skupina	az deployment mg validate
Nájemník	az deployment tenant validate

Chyby nasazení

K nasazení prostředku Azure se zpracuje několik operací. K chybám nasazení dochází, když operace projde ověřením, ale během nasazení selže. Můžete zobrazit zprávy o každé operaci nasazení a každém nasazení pro skupinu prostředků.

Portál

Pokud chcete zobrazit zprávy o operacích nasazení, použijte protokol aktivit skupiny prostředků:

1. Přihlaste se na portál Azure.

2. Přejděte do skupin prostředků a vyberte název skupiny prostředků nasazení.

3. Vyberte protokolu aktivit.

4. Pomocí filtrů vyhledejte protokol chyb operace.

   

5. Výběrem protokolu chyb zobrazíte podrobnosti o operaci.

   

Zobrazení výsledku nasazení:

1. Přesuňte se do skupiny prostředků.

2. Vyberte Nastavení>nasazení.

3. Vyberte Podrobnosti o chybě pro nasazení.

   

4. Zobrazí se chybová zpráva a kód NoRegisteredProviderFound chyby.

   

Prostředí PowerShell

Pokud chcete zobrazit provozní zprávy nasazení pomocí PowerShellu, použijte rutinu Get-AzResourceGroupDeploymentOperation.

Chcete-li zobrazit všechny operace u nasazení:

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Určení konkrétního typu vlastnosti:

(Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup).StatusCode

Pokud chcete získat výsledek nasazení, použijte Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Další obory

Existují rutiny Azure PowerShellu pro získání informací o nasazení pro rozsahy předplatného, skupiny pro správu a tenanta.

Rozsah	Cmdlety
Předplatné	Operace Get-AzDeploymentOperation Příkaz Get-AzDeployment
Manažerská skupina	Operace Get-AzManagementGroupDeploymentOperation Nasazení Get-AzManagementGroupDeployment
Nájemník	Operace Get-AzTenantDeploymentOperation Nasazení Get-AzTenantDeployment

Azure CLI

Pokud chcete zobrazit provozní zprávy o operacích nasazení pomocí Azure CLI, použijte az deployment operation group list.

Chcete-li zobrazit všechny operace u nasazení:

az deployment operation group list \
  --name exampledeployment \
  --resource-group examplegroup \
  --query "[*].properties"

Určení konkrétního typu vlastnosti:

az deployment operation group list \
  --name exampledeployment \
  --resource-group examplegroup \
  --query "[*].properties.statusCode"

Pokud chcete získat výsledek nasazení, použijte az deployment group show.

az deployment group show \
  --resource-group examplegroup \
  --name exampledeployment

Další obory

K dispozici jsou příkazy Azure CLI pro získání informací o nasazení pro rozsahy předplatného, skupiny pro správu a rozsahy tenantů.

Rozsah	Příkazy
Předplatné	sub list operace nasazení az az deployment sub show
Manažerská skupina	az deployment operation mg list - seznam operací nasazení az az nasazení mg show
Nájemník	az nasazení operací seznam klientů az deployment tenant show

Další kroky

• Běžné chyby nasazení
• Povolit protokolování ladění
• Vytvoření šablony pro řešení potíží