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 sposób znajdowania kodów błędów w celu rozwiązania problemu. 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 wdrożenia i są spowodowane błędami składni w pliku. Edytor kodu, taki jak Visual Studio Code, może zidentyfikować 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.
Szablony są weryfikowane podczas procesu wdrażania, a kody błędów są wyświetlane. Przed uruchomieniem wdrożenia można zidentyfikować błędy weryfikacji i wstępne, uruchamiając testy weryfikacyjne przy użyciu Azure PowerShell lub interfejsu wiersza polecenia platformy Azure.
Szablon usługi ARM można wdrożyć z poziomu portalu. Jeśli szablon zawiera błędy składni, podczas próby uruchomienia wdrożenia zostanie wyświetlony błąd weryfikacji. Aby uzyskać więcej informacji na temat wdrożeń portalu, zobacz wdrażanie zasobów z szablonu niestandardowego.
Poniższy przykład próbuje wdrożyć konto magazynu i wystąpi błąd weryfikacji.
Wybierz komunikat, aby uzyskać więcej informacji. Szablon zawiera błąd składniowy z kodem InvalidTemplatebłędu . W oknie Podsumowanie widać, że w wyrażeniu brakuje nawiasu zamykającego.
W danych wyjściowych są wyświetlane 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 dotyczących rozwiązywania problemów, użyj polecenia kompilacji Bicep. Dane wyjściowe pokazują wiersz i numer 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ą Azure PowerShell poleceń cmdlet do weryfikowania szablonów wdrażania dla subskrypcji, grupy zarządzania i zakresów dzierżawy.
az deployment group validate \
--resource-group examplegroup \
--template-file azuredeploy.json
W danych wyjściowych są wyświetlane 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 zawierają wiersz i numer 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 służące do weryfikowania szablonów wdrażania dla subskrypcji, grupy zarządzania i zakresów dzierżawy.
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żesz wyświetlać komunikaty dotyczące każdej operacji wdrażania i każdego wdrożenia dla grupy zasobów.
az deployment group show \
--resource-group examplegroup \
--name exampledeployment
Inne zakresy
Istnieją polecenia interfejsu wiersza polecenia platformy Azure umożliwiające uzyskanie informacji o wdrożeniu dla subskrypcji, grupy zarządzania i zakresów dzierżawy.
