Erstellen einer Vorlage zur Problembehandlung

  • Artikel

In einigen Fällen ist die beste Möglichkeit zur Problembehandlung ihrer Vorlage das Isolieren und Testen bestimmter Teile der Vorlage. Sie können eine Vorlage zur Problembehandlung erstellen, die sich auf die Ressource konzentriert, von der Sie glauben, dass sie den Fehler verursacht.

Beispielsweise tritt ein Fehler auf, wenn Ihre Bereitstellungsvorlage auf eine vorhandene Ressource verweist. Anstatt eine gesamte Bereitstellungsvorlage zu bewerten, erstellen Sie eine Problembehandlungsvorlage, die Daten über die Ressource zurückgibt. Die Ausgaben helfen Ihnen, zu ermitteln, ob die richtigen Parameter übergeben, Vorlagenfunktionen ordnungsgemäß genutzt und die Ressourcen abgerufen werden, die Sie erwarten.

Bereitstellen einer Vorlage zur Problembehandlung

Die folgende ARM-Vorlage und Bicep-Datei erhalten Informationen von einem vorhandenen Speicherkonto. Sie führen die Bereitstellung mit Azure PowerShell New-AzResourceGroupDeployment oder Azure CLI az deployment group create aus. Geben Sie den Namen und die Ressourcengruppe des Speicherkontos an. Die Ausgabe ist ein Objekt mit den Eigenschaftennamen und -werten des Speicherkontos.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageName": {
      "type": "string"
    },
    "storageResourceGroup": {
      "type": "string"
    }
  },
  "variables": {},
  "resources": [],
  "outputs": {
    "exampleOutput": {
      "value": "[reference(resourceId(parameters('storageResourceGroup'), 'Microsoft.Storage/storageAccounts', parameters('storageName')), '2022-05-01')]",
      "type": "object"
    }
  }
}

Nutzen Sie in Bicep das Schlüsselwort existing und führen Sie die Bereitstellung aus der Ressourcengruppe aus, in der das Speicherkonto vorhanden ist. Verwenden Sie scope, um auf eine Ressource in einer anderen Ressourcengruppe zu zugreifen. Weitere Informationen finden Sie unter Bestehende Ressourcen.

param storageName string

resource stg 'Microsoft.Storage/storageAccounts@2022-05-01' existing = {
  name: storageName
}

output exampleOutput object = stg.properties

Alternative Problembehandlungsmethode

Wenn Sie der Meinung sind, dass die Bereitstellungsfehler durch falsche Abhängigkeiten verursacht werden, können Sie Tests ausführen, indem Sie die Vorlage in vereinfachte Vorlagen aufschlüsseln. Erstellen Sie zunächst eine Vorlage, mit der nur eine einzige Ressource bereitgestellt wird (z.B. eine SQL Server-Instanz). Wenn Sie sicher sind, dass die Ressourcenbereitstellung richtig ist, fügen Sie eine Ressource hinzu, die davon abhängig ist (z. B. SQL-Datenbank). Wenn diese beiden Ressourcen richtig definiert sind, fügen Sie weitere abhängige Ressourcen hinzu (z. B. Überwachungsrichtlinien). Löschen Sie zwischen den jeweiligen Testbereitstellungen die Ressourcengruppe, um sicherzustellen, dass Sie die Abhängigkeiten angemessen testen.

Nächste Schritte