Hibakódok keresése

Ha egy Azure-erőforrás üzembe helyezése meghiúsul az Azure Resource Manager-sablonokkal (ARM-sablonokkal) vagy Bicep-fájlokkal, egy hibakód jelenik meg. Ez a cikk azt ismerteti, hogyan kereshet hibakódokat a probléma elhárításához. A hibakódokkal kapcsolatos további információkért tekintse meg a gyakori üzembehelyezési hibákat.

Hibatípusok

Az üzembe helyezéssel háromféle hiba függ össze:

• Az érvényesítési hibák az üzembe helyezés megkezdése előtt fordulnak elő, és a fájl szintaxishibái okozzák. A Visual Studio Code-hoz hasonló kódszerkesztő képes azonosítani ezeket a hibákat.
• Az előzetes ellenőrzési hibák akkor fordulnak elő, ha egy üzembe helyezési parancs fut, de az erőforrások nincsenek üzembe helyezve. Ezek a hibák az üzembe helyezés elindítása nélkül is felderíthetők. Ha például egy paraméter értéke helytelen, ez a hiba az előzetes ellenőrzés során megtalálható.
• Az üzembe helyezési hibák az üzembe helyezési folyamat során fordulnak elő, és csak az üzembe helyezés előrehaladásának az Azure-környezetben történő felmérésével találhatók.

Mindhárom típusú hiba az üzembe helyezés hibaelhárításához használható hibakódot ad vissza. Az érvényesítési és elővizsgálati hibák a tevékenységnaplóban megjelennek, de az üzembe helyezési előzményekben nem. Egy szintaktikai hibákat tartalmazó Bicep-fájl nem lesz JSON-re fordítva, és nem jelenik meg a tevékenységnaplóban.

A szintaxishibák azonosításához használhatja a Visual Studio Code-ot a legújabb Bicep-bővítménnyel vagy az Azure Resource Manager Tools bővítményével.

Ellenőrzési hibák

A sablonok érvényesítése az üzembe helyezési folyamat során történik, és hibakódok jelennek meg. Az üzembe helyezés futtatása előtt ellenőrzési és elővizsgálati hibákat azonosíthat az Azure PowerShell vagy az Azure CLI használatával végzett érvényesítési tesztek futtatásával.

portál

Egy ARM-sablon üzembe helyezhető a portálon. Ha a sablon szintaxishibákkal rendelkezik, az üzembe helyezés futtatásakor érvényesítési hiba jelenik meg. A portál üzembe helyezésével kapcsolatos további információkért tekintse meg az erőforrások egyéni sablonból való üzembe helyezését ismertető témakört.

Az alábbi példa egy tárfiók üzembe helyezését kísérli meg, és érvényesítési hiba történik.

További információért válassza ki az üzenetet. A sablonban szintaxishiba van, hibakód: InvalidTemplate. Az Összegzés azt mutatja, hogy egy kifejezésből hiányzik egy záró zárójel.

PowerShell

ARM-sablon ellenőrzése a Test-AzResourceGroupDeployment futtatása előtt.

Test-AzResourceGroupDeployment `
  -ResourceGroupName examplegroup `
  -TemplateFile azuredeploy.json

A kimenet olyan hibakódokat jelenít meg, mint InvalidTemplateDeployment vagy AccountNameInvalid, amelyeket a sablon hibaelhárítására és javítására használhat.

Bicep-fájl esetén a szintaxisérvényesítési probléma esetén megjelenő kimenet paraméterhibát mutat.

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.

További hibaelhárítási információkért használja a Bicep build parancsát. A kimenet zárójelben jeleníti meg az egyes hibák sorát és oszlopszámát, valamint a hibaüzenetet.

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.

Egyéb hatókörök

Azure PowerShell-parancsmagokkal ellenőrizheti az előfizetés, a felügyeleti csoport és a bérlő hatókörének üzembehelyezési sablonjait.

Hatókör	Cmdletek
Előfizetés	Test-AzDeployment
Felügyeleti csoport	Test-AzManagementGroupDeployment
Bérlő	Test-AzTenantDeployment

Azure CLI

