Znajdowanie kodów błędów

Gdy wdrożenie zasobów platformy Azure kończy się niepowodzeniem przy użyciu szablonów usługi Azure Resource Manager (szablonów usługi ARM) lub plików Bicep, zostanie odebrany kod błędu. W tym artykule opisano, jak znaleźć kody błędów, aby można było rozwiązać problem. Aby uzyskać więcej informacji na temat kodów błędów, zobacz typowe błędy wdrażania.

Typy błędów

Istnieją trzy rodzaje błędów związanych z wdrażaniem:

• Błędy walidacji występują przed rozpoczęciem wdrażania i są spowodowane błędami składni w pliku. Edytor kodu, taki jak Visual Studio Code, może identyfikować te błędy.
• Błędy weryfikacji wstępnej występują, gdy polecenie wdrożenia jest uruchamiane, ale zasoby nie są wdrażane. Te błędy można znaleźć bez uruchamiania wdrożenia. Jeśli na przykład wartość parametru jest niepoprawna, zostanie znaleziony błąd podczas weryfikacji wstępnej.
• Błędy wdrażania występują podczas procesu wdrażania i można je znaleźć tylko przez ocenę postępu wdrożenia w środowisku platformy Azure.

Wszystkie rodzaje błędów zwracają kod błędu, którego należy użyć do rozwiązania problemów z wdrożeniem. Błędy weryfikacji i weryfikacji wstępnej są wyświetlane w dzienniku aktywności, ale nie pojawiają się w historii wdrażania. Plik Bicep z błędami składni nie jest kompilowany do formatu JSON i nie jest pokazywany w dzienniku aktywności.

Aby zidentyfikować błędy składniowe, możesz użyć Visual Studio Code z najnowszym rozszerzeniem Bicep lub rozszerzeniem Azure Resource Manager Tools.

Błędy walidacji

Szablony są weryfikowane podczas procesu wdrażania i wyświetlane są kody błędów. Przed uruchomieniem wdrożenia można zidentyfikować błędy walidacji i inspekcji wstępnej, uruchamiając testy weryfikacyjne za pomocą Azure PowerShell lub interfejsu wiersza polecenia platformy Azure.

Portal

Szablon usługi ARM można wdrożyć z poziomu portalu. Jeśli szablon zawiera błędy składniowe, podczas próby uruchomienia wdrożenia zostanie wyświetlony błąd sprawdzania poprawności. Aby uzyskać więcej informacji na temat wdrożeń portalu, zobacz Wdrażanie zasobów z szablonu niestandardowego.

W poniższym przykładzie podjęto próbę wdrożenia konta magazynu i wystąpił błąd walidacji.

Wybierz komunikat, aby uzyskać więcej informacji. Szablon zawiera błąd składni z kodem InvalidTemplatebłędu . Podsumowanie pokazuje, że w wyrażeniu brakuje nawiasu zamykającego.

PowerShell

Aby zweryfikować szablon usługi ARM przed wdrożeniem, uruchom polecenie Test-AzResourceGroupDeployment.

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

Dane wyjściowe wyświetlają kody błędów, takie jak InvalidTemplateDeployment lub AccountNameInvalid , których można użyć do rozwiązywania problemów i naprawiania szablonu.

W przypadku pliku Bicep dane wyjściowe problemu ze sprawdzaniem poprawności składni pokazują błąd 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.

Aby uzyskać więcej informacji na temat rozwiązywania problemów, użyj polecenia Bicep build . Dane wyjściowe zawierają numer wiersza i kolumny każdego błędu w nawiasach oraz komunikat o błędzie.

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.

Inne zakresy

Istnieją polecenia cmdlet Azure PowerShell do weryfikowania szablonów wdrażania dla zakresów subskrypcji, grupy zarządzania i dzierżawy.

Zakres	Cmdlet
Subskrypcja	Test-AzDeployment
Grupa zarządzania	Test-AzManagementGroupDeployment
Najemca	Test-AzTenantDeployment

Interfejs wiersza polecenia platformy Azure

