Was ist die Problembehandlung für Bereitstellungen?
Wenn Sie Azure-Ressourcen mit Bicep-Dateien oder Azure Resource Manager-Vorlagen (ARM-Vorlagen) bereitstellen, wird möglicherweise eine Fehlermeldung angezeigt. Es stehen Tools zur Problembehandlung zur Verfügung, mit denen Sie Syntaxfehler vor der Bereitstellung beheben können. Weitere Informationen zu Fehlercodes und Bereitstellungsfehlern halten das Azure-Portal, Azure PowerShell und die Azure CLI bereit. Diese Dokumentation hilft Ihnen bei der Suche nach Lösungen bei der Problembehandlung.
Fehlertypen
Überprüfungsfehler treten auf, bevor eine Bereitstellung beginnt. Sie werden durch eine falsche Syntax verursacht, die von einem Code-Editor wie Visual Studio Code identifiziert werden kann. Dies kann beispielsweise ein falsch geschriebener Eigenschaftsname oder eine Funktion sein, der ein Argument fehlt.
Preflight-Validierungsfehler treten auf, wenn ein Bereitstellungsbefehl zwar ausgeführt wird, Ressourcen aber nicht in Azure bereitgestellt werden. Wenn beispielsweise ein falscher Parameterwert verwendet wird, gibt der Bereitstellungsbefehl eine Fehlermeldung zurück.
Bereitstellungsfehler können nur ermittelt werden, indem Sie versuchen, die Bereitstellung zu starten und mit Ihrer Azure-Umgebung zu interagieren. Für eine VM (virtueller Computer) ist beispielsweise ein Netzwerkadapter erforderlich. Wenn der Netzwerkadapter bei der Bereitstellung der VM nicht vorhanden ist, wird ein Bereitstellungsfehler ausgelöst.
Problembehandlungstools
Es stehen mehrere Tools zur Problembehandlung zur Verfügung, mit denen Fehler behoben werden können.
Syntaxfehler
Verwenden Sie die neueste Version von Visual Studio Code, um Syntaxfehler vor einer Bereitstellung zu ermitteln. Installieren Sie die neueste Version der Erweiterung für Bicep- oder ARM-Vorlagen.
Verwenden Sie die folgenden Tools, um den bewährten Methoden für die Entwicklung Ihrer Bereitstellungsvorlagen zu folgen:
Ressourcenanbieter und API-Version
Zur Problembehandlung bei Bereitstellungen ist es hilfreich, sich über die Eigenschaften oder API-Versionen eines Ressourcenanbieters zu informieren. Weitere Informationen finden Sie unter Definieren von Ressourcen mit Bicep- und ARM-Vorlagen.
Fehlerdetails
Bei der Bereitstellung mit Azure finden Sie die Fehlerursache im Azure-Portal im Abschnitt Bereitstellungen oder Aktivitätsprotokoll einer Ressourcengruppe. Wenn Sie Azure PowerShell verwenden, können Sie Befehle wie Get-AzResourceGroupDeploymentOperation oder Get-AzActivityLog ausführen. In der Azure CLI können Sie Befehle wie az deployment operation group oder az monitor activity-log list ausführen.
Nächste Schritte
- Weitere Informationen zur Suche nach Bereitstellungsfehlercodes und zur Behandlung von Bereitstellungsproblemen finden Sie unter Suchen von Fehlercodes.
- Unter Problembehandlung für häufige Azure-Bereitstellungsfehler werden Lösungen für verschiedene Fehlercodes aufgeführt.
- Eine Einführung in das Suchen des Fehlercodes erhalten Sie unter Schnellstart: Fehlerbehebung bei der Bereitstellung von JSON-ARM-Vorlagen oder Schnellstart: Fehlerbehebung bei der Bereitstellung von Bicep-Dateien.