Arm-sablon üzembe helyezés előtti érvényesítéséhez futtassa az az deployment group validate parancsot.

az deployment group validate \
  --resource-group examplegroup \
  --template-file azuredeploy.json

A kimenet olyan hibakódokat jelenít meg, mint InvalidTemplateDeployment vagy AccountNameInvalid, amelyeket a sablon hibaelhárítására és javítására használhat.

Bicep-fájl esetén a kimenet zárójelben jeleníti meg az egyes hibák sor- és oszlopszámát, valamint a hibaüzenetet.

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.

Egyéb hatókörök

Vannak Azure CLI-parancsok az előfizetés, a felügyeleti csoport és a bérlő hatókörének üzembehelyezési sablonjainak ellenőrzéséhez.

Hatókör	Parancsok
Előfizetés	az deployment sub validate
Felügyeleti csoport	az deployment mg validate
Bérlő	az deployment tenant validate

Telepítési hibák

A rendszer számos műveletet dolgoz fel egy Azure-erőforrás üzembe helyezéséhez. Üzembe helyezési hibák akkor fordulnak elő, ha egy művelet megfelel az ellenőrzésnek, de az üzembe helyezés során meghiúsul. Megtekintheti az egyes üzembe helyezési műveletekről és az erőforráscsoportok egyes üzembe helyezéséről szóló üzeneteket.

portál

Az üzembe helyezési műveletekkel kapcsolatos üzenetek megtekintéséhez használja az erőforráscsoport tevékenységnaplóját:

1. Jelentkezzen be az Azure Portalra.

2. Lépjen az Erőforráscsoportok elemre, és válassza ki az üzembe helyezés erőforráscsoportjának nevét.

3. Válassza Tevékenységnaplólehetőséget.

4. A szűrőkkel megkereshet egy művelet hibanaplóját.

   

5. Válassza ki a hibanaplót a művelet részleteinek megtekintéséhez.

   

Az üzembe helyezés eredményének megtekintése:

1. Lépjen az erőforráscsoportra.

2. Válassza a Beállítások>telepítések lehetőséget.

3. Válassza a hiba részleteit az üzembe helyezéshez.

   

4. Megjelenik a hibaüzenet és a hibakód NoRegisteredProviderFound .

   

PowerShell

Az üzembe helyezés műveleti üzeneteit a PowerShell használatával a Get-AzResourceGroupDeploymentOperation használatával tekintheti meg.

Az üzembe helyezés összes műveletének megjelenítése:

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Adott tulajdonságtípus megadása:

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

Az üzembe helyezés eredményének lekéréséhez használja a Get-AzResourceGroupDeployment parancsot.

Get-AzResourceGroupDeployment `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Egyéb hatókörök

Az Azure PowerShell-parancsmagok az előfizetés, a felügyeleti csoport és a bérlő hatókörének üzembehelyezési adatait szeretnék lekérni.

Hatókör	Cmdletek
Előfizetés	Get-AzDeploymentOperation Get-AzDeployment
Felügyeleti csoport	Get-AzManagementGroupDeploymentOperation Get-AzManagementGroupDeployment
Bérlő	Get-AzTenantDeploymentOperation Get-AzTenantDeployment

Azure CLI

Az üzembe helyezés műveleti üzenetei az Azure CLI-vel való megtekintéséhez használja az üzembehelyezési műveleti csoportlistát.

Az üzembe helyezés összes műveletének megjelenítése:

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

Adott tulajdonságtípus megadása:

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

Az üzembe helyezés eredményének lekéréséhez használja a következő parancsot: az deployment group show.

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

Egyéb hatókörök

Az előfizetés, a felügyeleti csoport és a bérlő hatókörének üzembehelyezési információit azure CLI-parancsok segítségével szerezheti be.

Hatókör	Parancsok
Előfizetés	az üzembe helyezés művelet alfeladat lista az deployment sub show
Felügyeleti csoport	az deployment operation mg list (az telepítési művelet mg listája) az deployment mg show
Bérlő	az üzembe helyezési művelet bérlői lista az deployment tenant show

Következő lépések

• Gyakori telepítési hibák
• Hibakeresési naplózás engedélyezése
• Hibaelhárítási sablon létrehozása