Sdílet prostřednictvím


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 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.

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

Chyby ověření

Š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í.

Snímek obrazovky s chybou ověření v Azure Portal pokusu o nasazení účtu úložiště

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.

Snímek obrazovky s chybovou zprávou ověřování v Azure Portal zobrazující syntaktickou chybu s kódem chyby InvalidTemplate

Chyby nasazení

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ů.

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

  1. Přihlaste se k portálu Azure.

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

  3. Vyberte Protokol aktivit.

  4. Pomocí filtrů vyhledejte protokol chyb operace.

    Snímek obrazovky s protokolem aktivit skupiny prostředků Azure Portal, který zdůrazňuje neúspěšné nasazení s protokolem chyb

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

    Snímek obrazovky s podrobnostmi protokolu aktivit v Azure Portal zobrazující chybovou zprávu neúspěšného nasazení a podrobnosti o operaci

Zobrazení výsledku nasazení:

  1. Přejděte do skupiny prostředků.

  2. Vyberte Nastavení>Nasazení.

  3. Vyberte Podrobnosti o chybě pro nasazení.

    Snímek obrazovky s oddílem nasazení skupiny prostředků v Azure Portal zobrazující odkaz na podrobnosti o chybách neúspěšného nasazení

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

    Snímek obrazovky se souhrnem chyb nasazení v Azure Portal zobrazující chybovou zprávu a kód chyby NoRegisteredProviderFound

Další kroky