Was ist die Problembehandlung bei der Bereitstellung?

Wenn Sie Azure-Ressourcen mit Bicep-Dateien oder Azure Resource Manager-Vorlagen (ARM-Vorlagen) bereitstellen, wird möglicherweise ein Fehler 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 erhalten Sie über das Azure-Portal, Azure PowerShell und Azure CLI. Diese Dokumentation hilft Ihnen bei der Suche nach Lösungen für die Fehlerbehandlung.

Fehlertypen

Überprüfungsfehler treten auf, bevor eine Bereitstellung beginnt und durch falsche Syntax verursacht wird, die von einem Code-Editor wie Visual Studio Code identifiziert werden kann. Beispielsweise ein falsch geschriebener Eigenschaftenname oder eine Funktion, die ein Argument fehlt.

Preflight-Überprüfungsfehler treten auf, wenn ein Bereitstellungsbefehl ausgeführt wird, ressourcen jedoch nicht in Azure bereitgestellt werden. Wenn beispielsweise ein falscher Parameterwert verwendet wird, gibt der Bereitstellungsbefehl eine Fehlermeldung zurück.

Bereitstellungsfehler können nur durch den Versuch der Bereitstellung und Interaktion mit Ihrer Azure-Umgebung bestimmt werden. Beispielsweise erfordert ein virtueller Computer (VM) eine Netzwerkschnittstellenkarte (Network Interface Card, NIC). Wenn die NIC nicht vorhanden ist, wenn der virtuelle Computer bereitgestellt wird, erhalten Sie einen Bereitstellungsfehler.

Problembehandlungstools

Es stehen mehrere Tools zur Problembehandlung zur Verfügung, um Fehler zu beheben.

Syntaxfehler

Verwenden Sie die neueste Version von Visual Studio Code, um Syntaxfehler vor einer Bereitstellung zu identifizieren. Installieren Sie die aktuelle Version der Erweiterung für Bicep- oder ARM-Vorlagen.

• Bizeps
• Azure Resource Manager-Tools

Um bewährte Methoden für die Entwicklung Ihrer Bereitstellungsvorlagen zu befolgen, verwenden Sie die folgenden Tools:

• Bicep-Linter
• ARM-Vorlagentest-Toolkit

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 können Sie die Ursache von Fehlern im Azure-Portal im Bereitstellungen oder im Aktivitätsprotokoll einer Ressourcengruppe finden. Wenn Sie Azure PowerShell verwenden, verwenden Sie Befehle wie "Get-AzResourceGroupDeploymentOperation " und "Get-AzActivityLog". Verwenden Sie für Azure CLI Befehle wie az deployment operation group und az monitor activity-log list.

Nächste Schritte

• Weitere Informationen zum Auffinden von Bereitstellungsfehlercodes und zur Problembehandlung von Bereitstellungsproblemen finden Sie unter Finden von Fehlercodes.
• Lösungen, die auf dem Fehlercode basieren, finden Sie unter Problembehandlung allgemeiner Azure-Bereitstellungsfehler.
• Eine Einführung in die Suche nach dem Fehlercode finden Sie in der Schnellstartanleitung: Problembehandlung bei JSON-Bereitstellungen von ARM-Vorlagen oder Schnellstart: Problembehandlung bei Bicep-Dateibereitstellungen.