Aby zweryfikować szablon usługi ARM przed wdrożeniem, uruchom polecenie az deployment group validate.

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

Dane wyjściowe wyświetlają kody błędów, takie jak InvalidTemplateDeployment lub AccountNameInvalid , których można użyć do rozwiązywania problemów i naprawiania szablonu.

W przypadku pliku Bicep dane wyjściowe pokazują numer wiersza i kolumny każdego błędu w nawiasach oraz komunikat o błędzie.

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.

Inne zakresy

Istnieją polecenia interfejsu wiersza polecenia platformy Azure do weryfikowania szablonów wdrażania dla zakresów subskrypcji, grupy zarządzania i dzierżawy.

Zakres	Komendy
Subskrypcja	az deployment sub validate
Grupa zarządzania	az deployment mg validate
Najemca	az deployment tenant validate

Błędy wdrażania

Kilka operacji jest przetwarzanych w celu wdrożenia zasobu platformy Azure. Błędy wdrażania występują, gdy operacja przechodzi walidację, ale kończy się niepowodzeniem podczas wdrażania. Można wyświetlać komunikaty dotyczące każdej operacji wdrożenia i każdego wdrożenia dla grupy zasobów.

Portal

Aby wyświetlić komunikaty dotyczące operacji wdrożenia, użyj dziennika aktywności grupy zasobów:

1. Zaloguj się do Portalu Azure.

2. Przejdź do pozycji Grupy zasobów i wybierz nazwę grupy zasobów wdrożenia.

3. Wybierz pozycję Dziennik aktywności.

4. Użyj filtrów, aby znaleźć dziennik błędów operacji.

   

5. Wybierz dziennik błędów, aby wyświetlić szczegóły operacji.

   

Aby wyświetlić wynik wdrożenia:

1. Przejdź do grupy zasobów.

2. Wybierz pozycję >.

3. Wybierz pozycję Szczegóły błędu dla wdrożenia.

   

4. Wyświetlany jest komunikat o błędzie i kod NoRegisteredProviderFound błędu.

   

PowerShell

Aby wyświetlić komunikaty operacji wdrożenia za pomocą programu PowerShell, użyj polecenia Get-AzResourceGroupDeploymentOperation.

Aby wyświetlić wszystkie operacje dla wdrożenia:

Get-AzResourceGroupDeploymentOperation `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Aby określić określony typ właściwości:

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

Aby uzyskać wynik wdrożenia, użyj polecenia Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment `
  -DeploymentName exampledeployment `
  -ResourceGroupName examplegroup

Inne zakresy

Istnieją polecenia cmdlet Azure PowerShell umożliwiające uzyskanie informacji o wdrożeniu dla subskrypcji, grupy zarządzania i zakresów dzierżawy.

Zakres	Cmdlet
Subskrypcja	get-AzDeploymentOperation Get-AzDeployment
Grupa zarządzania	Get-AzManagementGroupDeploymentOperation get-AzManagementGroupDeployment
Najemca	get-AzTenantDeploymentOperation Get-AzTenantDeployment

Interfejs wiersza polecenia platformy Azure

Aby wyświetlić komunikaty operacji wdrożenia za pomocą interfejsu wiersza polecenia platformy Azure, użyj polecenia az deployment operation group list.

Aby wyświetlić wszystkie operacje dla wdrożenia:

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

Aby określić określony typ właściwości:

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

Aby uzyskać wynik wdrożenia, użyj polecenia az deployment group show.

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

Inne zakresy

Istnieją polecenia interfejsu wiersza polecenia platformy Azure, aby uzyskać informacje o wdrożeniu dla subskrypcji, grupy zarządzania i zakresów dzierżawy.

Zakres	Komendy
Subskrypcja	az deployment operation sub list (lista podrzędna) az deployment sub show
Grupa zarządzania	az deployment operation mg list az deployment mg show
Najemca	az deployment operation tenant list az deployment tenant show

Dalsze kroki

• Typowe błędy wdrażania
• Włącz rejestrowanie debugowania
• Tworzenie szablonu rozwiązywania problemów